文档首页 > > 快速入门> 安装并配置ICAgent(Linux环境)

安装并配置ICAgent(Linux环境)

分享
更新时间: 2019/10/21 GMT+08:00

ICAgent是云日志服务进行日志采集的工具,运行在需要采集日志的服务器中。首次使用云日志服务在Linux环境采集日志时,需要安装ICAgent。

前提条件

  • 在进行ICAgent安装前,需要先确保本地浏览器时间与服务器时区、时间都一致。若有多个服务器,则要保证本地浏览器、多个服务器的时区、时间都一致。否则,可能会导致安装后不能在界面上准确查看日志信息。
  • 如果您使用华为云账号创建的IAM用户进行操作,IAM用户需要具备足够的权限才能进行操作:LTS Administrator。

安装ICAgent

  1. 选择“管理与部署 > 云日志服务”,进入云日志服务界面。
  2. 在左侧导航栏,单击“Agent管理”,进入“Agent管理”页面。
  3. 单击“安装ICAgent”。
  4. “安装系统”选择“Linux”。
  5. 选择“安装方式”,生成ICAgent安装命令。
    • “安装方式”选择为“获取AK/SK凭证”,请参考如何获取AK/SK?章节获取AK/SK,并在文本框中输入已获取的AK/SK,生成ICAgent安装命令。单击“复制命令”,复制ICAgent安装命令。
    • “安装方式”选择为“创建IAM委托”,请参考如何通过创建委托获取AK/SK?章节获取AK/SK。单击“复制命令”,复制ICAgent安装命令。

      请确保输入正确的AK/SK,否则将无法安装ICAgent。

  6. 使用PuTTY等远程登录工具,以root用户登录待安装ICAgent的服务器,执行ICAgent安装命令进行安装。
    • 当显示“ICAgent install success”时,表示安装成功,ICAgent已安装在了/opt/oss/servicemgr/目录。安装成功后,在云日志服务左侧导航栏中选择“Agent管理”,查看该服务器ICAgent的状态。
    • 如果安装失败,请卸载ICAgent后重新安装,如果还未安装成功,请联系技术支持。

配置日志采集规则

ICAgent安装完成后,需要配置日志采集规则,否则会导致日志数据无法进行上传。您可以通过本章节完成对日志采集信息的配置。

前提条件

  • 已创建日志组和日志流。
  • 已完成ICAgent安装。

操作步骤

  1. 进入控制台首页,在左上角单击,选择区域和项目。
  2. 选择“服务列表 > 管理与部署 > 云日志服务”,进入“日志管理”页面。
  3. 在日志组列表中,选择已创建的日志组,日志将被采集至该日志组。进入该日志组下的日志流列表页面。
  4. 在日志流列表中,选择已创建的日志流,日志将被采集至该日志流。进入日志流详情页面。
  5. 单击左侧导航栏“采集配置”,进入采集配置详情页面。
    图1 采集配置
  6. 单击“新增路径”,进入“新增采集配置”页面。
  7. 添加您需要收集日志的主机,单击页面下方的“下一步”,进入“配置采集路径”步骤。
  8. 在“配置采集路径”步骤,添加您需要收集日志的主机的路径。
    采集路径只支持最后一级包含通配符*,且只支持以“.log”、“.trace”和“.out”结尾的文件,填写示例:
    /var/log/*.log
    /var/log/a*.log
    /var/log/*a.log
    /var/log/a*b.log
    /var/log/*.trace
    /var/log/*.out
    • 请注意您的敏感信息是否在收集范围内。
    • 日志采集路径不能重复配置,即相同主机的同一个日志采集路径不能在不同的日志流重复配置,否则可能会导致日志采集异常。
    • 相同主机的同一个日志采集路径,如果在AOM进行了配置,则不能在LTS重复配置。
    • LTS暂不支持采集PostgreSQL(数据库)实例的日志,目前只支持采集安装在ECS(主机)实例的日志。
    • Windows环境暂不支持配置通配符*。
    • Linux环境默认采集系统日志,Windiws环境不支持采集系统日志。
  9. 单击页面下方的“下一步”,进入“配置采集信息”步骤。
    表1 日志采集信息

    名称

    说明

    日志格式

    • 单行日志:采集的日志文件中,如果您希望每一行日志在LTS界面中都显示为一条单独的日志数据,则选择单行日志。
    • 多行日志:采集的日志中包含像java异常的日志,如果您希望多行异常的日志显示为一条日志,正常的日志则每一行都显示为一条单独的日志数据,则选择多行日志,方便您查看日志并且定位问题。

    日志时间

    系统时间:表示系统当前时间,默认为日志采集时间,每条日志的行首显示日志的采集时间。

    说明:

    日志打印时间:系统产生并打印日志的时间;日志采集时间:Agent采集日志,并且发送到云日志服务的时间。

    Agent采集日志并发送日志到云日志平台的频率为1秒钟。

    时间通配符:用日志打印时间来标识一条日志数据,通过时间通配符来匹配日志,每条日志的行首显示日志的打印时间。

    • 如果日志中的时间格式为:2019-01-01 23:59:59,时间通配符应该填写为:YYYY-MM-DD hh:mm:ss。
    • 如果日志中的时间格式为:19-1-1 23:59:59,时间通配符应该填写为:YY-M-D hh:mm:ss。
    说明:

    如果日志中不存在年份信息,则云日志会自动补齐年份数据为当前年份数据。

    填写示例:

    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)   
    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. 单击“测试”,可在“测试结果”下方查看测试结果。
  10. 采集信息配置完成后,单击“确认”,完成日志采集Agent的配置。此时,云日志服务按照设定的采集规则进行日志采集。
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区