日志日志记录驱动程序

这journaldlogging 驱动程序将容器日志发送到systemd杂志. 可以使用journalctl命令，通过使用journalAPI 或使用docker logs命令。

除了日志消息本身的文本之外，journald日志驱动程序 将以下元数据与每条消息一起存储在日志中：

用法

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

以下示例将日志驱动程序设置为journald:

{
  "log-driver": "journald"
}

重新启动 Docker 以使更改生效。

要为特定容器配置日志记录驱动程序，请使用--log-driver标志docker run命令。

$ docker run --log-driver=journald ...

选项

使用--log-opt NAME=VALUE标志以指定其他journald伐木 驱动程序选项。

如果label和envoptions 的env优先。每个选项都会向 logging 消息。

以下是记录到 journald 所需的日志记录选项的示例。

$ docker run \
    --log-driver=journald \
    --log-opt labels=location \
    --log-opt env=TEST \
    --env "TEST=false" \
    --label location=west \
    your/application

此配置还指示驱动程序在有效负载中包含标签 location 和环境变量TEST.如果--env "TEST=false"或--label location=west参数，则相应的键将 未在 journald log 中设置。

关于容器名称的注意事项

在CONTAINER_NAMEfield 是容器的名称，该容器 在启动时设置。如果您使用docker rename要重命名容器，新的 name 不会反映在 journal entries 中。日记条目继续 以使用原始名称。

检索日志消息journalctl

使用journalctl命令检索日志消息。您可以应用过滤器 表达式将检索到的消息限制为与特定 容器：

$ sudo journalctl CONTAINER_NAME=webserver

您可以使用其他筛选条件来进一步限制检索的消息。这-bflag 仅检索自上次系统引导以来生成的消息：

$ sudo journalctl -b CONTAINER_NAME=webserver

这-oflag 指定检索到的日志消息的格式。用-o json以 JSON 格式返回日志消息。

$ sudo journalctl -o json CONTAINER_NAME=webserver

查看启用了 TTY 的容器的日志

如果在容器上启用了 TTY，您可能会看到[10B blob data]在输出中 检索日志消息时。 原因是\r附加到行尾，并且journalctl不会自动剥离它，除非--all已设置：

$ sudo journalctl -b CONTAINER_NAME=webserver --all

使用journal应用程序接口

此示例使用systemd用于检索容器的 Python 模块 原木：

import systemd.journal

reader = systemd.journal.Reader()
reader.add_match('CONTAINER_NAME=web')

for msg in reader:
    print '{CONTAINER_ID_FULL}: {MESSAGE}'.format(**msg)