本地文件记录驱动程序

预计阅读时间：2分钟

在local从容器的stdout / stderr输出记录驱动器捕获，并将其写入到为性能和磁盘使用而优化的内部存储。

默认情况下，local驱动程序每个容器保留100MB日志消息，并使用自动压缩来减小磁盘上的大小。100MB的默认值基于每个文件的20M默认大小和此类文件数的默认计数5（以考虑日志轮转）。

笔记

该local日志驱动程序使用基于文件的存储。文件格式和存储机制旨在由Docker守护程序独家访问，并且不应由外部工具使用，因为实现可能会在将来的版本中更改。

用法

要将local驱动程序用作默认的日志记录驱动程序，请在Linux主机或Windows Server上的文件中将log-driver 和log-opt键设置为适当的值。有关使用来配置Docker的更多信息，请参见 daemon.json。daemon.json/etc/docker/C:\ProgramData\docker\config\daemon.jsondaemon.json

下面的示例将日志驱动程序local设置为并设置max-size 选项。

{
  "log-driver": "local",
  "log-opts": {
    "max-size": "10m"
  }
}

重新启动Docker，以使更改对新创建的容器生效。现有容器不使用新的日志记录配置。

您可以使用或--log-driver标记来设置特定容器的日志记录驱动程序：docker container createdocker run

$ docker run \
      --log-driver local --log-opt max-size=10m \
      alpine echo hello world

选项

该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

本地，docker，日志，驱动