本地文件日志记录驱动程序
目录
这local
logging 驱动程序捕获容器的 stdout/stderr 和
将它们写入针对性能和磁盘进行优化的内部存储
用。
默认情况下,local
driver 为每个容器保留 100MB 的日志消息,并且
使用自动压缩来减小磁盘大小。100MB 默认值基于 20M 默认大小
对于每个文件,此类文件的数量默认计数为 5(考虑到日志轮换)。
警告
这
local
日志记录驱动程序使用基于文件的存储。这些文件是设计的 以独占方式由 Docker 守护程序访问。与这些文件交互 使用外部工具可能会干扰 Docker 的日志记录系统,并导致 意外行为,应避免。
用法
要使用local
driver 作为默认的日志记录驱动程序,将log-driver
和log-opt
keys 添加到daemon.json
文件,即
位于/etc/docker/
在 Linux 主机上或C:\ProgramData\docker\config\daemon.json
在 Windows Server 上。有关
使用 配置 Dockerdaemon.json
,请参阅 daemon.json。
以下示例将日志驱动程序设置为local
并设置max-size
选择。
{
"log-driver": "local",
"log-opts": {
"max-size": "10m"
}
}
重新启动 Docker,以使更改对新创建的容器生效。 现有容器不会自动使用新的日志记录配置。
您可以使用--log-driver
flag 设置为docker container create
或docker run
:
$ docker run \
--log-driver local --log-opt max-size=10m \
alpine echo hello world
请注意,local
是 bash 保留关键字,因此您可能需要在脚本中引用它。
选项
这local
日志记录驱动程序支持以下日志记录选项:
选择 | 描述 | 示例值 |
---|---|---|
max-size | 日志滚动之前的最大大小。一个正整数加上一个表示度量单位 (k ,m 或g ).默认为 20m。 | --log-opt max-size=10m |
max-file | 可以存在的日志文件的最大数量。如果滚动日志会创建过多的文件,则会删除最旧的文件。正整数。默认值为 5。 | --log-opt max-file=3 |
compress | 切换轮换日志文件的压缩。默认启用。 | --log-opt compress=false |
例子
此示例启动alpine
容器,最多可有 3 个日志
每个文件不超过 10 MB。
$ docker run -it --log-driver local --log-opt max-size=10m --log-opt max-file=3 alpine ash