Python日志结构化输出核心是采用JSON等可解析格式替代纯文本，以提升ELK等平台采集效率与字段提取准确率；非结构化日志依赖正则匹配，易因格式变动或多语言混杂失效；推荐用python-json-logger库替换Handler实现轻量结构化，并规范字段设计（如@timestamp、trace_id、context/payload分离）、避免动态字段名；进阶可桥接OpenTelemetry实现日志与trace自动对齐。
Python日志结构化输出，核心是让每条日志变成可解析、可查询、易聚合的格式（如JSON），而不是纯文本。这能直接提升ELK、Loki、Datadog等分析平台的采集效率和字段提取准确率。
为什么非结构化日志难分析？
默认的
输出是字符串，例如：
"2024-05-20 10:32:15,123 - INFO - user_login - User alice logged in from 192.168.1.5"
这类日志需靠正则硬匹配提取字段，一旦格式微调（比如加个毫秒、换字段顺序），规则就失效；
多语言
/多服务日志混入时更易误判。
立即学习
“
Python免费学习笔记（深入）
”；
php版微信js-sdk支付接口类
php版微信js-sdk支付接口类
下载
用
js
onlogger 实现轻量结构化
推荐使用
库，它不侵入业务逻辑，只需替换 Handler：
安装：
配置示例：
输出效果（单行 JSON）：
关键字段设计建议
结构化不是只套 JSON，而是让字段语义清晰、便于下游过滤和统计：
必加 trace_id / request_id：关联一次请求的全链路日志
区分 context 和 payload：用户ID、订单号等归入 context 字段；HTTP body 或数据库返回内容应单独序列化为 payload 字段（避免 JSON 嵌套过深或字段爆炸）
避免动态字段名：不要用
，应统一为
时间统一用 ISO 8601 格式 + UTC 时区，字段名推荐
（兼容 Elasticsearch）
进阶：与 OpenTelemetry 日志桥接
若已接入 OpenTelemetry 追踪，可通过
直接将结构化日志发往 OTLP endpoint，自动携带 trace_id、span_id、资源属性（如 service.name）：
优势：无需手动注入上下文，日志天然与 trace 对齐
注意：确保日志 level 映射正确（如 Python 的 WARNING → OTel’s WARN）
适合中大型系统，对小项目略重，但长期维护成本更低
loggingpython-json-loggerpip install python-json-loggerimport logging
from pythonjsonlogger import jsonlogger
logger = logging.getLogger(name)
handler = logging.StreamHandler()
formatter = jsonlogger.JsonFormatter(
'%(asctime)s %(name)s %(levelname)s %(message)s %(funcName)s %(lineno)d',
rename_fields={'asctime': '@timestamp', 'name': 'logger', 'levelname': 'level'}
)
handler.setFormatter(formatter)
logger.addHandler(handler)
logger.setLevel(logging.INFO)
{"@timestamp": "2024-05-20T10:32:15.123", "logger": "__main__", "level": "INFO", "message": "User alice logged in", "funcName": "login_handler", "lineno": 42}
{"user_alice_status": "active"}{"user_id": "alice", "status": "active"}@timestampOTLPHandler