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 驱动作为默认日志驱动，请在 daemon.json 文件中将 log-driver 和 log-opts 密钥设置为适当的值，该文件位于 Linux 主机上的 /etc/docker/ 或 Windows Server 上的 C:\ProgramData\docker\config\ 中。如果文件不存在，请先创建它。有关使用 daemon.json 配置 Docker 的更多信息，请参阅 daemon.json.

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

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

注意

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

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

您可以使用 --log-driver 标志为特定容器设置日志记录驱动，方法是将 --log-driver 标志添加到 docker container create 或 docker run。

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

选项

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

示例

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

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