Python 日志
原创

Python

Python 日志

发表于 2026-11-21

更新于 16小时前

阅读量: 11

学习笔记说明

这是一篇Python的学习笔记,关于Python 日志,仅做记录

日志的核心问题

使用什么日志库?

在python中,通常使用loguru记录日志

from loguru import logger
import sys

# 1. 移除默认的输出配置
logger.remove()

# 2. 配置控制台输出(彩色、格式化)
logger.add(
    sys.stdout,
    format="<green>{time:YYYY-MM-DD HH:mm:ss}</green> | <level>{extra[request_id]}</level> | <level>{level: <8}</level> | <cyan>{name}</cyan>:<cyan>{function}</cyan>:<cyan>{line}</cyan> - <level>{message}</level>",
    level="DEBUG",
    colorize=True,
)

# 3. 输出日志
logger.bind(request_id="abc-123", user="admin").info("开始处理请求")

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
  • logger.add
    • 参数1:配置日志输出方式,通常为sys.stdout或文件路径
    • 参数format: 配置日志输出格式
    • 参数level: 配置日志级别
      • TRACE:跟踪级别
      • DEBUG:调试级别
      • INFO:信息级别
      • SUCCESS:操作成功级别
      • WARNING:警告级别
      • ERROR:错误级别
      • CRITICAL:严重错误级别
  • logger.bind:绑定额外的自定义信息
  • logger.info:输出INFO级别的消息

日志配置

日志配置什么时候做?

在系统启动的时候完成配置,同时由于使用了日志系统,因此uvicorn的错误信息不再打印到控制台

配置什么?

生产环境:

  • 输出方式:固定为stdout,方便后期和云服务日志系统对接
  • 输出级别:通过环境变量配置
  • 输出格式:统一为JSON,方便云服务日志系统解析

开发环境:

  • 输出方式:

    • 固定为stdout,打印到控制台

      对于错误日志,还要额外输出到文件

  • 输出级别:通过环境变量配置

  • 输出格式:统一为纯文本,方便人类阅读

日志输出

输出什么?

共同数据:

  • message:错误消息
  • duration_ms:某个操作执行的时间(毫秒)

差异数据:

  • 请求日志:method、path、status_code、client_ip
  • 数据库日志:sql、params
  • 业务日志:action、entity、entity_id

可以使用类结构约定字段

在哪里输出?

请求日志

使用请求中间件

  1. 请求到达后:
    1. 记录请求id到上下文,使得该请求链条中的所有日志都可以拿到该id
    2. 创建请求日志对象
    3. 将日志对象放置到request.state.request_log中,方便其他地方获取日志对象
  2. 请求成功:log.success()
  3. 请求失败
    1. 进入handler的处理逻辑
    2. 该写message
    3. 500错误输出error,其他错误输出warning

数据库日志

注册SQLAchemy事件监听器,执行SQL前计时,执行后创建日志对象

对于一些慢查询(超过环境变量的阈值),输出warning级别的日志

业务日志

通常不会全量的记录业务日志。

业务日志既可以统一处理,也可以灵活处理。

统一处理:使用装饰器,见business_log.py:service_logger

评论
0/100
0/100
0/100
0/250
暂无评论