当您选择了云主机接入方式时,云日志服务可以将主机待采集日志的路径配置到日志流中,ICAgent将按照日志采集规则采集日志,并将多条日志进行打包,以日志流为单位发往云日志服务,您可以在云日志服务控制台实时查看日志。
前提条件
已安装ICAgent并添加至主机组。
操作步骤
云日志服务接入方式选择云主机 ECS-文本日志时,按照如下操作完成接入配置。
步骤 1 登录云日志服务控制台。
步骤 2 在左侧导航栏中,选择“日志接入”,单击“云主机 ECS-文本日志”进行主机接入配置。
步骤 3 选择日志流。
- 单击“所属日志组”后的目标框,在下拉列表中选择具体的日志组,若没有所需的日志组,单击“所属日志组”目标框后的“新建”,在弹出的创建日志组页面创建新的日志组。
- 单击“所属日志流”后的目标框,在下拉列表中选择具体的日志流,若没有所需的日志流,单击“所属日志流”目标框后的“新建”,在弹出的创建日志流页面创建新的日志流。
- 单击“下一步:选择主机组”。
步骤 4 选择主机组。
-
在主机组列表中选择一个或多个需要采集日志的主机组,若没有所需的主机组,单击列表左上方“新建”,在弹出的新建主机组页面创建新的主机组,具体可参考创建主机组。
主机组可以为空,可以在接入配置设置完成后对主机组进行设置。- 在“主机管理 > 主机组”页面对主机组和接入配置进行关联。
- 在接入配置详情中对主机组和接入配置进行关联。
-
单击“下一步:采集配置”。
步骤 5 采集配置。
对主机日志采集设置具体的采集规则,具体请参考采集配置。
步骤 6 完成。
接入成功,可以单击“返回接入配置列表”查看日志接入,也可单击“查看日志流”查看该日志流下的采集日志。
采集配置
在使用主机接入完成日志接入时,采集配置的具体配置如下:
- 采集配置名称:自定义采集配置名称,长度范围为1到64个字符,只支持输入英文、数字、中文、中划线、下划线以及小数点,且不能以小数点、下划线开头或以小数点结尾。
说明导入旧版配置:将旧版主机接入配置导入到新版日志接入中。
若是新安装云日志服务的场景,页面没有显示“导入旧版配置”,则表示不需要导入旧版配置,直接新建配置即可。
若是升级云日志服务的场景,页面显示“导入旧版配置”,若需要旧版配置里的主机日志路径,可以选择导入旧版配置,或者直接新建配置。
- 路径配置:添加您需要收集的日志路径,LTS将按照配置的路径进行日志采集。
- 采集路径支持递归路径,*表示递归5层目录。
示例:采集路径配置为 /var/logs/* /a.log,日志匹配如下:/var/logs/1/a.log /var/logs/1/2/a.log /var/logs/1/2/3/a.log /var/logs/1/2/3/4/a.log /var/logs/1/2/3/4/5/a.log
说明
以上示例中的/1/2/3/4/5/,表示/var/logs目录中,往里递归的5个目录层级,在这5个目录层级中只要存在a.log,都能进行日志匹配。
采集路径中只能出现一次**,不能出现两个及以上。正确示例:/var/logs/**/a.log;错误示例:/opt/test/**/log/**。
采集路径中第一个层级不允许为**(避免误采集系统文件),错误示例:/**/test。
− 采集路径支持模糊匹配,匹配目录或文件名中的任何字符。
说明如果配置了C:\windows\system32类似的日志采集路径,但无法采集日志,请尝试打开WAF物理防火墙后重新配置。
示例1:采集路径配置为 /var/logs/*/a.log,表示/var/logs/目录下,任何一个目录中存在a.log,都能进行日志匹配,例如:
/var/logs/1/a.log
/var/logs/2/a.log
示例2:采集路径配置为 /var/logs/service-*/a.log,日志匹配示例:
/var/logs/service-1/a.log
/var/logs/service-2/a.log
示例3:采集路径配置为 /var/logs/service/a*.log,日志匹配示例:
/var/logs/service/a1.log
/var/logs/service/a2.log
− 采集路径如果配置的是目录,示例:/var/logs/,则只采集目录下后缀为“.log”、“.trace”和“.out”的文件。
如果配置的是文件名,则直接采集对应文件,只支持内容是文本格式的文件。可以通过file -i 文件名命令,查询文件格式。
说明
请注意您的敏感信息是否在收集范围内。
目前只支持采集安装在ECS(主机)实例的日志。
日志采集路径不能重复配置,即相同主机的同一个日志采集路径不能重复配置,否则可能会导致日志采集异常。
相同主机的同一个日志采集路径,如果在AOM进行了配置,则不能在LTS重复配置。
配置采集的文件最后修改时间和当前时间差如果已超过12小时,则不会采集。
- 设置采集黑名单:LTS支持对日志进行过滤采集,即通过设置黑名单,在采集时过滤指定的目录或文件。指定按目录过滤,可过滤掉该目录下的所有文件。
目录和文件名支持完全匹配,也支持模糊匹配,具体可参考路径配置内容进行设置。
说明当设置的黑名单与配置的采集路径重复或者有重合时,优先过滤掉黑名单设置的文件。
- 采集Windows事件日志:当选择Windows主机采集日志时,需要开启“采集Windows事件日志”,并且可以设置“日志类型”、“首次采集时间偏移量”、“事件等级”来过滤采集您所需要的日志内容。
- 日志格式、日志时间具体说明如下:
日志采集信息
名称 说明 日志格式 单行日志:采集的日志文件中,如果您希望每一行日志在LTS界面中都显示为一条单独的日志数据,则选择单行日志。
多行日志:采集的日志中包含像java异常的日志,如果您希望多行异常的日志显示为一条日志,正常的日志则每一行都显示为一条单独的日志数据,则选择多行日志,方便您查看日志并且定位问题。日志时间 系统时间:表示系统当前时间,默认为日志采集时间,每条日志的行首显示日志的采集时间。
说明
日志采集时间:ICAgent采集日志,并且发送到云日志服务的时间。
日志打印时间:系统产生并打印日志的时间。ICAgent采集日志并发送日志到云日志平台的频率为1秒钟。
采集日志时间限制:系统时间的前后24小时内。
时间通配符:用日志打印时间来标识一条日志数据,通过时间通配符来匹配日志,每条日志的行首显示日志的打印时间。
如果日志中的时间格式为:2019-01-01 23:59:59.011,时间通配符应该填写为:YYYY-MM-DD hh:mm:ss.SSS。
如果日志中的时间格式为:19-1-1 23:59:59.011,时间通配符应该填写为:YY-M-D hh:mm:ss.SSS。
说明如果日志中不存在年份信息,则云日志会自动补齐年份数据为当前年份数据。
填写实例YY - year (19)
YYYY - year (2019)
M - month (1)
MM - month (01)
D - day (1)
DD - day (01)
hh - hours (23)
mm - minutes (59)
ss - seconds (59)
SSS - millisecond(999)
hpm - hours (03PM)
h:mmpm - hours:minutes (03:04PM)
h:mm:sspm - hours:minutes:seconds (03:04:05PM)
hh:mm:ss ZZZZ (16:05:06 +0100)
hh:mm:ss ZZZ (16:05:06 CET)
hh:mm:ss ZZ (16:05:06 +01:00)分行模式 日志格式选择多行日志时,需要选择分行模式,分行模式选择“日志时间”时,是以时间通配符来划分多行日志;当选择“正则模式”时,则以正则表达式划分多行日志。 正则表达式 此配置是用来标识一条日志数据的正则表达式。日志格式选择“多行日志”格式后且“分行模式”已选择“正则模式”后需要设置。
说明时间通配和正则表达式均是从每行日志的开头进行严格匹配,如果匹配不上,则会默认使用系统时间上报,这样可能会和文件内容中的时间不一致。如果没有特殊需求,建议使用单行日志-系统时间模式即可。
查看日志接入
在云日志服务管理控制台,单击“日志接入”,或在完成主机接入成功后单击“返回接入配置列表”,进入日志接入页面。
- 在接入配置列表中显示已配置完成的接入配置,单击接入配置名称可进入详情页面,查看该接入配置详细信息。
- 单击所属日志组或所属日志流,可以进入对应日志组列表或日志流页面查看详细信息。
- 修改日志接入:单击需修改接入配置所在行操作列的 ,参考日志接入的操作步骤进行修改。
- 删除日志接入:单击需删除接入配置所在行操作列的 ,或者勾选需删除的接入配置,单击页面左上方“批量删除”,可以对多个配置进行批量删除。
查看旧版主机接入
当您已使用旧版主机接入方式接入主机,按照如下步骤可查看主机接入列表:
步骤 1 在云日志服务管理控制台,选择“日志管理”。
步骤 2 在日志组列表中,选择日志组/日志流,进入日志流详情页面。
步骤 3 单击“查看旧版主机接入”,可查看当前日志流接入的主机列表。
说明旧版主机接入不支持新增和编辑功能,请使用新版主机接入。