Python日志无法上报Sentry及Flask项目集成Sentry面包屑日志最优方案

结合你给出的代码，我猜你可能是在初始化环节没衔接好，导致INFO级别的日志没被捕获成面包屑。咱们直接上最优实现方案：

完整代码示例 #

import logging
import sentry_sdk
from sentry_sdk.integrations.flask import FlaskIntegration
from sentry_sdk.integrations.logging import LoggingIntegration
from flask import Flask

# 配置Sentry日志集成：INFO及以上作为面包屑，ERROR及以上作为事件上报
sentry_logging = LoggingIntegration(
    level=logging.INFO,
    event_level=logging.ERROR
)

# 初始化Sentry，同时集成Flask和日志配置
sentry_sdk.init(
    dsn="你的Sentry项目DSN",
    integrations=[
        FlaskIntegration(),  # 必须加这个，让Sentry感知Flask上下文
        sentry_logging       # 关联咱们配置好的日志集成
    ],
    traces_sample_rate=1.0  # 可选，开启性能监控用
)

app = Flask(__name__)
# 关键！把Flask的日志级别设为INFO，不然默认只记录WARNING及以上
app.logger.setLevel(logging.INFO)

@app.route("/test")
def test_route():
    # 这些INFO级别的日志会自动成为面包屑
    app.logger.info("用户进入了测试路由")
    app.logger.info("正在处理用户请求...")
    
    # WARNING级别同样会作为面包屑
    app.logger.warning("注意：当前请求参数可能存在问题")
    
    # 触发一个错误，Sentry会上报这个错误事件，同时附带上面所有面包屑
    raise RuntimeError("模拟一个服务器错误")

if __name__ == "__main__":
    app.run(debug=True)

解决你遇到的「仅记录WARNING级别面包屑」问题 #

你说用logging.info生成面包屑但没生效，大概率是这两个原因：

1. Flask默认日志级别是WARNING：所以INFO级别的日志根本没被Flask的日志记录器输出，自然不会被Sentry捕获。一定要加app.logger.setLevel(logging.INFO)。
2. 没把LoggingIntegration加入到Sentry初始化的integrations里：如果只是定义了sentry_logging但没传给sentry_sdk.init()，那你的配置等于白写。

额外小技巧 #

如果需要手动添加更自定义的面包屑（比如非日志类的上下文信息），可以用Sentry的API：

sentry_sdk.add_breadcrumb(
    category="user_action",
    message="用户点击了提交按钮",
    level="info"
)

内容的提问来源于stack exchange，提问作者Ugochukwu Odunukwe