文档首页/ 应用管理与运维平台 ServiceStage/ 用户指南/ 组件管理/ 管理容器部署组件容器配置/ 设置应用日志策略
更新时间：2025-08-01 GMT+08:00
查看PDF
分享

设置应用日志策略

ServiceStage支持为容器部署的应用组件配置应用日志策略，组件部署环境下绑定的是CCE集群时，您可以在应用运维管理AOM中查看相关运行日志，也可以将组件运行日志采集到云日志服务（LTS）中查看处理。如果不配置任何日志策略，则系统默认会采集应用标准输出日志。

推荐您将日志直接采集到LTS，AOM中查看处理日志功能即将下线。

使用限制

如果将容器部署方式部署的组件运行日志采集到LTS查看处理，存在以下限制条件：

  • 支持容器引擎为Docker的CCE集群节点。
  • 支持使用Containerd作为容器引擎的CCE集群节点（ICAgent 5.12.130及以上版本）。
  • 容器内的日志目录如果已挂载到主机目录上，将无法通过配置容器文件路径方式采集到LTS，只能通过配置节点文件路径方式采集到LTS。
  • 容器文件日志采集目前仅支持overlay2存储驱动，不支持devicemapper作为存储驱动的节点。查看存储驱动类型，请使用如下命令： 
    docker info | grep "Storage Driver"

设置应用日志策略

  1. 选择“容器配置”。
  2. 选择“日志采集 > 添加日志策略”。
  3. 参考下表设置日志策略参数，其中带“*”标志的参数为必填参数。

    参数

    参数说明

    存储类型

    选择日志存储类型。

    • 主机路径：将主机上的路径挂载到指定的容器路径。
    • 容器路径：日志仅输出到容器路径，无需挂载主机路径。需要采集器ICAgent版本升级到5.10.79。

    *主机路径

    存储类型为“主机路径”时需要设置。

    输入主机上的日志存储路径。

    *容器挂载
    1. 设置“挂载路径”：输入数据存储挂载到应用上的路径。
      • 请不要挂载在系统目录下，如“/”、“/var/run”等，会导致应用异常。建议挂载在空目录下，若目录不为空，请确保目录下无影响应用启动的文件，否则文件会被替换，导致应用启动异常，应用创建失败。
      • 挂载高危目录的情况下，建议使用低权限账号启动，否则可能会造成宿主机高危文件被破坏。
    2. 设置“主机扩展路径”，存储类型为“主机路径”时需要设置。
      • None：不配置拓展路径。
      • PodUID：Pod的ID。
      • PodName：Pod的名称。
      • PodUID/ContainerName：Pod的ID/容器名称。
      • PodName/ContainerName：Pod名称/容器名称。
    3. 设置“采集路径”。

      设置采集路径后，可以精确指定采集内容。采集器ICAgent为5.12.22或以上版本时，支持设置采集路径。当前支持以下设置方式：

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

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

    4. 设置“老化周期”。
      • Hourly：每小时扫描一次日志文件。如文件超过20MB，会将其压缩到一个历史文件中并转储到日志所在目录下，并清空原文件。
      • Daily：每天扫描一次日志文件。如文件超过20MB，会将其压缩到一个历史文件中并转储到日志所在目录下，并清空原文件。
      • Weekly：每周扫描一次日志文件。如文件超过20MB，会将其压缩到一个历史文件中并转储到日志所在目录下，并清空原文件。
    5. 单击，设置“日志格式”。
      系统默认按行采集显示程序打印的日志。在程序打印日志存在一条完整日志跨占多行的情况下，如果需要采集显示整条日志，您可以设置“日志格式”，开启多行日志。
      • 单行日志：系统默认按行采集日志。
      • 多行日志：系统按设置的匹配规则采集日志。

        分行模式：“日志格式”选择“多行日志”时需设置，用于匹配每条日志的开头。选择“日志时间”表示采用时间匹配方式；选择“正则模式”表示采用正则表达式匹配。

        时间通配符：“分行模式”选择“日志时间”时，请输入时间通配符。例如日志中每条日志发生的时间格式是YYYY-MM-DD hh:mm:ss，则时间通配符按照规则应该填写YYYY-MM-DD hh:mm:ss。

        正则：“分行模式”选择“正则模式”时，请根据日志中每条日志开头的格式输入相应的正则表达式。

  4. 单击“确定”。
  5. 参考下表确定是否将组件运行日志采集到云日志服务（LTS）查看处理。

    是否将组件运行日志采集到LTS

    操作说明

    是

    勾选“自动对接 云日志服务LTS 的日志”。

    系统根据3确定日志采集路径：
    • 如果您配置的都是容器挂载，则日志会下发到LTS的容器文件路径。
    • 如果您配置的都是主机挂载，则日志会下发到LTS的节点文件路径。
    • 如果您同时配置了容器挂载和节点挂载，由于LTS的限制，则只能保留节点挂载的路径，日志也只会下发到LTS的节点文件路径。
    • 如果您没有配置日志采集，则配置日志路径为/var/log/*以及/var/logs/*，也对应到LTS的容器文件路径。
    组件配置并部署完成后，系统自动生成相应的日志组和日志流配置，并在LTS控制台“接入管理”页面生成接入配置和主机组。
    • 日志组名称：命名规则为servicestage-{应用ID}，应用ID为组件所属应用的ID。
    • 日志流名称：命名规则为lts-topic-{组件名}，组件名为当前对接LTS的组件名称。
    • 接入配置名称：命名规则为access-config-{组件名}，组件名为当前对接LTS的组件名称。
    • 主机组名称：命名规则为k8s-log-{CCE集群ID}，CCE集群ID为当前对接LTS的组件所在的CCE集群ID。

    否

    不勾选“自动对接 云日志服务LTS 的日志”。

    • 组件配置并部署完成后，您可以到应用运维管理AOM查看运行日志。具体操作请参考查看日志文件。
    • 组件配置并部署完成后，您也可以参考管理组件运行LTS日志将组件日志采集到LTS。