在 docker 中配置 fluentd 日志驱动，需要在启动容器时通过 --log-driver=fluentd 指定日志驱动，并使用 --log-opt 设置 fluentd 的地址（fluentd-address）和标签（fluentd-tag）。这样 docker 守护进程会将容器的 stdout 和 stderr 日志实时转发到指定的 fluentd 实例。如果未指定地址，docker 会尝试连接默认的 localhost:24224。

如何指定 Fluentd 接收地址与 Tag 格式

使用 --log-opt fluentd-address=tcp://192.168.1.10:24224 指定远程 Fluentd 服务，并通过 --log-opt fluentd-tag=app.docker.<container_name></container_name> 定义日志标签前缀。Docker 默认使用 TCP 协议发送日志，若需 UDP 可添加 fluentd-require-ack-response=false 等选项优化性能。

docker run -d 
  --name my-app 
  --log-driver=fluentd 
  --log-opt fluentd-address=tcp://192.168.1.10:24224 
  --log-opt fluentd-tag=app.docker.my-app 
  nginx:latest

预期结果：容器 my-app 的日志被发送到 192.168.1.10:24224，Fluentd 接收到的 tag 为 app.docker.my-app，消息体包含 JSON 格式的日志内容。

Docker Hub

Docker Hub (hub.docker.com)。此技能适用于所有 Docker Hub 操作，包括读取、创建、更新和删除数据。只要任务涉及 Docker Hub，就使用此技能。

下载

如何处理容器重启后的日志连续性

Docker 的 Fluentd 驱动默认不保留位置信息，容器重启后可能重复发送或丢失部分日志。可通过 --log-opt fluentd-buffer-limit=32m 设置缓冲区大小，配合 Fluentd 侧的缓冲插件确保数据不丢失。但需注意，Docker 本身不提供类似 filebeat 的持久化偏移量记录，因此高可靠场景建议结合 Fluentd 的

buffer` 和 <code>retry` 机制。</p><p><img src="https://img.php.cn/upload/article/001/242/473/179469960271259.png" alt="Docker 中怎么配置 Fluentd 日志驱动收集容器日志"></p><pre class="brush:php;toolbar:false;"># Fluentd 配置示例 (td-agent.conf)
<source>
  @type forward
  port 24224
  bind 0.0.0.0
</source>

<match app.docker.*>
  @type elasticsearch
  host 192.168.1.20
  port 9200
  index_name docker-logs
  type_name _doc
  buffer_type file
  buffer_path /var/log/fluentd/buffer
  flush_interval 5s
  retry_max_interval 30
  retry_type exponential_backoff
</match>

预期结果：Fluentd 接收日志后缓冲至本地文件，定期写入 Elasticsearch，即使网络中断也能通过重试机制保证数据完整性。

基于 fluentd-tag 输入条件如何过滤特定容器日志

当使用 --log-opt fluentd-tag=app.docker.<container_name> 时，可通过 Fluentd 的 <code><match></match> 指令按 tag 过滤日志。例如，仅收集名为 web-server 的容器日志，可在 Fluentd 配置中使用 <match app.docker.web-server></match> 匹配特定 tag，避免无关日志干扰。