配置任务日志输出和保留

影响日志记录的任务环境变量

您可以修改任务日志的目标和日志保留 通过在其中指定以下任何环境变量修改 任务定义:

环境变量 默认 简述
CONTAINER_LOGGER_DESTINATION_TYPE logrotate 任务日志的指向:任务的沙盒或日志。
CONTAINER_LOGGER_LOGROTATE_MAX_STDOUT_SIZE 2MB 沙盒中 stdout 文件在触发日志轮换之前的最大大小。
CONTAINER_LOGGER_LOGROTATE_STDOUT_OPTIONS rotate 9 轮换 stdout 文件时传递给 logrotate 的选项。
CONTAINER_LOGGER_LOGROTATE_MAX_STDERR_SIZE 2MB 沙盒中 stderr 文件在触发日志轮换之前的最大大小。
CONTAINER_LOGGER_LOGROTATE_STDERR_OPTIONS rotate 9 轮换 stderr 文件时传递给 logrotate 的选项。
CONTAINER_LOGGER_EXTRA_LABELS "{}" 在输出到 journald 时标记每个日志行的额外密钥值对。

详细信息

警告:为这些选项指定无效值将导致该任务 启动失败。

目标类型

CONTAINER_LOGGER_DESTINATION_TYPE 可能采用三个自变量:

  • logrotate (默认)
  • journald
  • journald+logrotate

不推荐 使用 journald 选项,这是因为 journald 性能问题. 启用后,日志会直接通过管道传输到节点的日志中,同时还有 AGENT_ID``EXECUTOR_IDCONTAINER_ID. 等一些标签

logrotate 选项将放置日志(名为 stdoutstderr) 在任务沙盒内并创建附加文件,用于轮换这些 日志 (*.logrotate.conf*.logrotate.state).

请参阅 记录参考 了解如何读取这些日志的信息。

最大大小

CONTAINER_LOGGER_LOGROTATE_MAX_STDOUT_SIZECONTAINER_LOGGER_LOGROTATE_MAX_STDERR_SIZE 选项控制 这些日志文件的最大大小。达到此阈值后,日志轮换 就会被触发。

大小必须为小于 2^64 的整数,且后缀必须带有 B(字节)、KBMBGBTB. 的等单位。不应该在 整数和单位之间留有空格。

示例:

  • 2MB
  • 1234B
  • 1TB

重要信息:大小的规定上限为 2^64 字节。尝试指定更高的 值(例如 2^64 TB)将导致未确定的结果。

禁用的日志轮换选项

禁用 CONTAINER_LOGGER_LOGROTATE_STDOUT_OPTIONSCONTAINER_LOGGER_LOGROTATE_STDERR_OPTIONS,以防止滥用 postrotate 条款和其他注入式攻击。请参阅 MESOS-9564 以获取更多信息。