应用运维管理 AOM-配置容器服务日志采集路径:配置步骤

时间:2023-11-21 17:05:07

配置步骤

在CCE中添加日志策略

  1. 在CCE中创建工作负载时,添加容器后,展开“容器日志”页签。
  2. 单击“添加日志策略”,设置自定义日志参数,配置日志策略,以nginx为例,不同工作负载根据实际情况配置。

    图1 添加日志策略

  3. 存储类型有“主机路径”“容器路径”两种类型可供选择:

    • 主机路径:可将主机上的路径挂载到指定的容器路径。日志策略配置参数如下:
      表1 添加日志策略-主机路径

      参数

      参数说明

      存储类型

      设置为“主机路径”。将主机上的路径挂载到指定的容器路径。

      添加容器挂载

      *主机路径

      容器内日志文件所在路径挂载到主机上的位置,如:/var/paas/sys/log/nginx

      挂载路径

      输入数据逻辑卷挂载到容器上的路径,如:/tmp
      须知:
      • 请不要挂载在系统目录下,如“/”、“/var/run”等,会导致容器异常。建议挂载在空目录下,若目录不为空,请确保目录下无影响容器启动的文件,否则文件会被替换,导致容器启动异常,工作负载创建失败。
      • 挂载高危目录的情况下 ,建议使用低权限账号启动,否则可能会造成宿主机高危文件被破坏。
      • AOM只采集最近修改过的前20个日志文件,且默认采集两级子目录。
      • AOM只采集挂载路径下的“.log”、“.trace”、“.out”文本日志文件。

      主机扩展路径

      会在原先的“卷目录/子目录”中增加一个三级目录。使用户更方便获取单个Pod输出的文件。

      • None:不配置拓展路径。
      • PodUID:Pod的ID。
      • PodName:Pod的名称。
      • PodUID/ContainerName:Pod的ID/容器名称。
      • PodName/ContainerName:Pod名称/容器名称。

      采集路径

      设置采集路径可以更精确的指定采集内容,当前支持以下设置方式:

      • 不设置则默认采集当前路径下.log .trace .out文件。
      • 设置**表示递归采集5层目录下的.log .trace .out文件。
      • 设置*表示模糊匹配。

      例子: 采集路径为/tmp/**/test*.log 表示采集/tmp目录及其1-5层子目录下的全部以test开头的.log文件。

      注意:

      使用采集路径功能请确认您的采集器ICAgent版本为5.12.22或以上版本。

      日志转储

      此处日志转储是指日志的本地绕接。

      • 设置:AOM每分钟扫描一次日志文件,当某个日志文件超过50MB时,会立即对其转储(转储时会在该日志文件所在的目录下生成一个新的zip文件。对于一个日志文件,AOM只保留最近生成的20个zip文件,当zip文件超过20个时,时间较早的zip文件会被删除),转储完成后AOM会将该日志文件清空。
      • 不设置:若您在下拉列表框中选择“不设置”,则AOM不会对日志文件进行转储。
      说明:
      • AOM的日志绕接能力是使用copytruncate方式实现的,如果选择了设置,请务必保证您写日志文件的方式是append(追加模式),否则可能出现文件空洞问题。
      • 当前主流的日志组件例如Log4j、Logback等均已经具备日志文件的绕接能力,如果您的日志文件已经实现了绕接能力,则无需设置。否则可能出现冲突。
      • 建议您的业务自己实现绕接,可以更灵活的控制绕接文件的大小和个数。
    • 容器路径:日志仅输出到容器路径,无需挂载主机路径。日志策略配置参数如下:

      此功能需要采集器ICAgent版本升级到5.10.79或以上版本。

      表2 添加日志策略-容器路径

      参数

      参数说明

      存储类型

      设置为“容器路径”。

      日志仅输出到容器路径,无需挂载主机路径。此功能需要采集器ICAgent版本升级到5.10.79或以上版本。

      添加容器挂载

      挂载路径

      输入数据逻辑卷挂载到容器上的路径,如:/tmp
      须知:
      • 请不要挂载在系统目录下,如“/”、“/var/run”等,会导致容器异常。建议挂载在空目录下,若目录不为空,请确保目录下无影响容器启动的文件,否则文件会被替换,导致容器启动异常,工作负载创建失败。
      • 挂载高危目录的情况下 ,建议使用低权限账号启动,否则可能会造成宿主机高危文件被破坏。
      • AOM只采集最近修改过的前20个日志文件,且默认采集两级子目录。
      • AOM只采集挂载路径下的“.log”、“.trace”、“.out”文本日志文件。

      采集路径

      设置采集路径可以更精确的指定采集内容,当前支持以下设置方式:

      • 不设置则默认采集当前路径下.log .trace .out文件。
      • 设置**表示递归采集5层目录下的.log .trace .out文件。
      • 设置*表示模糊匹配。

      例子: 采集路径为/tmp/**/test*.log 表示采集/tmp目录及其1-5层子目录下的全部以test开头的.log文件。

      注意:

      使用采集路径功能请确认您的采集器ICAgent版本为5.12.22或以上版本。

      日志转储

      此处日志转储是指日志的本地绕接。

      • 设置:AOM每分钟扫描一次日志文件,当某个日志文件超过50MB时,会立即对其转储(转储时会在该日志文件所在的目录下生成一个新的zip文件。对于一个日志文件,AOM只保留最近生成的20个zip文件,当zip文件超过20个时,时间较早的zip文件会被删除),转储完成后AOM会将该日志文件清空。
      • 不设置:若您在下拉列表框中选择“不设置”,则AOM不会对日志文件进行转储。
      说明:
      • AOM的日志绕接能力是使用copytruncate方式实现的,如果选择了设置,请务必保证您写日志文件的方式是append(追加模式),否则可能出现文件空洞问题。
      • 当前主流的日志组件例如Log4j、Logback等均已经具备日志文件的绕接能力,如果您的日志文件已经实现了绕接能力,则无需设置。否则可能出现冲突。
      • 建议您的业务自己实现绕接,可以更灵活的控制绕接文件的大小和个数。

在ServiceStage中添加日志策略

在CCI中添加日志策略

  1. 创建负载时,选择镜像后,单击“高级设置”,展开“日志采集”页签。
  2. 添加日志策略。

    单击“添加日志存储”,参考表3进行配置。

    图2 在CCI中添加日志策略
    表3 参数说明

    参数

    参数说明

    容器内日志路径

    日志存储挂载到容器内的挂载路径,需要保证服务的日志输出路径与该路径一致,这样日志才能写入到日志存储卷中。

    须知:
    • 日志存储卷挂载后,会覆盖掉日志路径下已有的内容。请保证日志路径为一个独立的路径,否则原来的内容不可见。
    • AOM只采集最近修改过的前20个日志文件,且不采集子目录。
    • AOM只采集日志路径下的“.log”、“.trace”、“.out”文本日志文件。

    日志存储空间

    日志的存储空间大小。

    AOM对日志卷中的日志按50MB进行防爆处理,AOM只保留最近生成的20个zip文件,当zip文件超过20个时,时间较早的zip文件会被删除。

support.huaweicloud.com/usermanual-aom/aom_02_0031.html