切换语言

JSON 文件日志记录驱动程序

目录

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

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

警告

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

用法

要使用json-filedriver 作为默认的日志记录驱动程序，将log-driver和log-optskeys 添加到daemon.json文件，即 位于/etc/docker/在 Linux 主机上或C:\ProgramData\docker\config\在 Windows Server 上。如果该文件不存在，请先创建该文件。有关 使用 配置 Dockerdaemon.json，请参阅 daemon.json。

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

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

注意

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

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

您可以使用--log-driverflag 设置为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 MB。

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