JSON 文件日志驱动程序

默认情况下，Docker 会捕获所有容器的标准输出（和标准错误），并以 JSON 格式将它们写入文件。JSON 格式为每一行标注了其来源（stdout 或 stderr）和时间戳。每个日志文件仅包含关于一个容器的信息。

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

警告
json-file 日志驱动程序使用基于文件的存储。这些文件被设计为仅由 Docker 守护进程访问。使用外部工具与这些文件交互可能会干扰 Docker 的日志系统并导致意外行为，因此应避免此类操作。

用法

要将 json-file 驱动用作默认日志驱动，请在 Linux 主机上的 /etc/docker/ 或 Windows Server 上的 C:\ProgramData\docker\config\ 中找到的 daemon.json 文件中，将 log-driver 和 log-opts 键设置为适当的值。如果文件不存在，请先创建它。有关使用 daemon.json 配置 Docker 的更多信息，请参阅 daemon.json。

以下示例将日志驱动设置为 json-file，并设置 max-size 和 max-file 选项以启用自动日志轮转。

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

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

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

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

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

选项

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

选项	描述	示例值
`max-size`	日志轮转前的最大大小。一个正整数加上一个表示计量单位的修饰符（`k`、`m` 或 `g`）。默认值为 -1（无限制）。	`--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`

示例

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

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