文档中心

日志服务

采集容器日志

采集 Docker 容器日志

日志服务支持采集 Docker 容器日志，本文档介绍通过创建机器标识类型的机器组来采集 Docker 容器日志的操作步骤。

背景信息

在容器中安装日志服务提供的采集插件 LogCollector、并创建采集配置之后，LogCollector 会根据容器中的 Label 和环境变量确定待采集的容器，持续采集指定容器路径内产生的文本日志与标准输出，并将日志和容器名等容器相关的元数据信息一起上传至服务端。LogCollector 还支持断点续传，CheckPoint 文件中会留存采集相关的位点信息，即使 LogCollector 停止后重新启动，也会从上一次保存的位点继续采集。

前提条件

已创建 IAM 角色，获取 Access Key ID、Secret Access Key。并为用户授予日志主题TLSFullAccess权限，详情可参考IAM 概述。

限制说明

限制项	说明
版本限制	LogCollector ：支持 V2.3.6 及以后版本。 Docker API 版本：支持 1.40 ~1.51 版本。
采集标准输出限制	必须在 Docker 的配置文件daemon.json中添加"log-driver":"json-file"。如果是 CentOS 7.4 及以后版本，需设置fs.may_detach_mounts=1。
采集文本日志限制	支持 Docker 存储驱动为 overlay、overlay2。其他类型存储驱动需要手动挂载日志目录。

操作步骤

1 安装 LogCollector

获取 LogCollector 镜像。

在已经安装 Docker 的宿主机上执行如下命令获取 LogCollector 镜像。

docker pull logcollector-<Region ID>.cr.volces.com/logcollector/logcollector:latest

说明

镜像地址中的 Region ID 请替换为实际环境对应地域的 ID，如华北2（北京）地域 Region ID 为 cn-beijing。详情可参考服务地址。

创建 LogCollector 配置文件，设置连接日志服务信息。

在本地创建用于存放 LogCollector 的配置文件目录，如/usr/local/container/logcollector/etc。

mkdir -p /usr/local/container/logcollector/etc

创建配置文件logcollector.yaml。

cd /usr/local/container/logcollector/etc
touch logcollector.yaml

配置文件内容如下：

docker_mode: true
autodiscover:
providers:
- type: docker
cleanup_timeout: 15s

output:
tls:
region: <region>
endpoint: <endpoint>
secret_id: <secret_id>
secret_key: <secret_key>
label: <label>

其中tls参数说明如下：

参数	是否必选	示例	说明
region	必选	cn-beijing	日志项目所在的地域 Region ID。
endpoint	必选	https://tls-cn-beijing.volces.com	日志服务连接域名，即服务地址。登录日志服务控制台后，在日志项目的详情页中查看连接域名。详情可参考服务地址。
secret_id	必选	AK********	火山引擎账号或 IAM 用户的 Access Key ID。可以在火山引擎控制台密钥管理页面，获取 Access Key ID。
secret_key	必选	TUdZ********	火山引擎账号或 IAM 用户的 Secret Access Key。可以在火山引擎控制台密钥管理页面，获取 Secret Access Key。
label	必选	http_module	LogCollector 的机器标识。用于将此 LogCollector 加入机器标识类型的机器组中。支持配置多个 label 标识，通过逗号（,）分隔。

docker run -d\
--name logcollector \
-u 0 \
-v /:/logcollector_host:ro \
-v /var/run/docker.sock:/var/run/docker.sock \
-v {logcollector-data-dir}:/usr/local/container/logcollector/data \
-v {logcollector-config-dir}:/usr/local/container/logcollector/etc \
{image} \
/usr/local/container/logcollector/logcollectord \
-c \
/usr/local/container/logcollector/etc/logcollector.yaml

启动命令参数说明：

参数	是否必选	示例	说明
logcollector-data-dir	必选	/var/lib/logcollector/docker-data	存储 LogCollector CheckPoint 状态的节点目录，用于确保 LogCollector 容器重启之后 LogCollector 不会重复采集日志。
logcollector-config-dir	必选	/usr/local/container/logcollector/etc	创建的配置文件logcollector.yaml的目录。
image	必选	logcollector-cn-beijing.cr.volces.com/logcollector/logcollector:latest	LogCollector 镜像地址。

验证 LogCollector 启动状态。

执行如下命令验证 LogCollector 启动状态：

docker ps | grep logcollector

输出如下表示 LogCollector 启动正常：

96fb3bc150f9 logcollector-cn-beijing.cr.volces.com/logcollector/logcollector:v2.3.6 "/usr/local/containe…" About a minute ago Up About a minute logcollector

2 创建机器组

在日志服务控制台创建机器标识类型机器组。

机器组部分参数设置如下，其他参数根据实际环境配置即可，详情可参考创建机器组（机器标识）创建机器组。

参数	示例	说明
机器组类型	机器标识	选择机器组的类型。此处设置为机器标识。
机器标识	http_module	填写1 安装 LogCollector 中设置的 LogCollector 的机器标识。

验证机器组状态。

在机器组管理页签，单击新建的机器组名称，进入机器组详情页，在心跳状态页签查看心跳状态：

心跳正常且 IP 个数符合预期，表明 LogCollector 已成功连接到日志服务。

其他情况，请检查 LogCollector 配置文件中内容是否配置正确。

3 创建日志采集配置

在日志服务控制台创建日志项目、日志主题、并创建日志采集配置，根据日志采集类型分如下情况：

采集类型	说明	创建日志采集配置
容器应用日志	容器内应用输出到标准输出（stdout）、标准错误（stderr）的日志。	参考采集容器标准输出（DaemonSet-控制台方式）。
容器文本日志	容器内应用写入文件的日志、Docker 引擎日志（daemon）、Docker 事件日志（events）、容器元数据日志等。	参考采集容器文本日志（DaemonSet-控制台方式）。

采集规则中部分参数说明：

基础信息	说明
容器日志采集	采集 Docker 容器日志时，选择启用。
采集类型	设置容器日志的采集类型，根据实际情况选择。 K8s 容器标准输出：用于采集容器的应用日志。 K8s 容器文本日志：用于采集容器的文本日志
通用容器采集规则	通过容器的通用信息指定待采集的内容，也可以同时排除不采集的内容。未启用时，表示采集范围为全部容器。
K8s 采集规则	采集 Docker 容器日志时，请勿配置该项。

最近更新时间：2026.08.26 16:00:46

这个页面对您有帮助吗？

有用

无用