Docker使用

2025-01-17

使用前提

已安装docker

采集Docker容器日志

准备 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 -

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

查看 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

进入iLogtail容器

docker exec -it docker_loongcollector bash

查看采集到的标准输出

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:0.2.0","_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:0.2.0","_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:0.2.0","_container_name_":"docker_loongcollector","_container_ip_":"172.17.0.7","__time__":"1733387196"}

构造示例日志

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

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

跳出容器，在宿主机上执行
Terminal window
```
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