nonebot2/website/versioned_docs/version-2.1.1/api/log.md

72 lines
1.3 KiB
Markdown
Raw Normal View History

2023-10-01 14:38:37 +08:00
---
sidebar_position: 7
description: nonebot.log 模块
---
# nonebot.log
本模块定义了 NoneBot 的日志记录 Logger。
NoneBot 使用 [`loguru`][loguru] 来记录日志信息。
自定义 logger 请参考 [自定义日志](https://nonebot.dev/docs/appendices/log)
以及 [`loguru`][loguru] 文档。
[loguru]: https://github.com/Delgan/loguru
## _var_ `logger` {#logger}
- **类型:** Logger
- **说明**
NoneBot 日志记录器对象。
默认信息:
- 格式: `[%(asctime)s %(name)s] %(levelname)s: %(message)s`
- 等级: `INFO` ,根据 `config.log_level` 配置改变
- 输出: 输出至 stdout
- **用法**
```python
from nonebot.log import logger
```
## _class_ `LoguruHandler(<auto>)` {#LoguruHandler}
- **说明:** logging 与 loguru 之间的桥梁,将 logging 的日志转发到 loguru。
- **参数**
auto
### _method_ `emit(record)` {#LoguruHandler-emit}
- **参数**
- `record` (logging.LogRecord)
- **返回**
- untyped
## _def_ `default_filter(record)` {#default-filter}
- **说明:** 默认的日志过滤器,根据 `config.log_level` 配置改变日志等级。
- **参数**
- `record` (Record)
- **返回**
- untyped
## _var_ `default_format` {#default-format}
- **类型:** str
- **说明:** 默认日志格式