log-level
这一页说明日志级别配置。它主要影响 koipy 的日志输出等级,以及少部分附属 logger 的等级设置。
log-level
yaml
log-level: INFO注意
如果这里填了无效值,当前源码会自动回退到 INFO。如果填 DISABLE,则会直接移除 loguru 的 sink。
log-level
解释
- 这项配置用于指定 koipy 主要日志输出的等级。
- 等级越靠后,表示只保留越严重的日志。
- 它既影响文件日志,也会影响部分使用 loguru / pyrogram session 的输出行为。
特性
- 类型:
str - 稳定可用值:
DEBUG、INFO、WARNING、ERROR、CRITICAL、DISABLE log-level和log_level在 koipy 配置加载后是等效的。- 非法值会回退到
INFO
配置示例
yaml
log-level: WARNING各等级的含义
解释
text
DEBUG 最详细,适合排查问题
INFO 常规运行信息
WARNING 只看警告及以上
ERROR 只看错误及以上
CRITICAL 只看严重错误
DISABLE 禁用日志特性
- 日常运行常见选择是
INFO或WARNING - 需要排查配置、网络、脚本问题时,更适合临时切到
DEBUG DISABLE不适合排查问题时使用,因为你会直接失去大部分主日志输出
配置示例
yaml
log-level: DEBUG生效范围
解释
- 当日志级别有效且不为
DISABLE时,koipy 会把日志写到logs/koipy_{time}.log。 - 当前文件日志按
7 days轮转。 pyrogram.sessionlogger 会被设置成和这里一致的等级。- 但
apscheduler会被固定压到ERROR,Python 标准库logging.basicConfig也会固定在WARNING。
特性
- 这项配置并不等于“所有控制台输出都严格同步到同一等级”
- 它主要控制 koipy 主日志链路,而不是每个第三方库的全部细节
DISABLE时,当前实现会logger.remove(),因此 loguru 默认控制台输出也会一起关掉
配置示例
yaml
log-level: ERROR