编辑“︁Docker日志驱动”︁

{{DISPLAYTITLE:Docker日志驱动}}  
'''Docker日志驱动'''是Docker引擎用于收集、存储和管理容器日志的机制。它决定了日志的格式、传输方式和存储位置，是容器监控与日志管理的关键组件。本条目将详细介绍日志驱动的类型、配置方法、实际应用场景及最佳实践。

== 概述 ==  
Docker默认将容器的标准输出（STDOUT）和标准错误（STDERR）作为日志处理。通过配置不同的'''日志驱动（Logging Driver）'''，用户可以将日志发送到文件、外部系统（如Fluentd、Syslog）或云服务（如AWS CloudWatch）。  

日志驱动的核心功能包括：  
* 定义日志的格式（如JSON、文本）。  
* 控制日志的存储位置（本地文件、远程服务器）。  
* 支持日志轮转和大小限制。  

== 支持的日志驱动类型 ==  
Docker支持以下常用日志驱动（可通过<code>docker info</code>查看当前支持的驱动列表）：  

{| class="wikitable"  
! 驱动名称  
! 描述  
|-  
| <code>json-file</code>  
| 默认驱动，将日志存储为JSON格式的本地文件。  
|-  
| <code>syslog</code>  
| 将日志发送到Syslog服务器。  
|-  
| <code>journald</code>  
| 将日志写入systemd的journal（仅限Linux）。  
|-  
| <code>fluentd</code>  
| 将日志转发到Fluentd服务。  
|-  
| <code>awslogs</code>  
| 将日志发送到AWS CloudWatch Logs。  
|-  
| <code>none</code>  
| 禁用容器日志记录。  
|}  

== 配置日志驱动 ==  

=== 全局配置 ===  
修改Docker守护进程配置文件（通常为<code>/etc/docker/daemon.json</code>）以设置默认日志驱动：  
<syntaxhighlight lang="json">  
{  
  "log-driver": "json-file",  
  "log-opts": {  
    "max-size": "10m",  
    "max-file": "3"  
  }  
}  
</syntaxhighlight>  
重启Docker服务生效：<code>sudo systemctl restart docker</code>。  

=== 容器级配置 ===  
启动容器时通过<code>--log-driver</code>和<code>--log-opt</code>指定：  
<syntaxhighlight lang="bash">  
docker run --log-driver=syslog --log-opt syslog-address=udp://192.168.1.1:514 nginx  
</syntaxhighlight>  

== 日志驱动示例 ==  

=== 示例1：使用json-file驱动 ===  
默认配置下，Docker将日志存储在<code>/var/lib/docker/containers/[container-id]/[container-id]-json.log</code>。查看日志：  
<syntaxhighlight lang="bash">  
docker logs [container-name]  
</syntaxhighlight>  

=== 示例2：发送日志到Fluentd ===  
1. 启动Fluentd服务（需预先配置）。  
2. 运行容器并指定驱动：  
<syntaxhighlight lang="bash">  
docker run --log-driver=fluentd --log-opt fluentd-address=192.168.1.2:24224 nginx  
</syntaxhighlight>  

== 实际应用场景 ==  

=== 场景1：集中式日志管理 ===  
企业使用<code>fluentd</code>或<code>syslog</code>驱动将多台主机的日志汇总到Elasticsearch，便于通过Kibana可视化分析。  

=== 场景2：云原生日志收集 ===  
在AWS ECS中，使用<code>awslogs</code>驱动直接将日志推送至CloudWatch，无需额外代理。  

== 性能与限制 ==  
* '''json-file'''：简单但可能占用大量磁盘空间，需配置轮转（<code>max-size</code>和<code>max-file</code>）。  
* '''syslog/fluentd'''：依赖网络，可能增加延迟。  
* '''none'''：禁用日志，仅适用于不需要日志的场景。  

== 高级配置 ==  
=== 自定义日志标签 ===  
通过<code>--log-opt tag</code>为日志添加标识：  
<syntaxhighlight lang="bash">  
docker run --log-driver=json-file --log-opt tag="{{.ImageName}}/{{.Name}}" nginx  
</syntaxhighlight>  

=== 日志缓冲与异步写入 ===  
部分驱动（如<code>fluentd</code>）支持异步模式以减少性能影响：  
<syntaxhighlight lang="json">  
{  
  "log-driver": "fluentd",  
  "log-opts": {  
    "fluentd-async": "true"  
  }  
}  
</syntaxhighlight>  

== 故障排查 ==  
若日志未正常收集，检查以下内容：  
1. Docker守护进程日志配置是否正确。  
2. 网络连通性（远程日志服务）。  
3. 容器日志权限（如<code>journald</code>需要<code>docker</code>用户加入<code>systemd-journal</code>组）。  

== 总结 ==  
Docker日志驱动提供了灵活的日志管理方案，用户可根据需求选择本地存储或集成第三方服务。合理配置日志驱动是构建可靠容器化系统的重要步骤。  

{{Docker学习路径结构}}

[[Category:集成部署]]
[[Category:Docker]]
[[Category:Docker监控与日志]]