组件日志记录

    组件输出的日志信息按 分类，一个作用域代表可以被控制的相关日志信息的整体。根据组件提供的功能，不同的组件具有不同的作用域。所有组件都有 default 作用域，该作用域用于未分类的日志信息。

    例如，在撰写本文时，Mixer 有 5 个作用域，代表了 Mixer 中的不同功能区域：

    • adapters
    • api
    • attributes
    • default

    Pilot、Citadel 和 Galley 具有它们自己的范围，你可以通过查看它们的参考文档来获取更多信息。

    每个作用域都有一个唯一的输出级别，为下列其中之一：

    1. none
    2. error
    3. warning
    4. info

    要控制输出级别，也可以在命令行使用 --log_output_level 选项。例如：

    除了从命令行控制输出级别外，你也可以使用 界面控制一个运行组件的输出级别。

    日志信息通常发送到组件的标准输出。--log_target 选项可以定向输出到许多不同的位置。你可以使用一个逗号分隔列表中的文件系统路径，以及分别表示标准输出和标准错误输出流的特殊值 stdout 和 stderr 。

    日志信息通常以友好的格式输出。 选项可用于将输出强制转换为 JSON 格式，以便于更简单地被工具处理。

    --log_rotate_max_age 选项可以在日志文件被轮转前指定最大天数，然而 --log_rotate_max_size 选项可以指定文件轮转之前的最大 size （以兆字节为单位）。最后，--log_rotate_max_backups 选项可以控制要保留的最大轮转文件数，较旧的文件将被自动删除。

    --log_caller 和 --log_stacktrace_level 选项可以控制日志信息是否包括程序员级别的信息。当你试着查找组件中的错误信息时它是有用的，但是，通常在日常操作中不使用。

    组件自检

    介绍如何使用 ControlZ 深入了解各个运行组件。