Docker使用

使用前提

已安装docker

采集Docker容器日志

1. 准备 LoongCollector 配置目录

   新建配置目录config目录，在目录中创建file_simple.yaml和stdout_simple.yaml。

   在file_simple.yaml中配置采集容器中的simple.log到标准输出。

   enable: true
   inputs:
     - Type: input_file          # 文件输入类型
       FilePaths: 
         - ./simple.log
   flushers:
     - Type: flusher_stdout    # 标准输出流输出类型
       OnlyStdout: true
   

   在stdout_simple.yaml中配置采集容器标准输出并输出到simple.stdout文件。

   enable: true
   inputs:
     - Type: service_docker_stdout # 容器标准输出流输入类型
       Stderr: false               # 不采集标准错误流
       Stdout: true                # 采集标准输出流
   flushers:
     - Type: flusher_stdout        # 标准输出流输出类型
       FileName: simple.stdout     # 重定向文件名
   

   您也可以直接从下面的地址下载示例配置。

   mkdir config && cd config
   wget https://raw.githubusercontent.com/alibaba/loongcollector/main/example_config/start_with_docker/config/file_simple.yaml
   wget https://raw.githubusercontent.com/alibaba/loongcollector/main/example_config/start_with_docker/config/stdout_simple.yaml
   cd -
   

2. 启动 LoongCollector 容器，并挂载 LoongCollector 配置目录

   镜像 tag 请与 GitHub Releases — alibaba/loongcollector 当前发布一致。下例使用 阿里云镜像 + 明确版本号 3.3.2（国内拉取常见写法）。注意：阿里云该仓库不提供与 GHCR 对等的 latest 浮动 tag；若希望 docker pull ...:latest，请改用 ghcr.io/alibaba/loongcollector:latest（仍以 Release 正文为准），并接受其滚动更新语义。

   docker run -d --name docker_loongcollector \
     -v /:/logtail_host:ro \
     -v /var/run:/var/run \
     -v /var/lib/docker_loongcollector/checkpoint:/usr/local/loongcollector/data/checkpoint \
     -v `pwd`/config:/usr/local/loongcollector/conf/continuous_pipeline_config/local \
     sls-opensource-registry.cn-shanghai.cr.aliyuncs.com/loongcollector-community-edition/loongcollector:3.3.2
   

   第1行-d参数表示后台启动 LoongCollector 容器，--name指定容器名称以便引用。
   第2行将主机/目录挂载到 LoongCollector 容器中，LoongCollector 依赖logtail_host路径采集容器日志。
   第3行将主机/var/run目录挂载到 LoongCollector 容器中，LoongCollector 依赖/var/run目录与容器引擎通信。
   第4行将主机目录挂载到容器中 LoongCollector 的checkpoint目录，使采集状态在容器重启时可恢复。
   第5行将配置目录挂载到 LoongCollector 容器中。

3. 查看 docker_loongcollector 容器自身标准输出日志

   docker logs docker_loongcollector
   

   结果为

   loongcollector started. pid: 11
   /usr/local/loongcollector/thirdparty dir is not existing, create done
   register fun v2 0x7ade80 0x7b4350 0x7b39f0 0x7b04c0
   load log config /usr/local/loongcollector/conf/plugin_logger.xml 
   recover stderr
   recover stdout
   

4. 进入 LoongCollector 容器

   docker exec -it docker_loongcollector bash
   

5. 查看采集到的标准输出

   cat /usr/local/loongcollector/simple.stdout
   

   结果为

   2024-12-05 08:26:39 {"content":"loongcollector started. pid: 11","_time_":"2024-12-05T08:26:30.642276065Z","_source_":"stdout","_image_name_":"sls-opensource-registry.cn-shanghai.cr.aliyuncs.com/loongcollector-community-edition/loongcollector:3.3.2","_container_name_":"docker_loongcollector","_container_ip_":"172.17.0.7","__time__":"1733387196"}
   2024-12-05 08:26:39 {"content":"/usr/local/loongcollector/thirdparty dir is not existing, create done","_time_":"2024-12-05T08:26:30.666735624Z","_source_":"stdout","_image_name_":"sls-opensource-registry.cn-shanghai.cr.aliyuncs.com/loongcollector-community-edition/loongcollector:3.3.2","_container_name_":"docker_loongcollector","_container_ip_":"172.17.0.7","__time__":"1733387196"}
   2024-12-05 08:26:39 {"content":"recover stdout","_time_":"2024-12-05T08:26:33.775046868Z","_source_":"stdout","_image_name_":"sls-opensource-registry.cn-shanghai.cr.aliyuncs.com/loongcollector-community-edition/loongcollector:3.3.2","_container_name_":"docker_loongcollector","_container_ip_":"172.17.0.7","__time__":"1733387196"}
   

6. 构造示例日志

   echo 'Hello, LoongCollector!' >> ./simple.log
   

7. 查看采集到的容器文件日志

   跳出容器，在宿主机上执行

   docker logs docker_loongcollector
   

   结果相比第3步的结果，多了

   2024-12-05 08:28:12 {"content":"Hello, LoongCollector!","__time__":"1733387291"}
   

采集模版

了解采集配置结构：采集配置

参考更多可组合的日志采集和处理配置样例：https://github.com/alibaba/loongcollector/blob/main/example_config