Mirai Console Backend - Logging

Console 的日志一共有五个级别:

级别(由高到低)用途默认启用
ERROR记录影响程序运行的错误
WARNING记录不影响程序运行的警告
INFO记录一条普通信息
DEBUG记录普通调试信息
VERBOSE记录详细调试信息

DEBUGVERBOSE 作为调试信息,默认关闭。插件开发者可能会使用这两个级别来输出调试信息。如果你在使用中遇到问题,启用这个两个级别获得更多日志后再报告开发者可能更有帮助。

特别地,ALL 表示启用全部日志,NONE 表示禁用全部日志。

在终端前端(或 MCLopen in new window ),日志配置文件默认路径为 config/Console/Logger.yml。示例内容为如下。

# 默认日志输出等级 可选值: ALL, VERBOSE, DEBUG, INFO, WARNING, ERROR, NONE
defaultPriority: INFO
# 特定日志记录器输出等级
loggers:
    example.logger: NONE
    console.debug: NONE
    Bot: ALL

调整全局默认日志等级

修改 defaultPriority 即可修改全局默认日志等级。

例如设置为 DEBUG,则启用上表中 DEBUG 及更高级别的日志,即 DEBUG、INFO、WARNING、ERROR。

调整特定日志等级

每个插件被分配的日志的 ID 为插件的显示名称。

提示:该 ID 也可以在日志中找到。如下面的日志中,Bot 12345678 就是其所属日志的 ID。(V 代表等级为 VERBOSE,以首字母识别)

2022-05-02 11:09:28 V/Bot 12345678: Event: BotOnlineEvent(bot=Bot(12345678))

如果在日志配置这样修改:

loggers:
    "Bot 12345678": NONE

那么将禁用来自该 Bot 的所有日志。

假设要启用名为 Chat Command 的插件的 DEBUG 及更高级别的日志:

loggers:
    "Chat Command": DEBUG