JSON 文件日志记录驱动程序

默认情况下，Docker 会捕获所有容器的标准输出（和标准错误）。并使用 JSON 格式将它们写入文件中。JSON 格式使用其 origin （或）及其时间戳。每个日志文件都包含以下信息只有一个容器。stdoutstderr

{
  "log": "Log line is here\n",
  "stream": "stdout",
  "time": "2019-01-01T11:11:11.111111111Z"
}

警告
日志记录驱动程序使用基于文件的存储。这些文件是设计的以独占方式由 Docker 守护程序访问。与这些文件交互使用外部工具可能会干扰 Docker 的日志记录系统，并导致意外行为，应避免。json-file

用法

要将驱动程序用作默认日志记录驱动程序，请在文件中将和键设置为适当的值，即位于 Linux 主机或 Windows Server 上。如果该文件不存在，请先创建该文件。有关使用配置 Docker，请参阅 daemon.json。json-filelog-driverlog-optsdaemon.json/etc/docker/C:\ProgramData\docker\config\daemon.json

以下示例将日志驱动程序设置为并设置 and 选项以启用自动日志轮换。json-filemax-sizemax-file

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

注意
log-opts配置文件中的配置选项必须以字符串形式提供。因此，布尔值和数值（例如上例中的 for 值）必须用引号（）括起来。daemon.jsonmax-file"

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

您可以通过使用标志 to 或来为特定容器设置日志记录驱动程序：--log-driverdocker container createdocker run

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

选项

日志记录驱动程序支持以下日志记录选项：json-file

选择	描述	示例值
`max-size`	日志在滚动之前的最大大小。一个正整数加上一个表示度量单位（，，或）的修饰符。默认为 -1 （无限制）。`kmg`	`--log-opt max-size=10m`
`max-file`	可以存在的日志文件的最大数量。如果滚动日志会创建过多的文件，则会删除最旧的文件。仅当还设置了 `max-size` 时有效。正整数。默认值为 1。	`--log-opt max-file=3`
`labels`	在启动 Docker 守护程序时应用。此守护程序接受的与日志记录相关的标签的逗号分隔列表。用于高级日志标记选项。	`--log-opt labels=production_status,geo`
`labels-regex`	与类似并兼容。用于匹配与日志记录相关的标签的正则表达式。用于高级日志标记选项。`labels`	`--log-opt labels-regex=^(production_status\|geo)`
`env`	在启动 Docker 守护程序时应用。此守护程序接受的与日志记录相关的环境变量的逗号分隔列表。用于高级日志标记选项。	`--log-opt env=os,customer`
`env-regex`	与类似并兼容。用于匹配与日志记录相关的环境变量的正则表达式。用于高级日志标记选项。`env`	`--log-opt env-regex=^(os\|customer)`
`compress`	切换旋转日志的压缩。默认值为。`disabled`	`--log-opt compress=true`

例子

此示例启动一个容器，该容器最多可以有 3 个日志每个文件不超过 10 MB。alpine

$ docker run -it --log-opt max-size=10m --log-opt max-file=3 alpine ash