采集标准Docker容器日志

步骤一：部署Logtail容器

1. 拉取Logtail镜像。根据实际情况替换 registry.cn-hangzhou.aliyuncs.com ，地域信息请参见 安装Logtail（Linux系统） 。如果您的服务器处于阿里云VPC网络中，需将 registry 修改为 registry-vpc 。

   docker pull registry.cn-hangzhou.aliyuncs.com/log-service/logtail

2. 执行以下命令，启动Logtail容器。

   docker run --privileged -d \
       -v /:/logtail_host:ro \
       -v /var/run/docker.sock:/var/run/docker.sock \
       --env ALIYUN_LOGTAIL_CONFIG=/etc/ilogtail/conf/${your_region_name}/ilogtail_config.json \
       --env ALIYUN_LOGTAIL_USER_ID=${your_aliyun_user_id} \
       --env ALIYUN_LOGTAIL_USER_DEFINED_ID=${your_machine_group_user_defined_id} \
       registry.cn-hangzhou.aliyuncs.com/log-service/logtail

   参数	参数说明
   --privileged	--privileged 参数是必要的，否则删除其他容器时可能出现错误 container text file busy ，更多信息请参见 Bug 1468249 、 Bug 1441737 和 issue 34538 。对于Centos 7.4及以上版本（不包括Centos 8.0），可以去掉 --privileged 参数，然后执行以下命令设置 fs.may_detach_mounts=1 。 echo fs.may_detach_mounts=1 | sudo tee /etc/sysctl.d/may_detach_mounts.conf sudo sysctl -p /etc/sysctl.d/may_detach_mounts.conf sysctl fs.may_detach_mounts
   ${your_region_name}	请根据日志服务Project所在地域及网络类型填写。其中，地域信息请参见 安装Logtail（Linux系统） ，网络类型选择请参见 选择网络 。 如果为公网，格式为 region-internet 。例如 华东 1（杭州） 为 cn-hangzhou-internet 。 如果为阿里云内网，格式为 region 。例如 华东 1（杭州） 为 cn-hangzhou 。
   ${your_aliyun_user_id}	您的日志服务所在的阿里云账号（主账号）ID。获取方法，请参见 获取日志服务所在的阿里云账号（主账号）ID 。
   ${your_machine_group_user_defined_id}	设置机器组的用户自定义标识，例如 log-docker-demo 。 重要 请确保该标识在您的Project所在地域内唯一。 在 步骤二 中创建机器组时，您需要在 用户自定义标识 中输入此处设置的用户自定义标识。

   重要

   如果您要自定义配置Logtail容器的启动参数，只需保证以下前提条件。

   • 启动时，必须配置3个环境变量 ALIYUN_LOGTAIL_USER_DEFINED_ID 、 ALIYUN_LOGTAIL_USER_ID 、 ALIYUN_LOGTAIL_CONFIG 。

   • 将宿主机上的 /var/run 目录挂载到Logtail容器的 /var/run 目录。

   • 将宿主机根目录挂载到Logtail容器的 /logtail_host 目录。

   • 如果Logtail日志（ /usr/local/ilogtail/ilogtail.LOG ）中出现 The parameter is invalid : uuid=none 的错误日志，请在宿主机上创建一个 product_uuid 文件，在其中输入任意合法UUID（例如 169E98C9-ABC0-4A92-B1D2-AA6239C0D261 ），并把该文件挂载到Logtail容器的 /sys/class/dmi/id/product_uuid 目录。

步骤二：创建Logtail采集配置

1. 进入采集配置流程。单击页面右侧 快速接入数据 卡片，在 自建开源/商业软件 页签下，单击 Docker文件-容器 或 Docker标准输出-容器 。

   

2. 选择目标Project和Logstore，然后单击下一步。

   

3. 创建机器组。如果已有机器组，请前往第5步。

   

4. 在右侧面板，单击 用户自定义标识 ，然后输入 用户自定义标识 ，然后单击 确定 。这里的自定义标识必须和 步骤一 中设置的自定义标识一致，本文为 log-docker-demo 。

   

5. 从 源机器组 列表选择目标机器组，然后单击 下一步 。

6. 在Logtail配置页面，确定全局配置、输入配置和处理配置，配置参数说明请参见 采集主机文本日志 。如果需要对日志进行进一步处理例如正则解析、JSON解析等，可以在 处理配置 的 处理模式 中添加 处理插件概述 。完成配置后，单击 下一步 。

7. 在查询分析配置页面 创建索引 。

默认字段

Docker标准输出

Docker文件

其他操作

查看Logtail运行状态

您可以执行 docker exec ${logtail_container_id} /etc/init.d/ilogtaild status 命令查看Logtail运行状态。

查看Logtail的版本号、IP地址和启动时间等信息

您可以执行 docker exec ${logtail_container_id} cat /usr/local/ilogtail/app_info.json 命令查看Logtail相关信息。

查看Logtail的运行日志

[sudo@iZb****exh2Z ilogtail]# docker exec a287de895e40 tail -n 5 /usr/local/ilogtail/ilogtail.LOG
[2018-02-06 08:13:35.721864]    [INFO]    [8]    [build/release64/sls/ilogtail/LogtailPlugin.cpp:104]    logtail plugin Resume:start
[2018-02-06 08:13:35.722135]    [INFO]    [8]    [build/release64/sls/ilogtail/LogtailPlugin.cpp:106]    logtail plugin Resume:success
[2018-02-06 08:13:35.722149]    [INFO]    [8]    [build/release64/sls/ilogtail/EventDispatcher.cpp:369]    start add existed check point events, size:0
[2018-02-06 08:13:35.722155]    [INFO]    [8]    [build/release64/sls/ilogtail/EventDispatcher.cpp:511]    add existed check point events, size:0    cache size:0    event size:0    success count:0
[2018-02-06 08:13:39.725417]    [INFO]    [8]    [build/release64/sls/ilogtail/ConfigManager.cpp:3776]    check container path update flag:0    size:1

start umount useless mount points, /shm$|/merged$|/mqueue$
umount: /logtail_host/var/lib/docker/overlay2/3fd0043af174cb0273c3c7869500fbe2bdb95d13b1e110172ef57fe840c82155/merged: must be superuser to unmount
umount: /logtail_host/var/lib/docker/overlay2/d5b10aa19399992755de1f85d25009528daa749c1bf8c16edff44beab6e69718/merged: must be superuser to unmount
umount: /logtail_host/var/lib/docker/overlay2/5c3125daddacedec29df72ad0c52fac800cd56c6e880dc4e8a640b1e16c22dbe/merged: must be superuser to unmount
......
xargs: umount: exited with status 255; aborting
umount done
start logtail
ilogtail is running
logtail status:
ilogtail is running

重启Logtail

请参考以下示例重启Logtail。

[sudo@iZb****xh2Z ilogtail]# docker exec a287de895e40 /etc/init.d/ilogtaild stop
kill process Name: ilogtail pid: 7
kill process Name: ilogtail pid: 8
stop success
[sudo@iZb****xh2Z ilogtail]# docker exec a287de895e40 /etc/init.d/ilogtaild start
ilogtail is running

问题排查

当您使用Logtail采集Docker容器日志遇到异常情况时，您可以参见 如何排查容器日志采集异常 进行排查。