mirror of
https://github.com/mamoe/mirai.git
synced 2025-01-17 07:34:49 +08:00
64 lines
2.0 KiB
Markdown
64 lines
2.0 KiB
Markdown
|
# Mirai Console Backend - Logging
|
|||
|
|
|
|||
|
|
Console 的日志一共有五个级别：
|
|||
|
|
|
|||
|
|
| 级别（由高到低） | 用途 | 默认启用 |
|
|||
|
|
|:----------:|--------------|:------:|
|
|||
|
|
| ERROR | 记录影响程序运行的错误 | 是 |
|
|||
|
|
| WARNING | 记录不影响程序运行的警告 | 是 |
|
|||
|
|
| INFO | 记录一条普通信息 | 是 |
|
|||
|
|
| DEBUG | 记录普通调试信息 | 否 |
|
|||
|
|
| VERBOSE | 记录详细调试信息 | 否 |
|
|||
|
|
|
|||
|
|
`DEBUG` 和 `VERBOSE`
|
|||
|
|
作为调试信息，默认关闭。插件开发者可能会使用这两个级别来输出调试信息。如果你在使用中遇到问题，启用这个两个级别获得更多日志后再报告开发者可能更有帮助。
|
|||
|
|
|
|||
|
|
特别地，`ALL` 表示启用全部日志，`NONE` 表示禁用全部日志。
|
|||
|
|
|
|||
|
|
在终端前端（或 [MCL](https://github.com/iTXTech/mirai-console-loader)
|
|||
|
|
），日志配置文件默认路径为 `config/Console/Logger.yml`。示例内容为如下。
|
|||
|
|
|
|||
|
|
```yaml
|
|||
|
|
# 默认日志输出等级 可选值: 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，以首字母识别）
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
2022-05-02 11:09:28 V/Bot 12345678: Event: BotOnlineEvent(bot=Bot(12345678))
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
如果在日志配置这样修改：
|
|||
|
|
|
|||
|
|
```yaml
|
|||
|
|
loggers:
|
|||
|
|
"Bot 12345678": NONE
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
那么将禁用来自该 Bot 的所有日志。
|
|||
|
|
|
|||
|
|
假设要启用名为 `Chat Command` 的插件的 DEBUG 及更高级别的日志：
|
|||
|
|
|
|||
|
|
```yaml
|
|||
|
|
loggers:
|
|||
|
|
"Chat Command": DEBUG
|
|||
|
|
```
|