Flask应用需通过FlaskInstrumentor().instrument_app(app)启用OpenTelemetry TraceID自动注入，手动配置W3C header传播、重命名span、日志注入otelTraceID/otelSpanID，并确保tracer_provider.shutdown()注册以防止span丢失。

Flask 应用如何自动注入 OpenTelemetry TraceID

默认情况下，Flask 请求不会携带或生成 trace_id，必须显式启用中间件并配置上下文传播。OpenTelemetry 的 FlaskInstrumentor 是最轻量、兼容性最好的方案，但它不自动透传 HTTP header 中的 traceparent —— 除非你手动调用 set_span_in_context() 或启用 W3C 格式解析。

• 安装必需组件：pip install opentelemetry-instrumentation-flask opentelemetry-exporter-otlp-proto-http
• 初始化时必须调用 FlaskInstrumentor().instrument_app(app)，仅 instrument() 不生效（它只 patch 全局 Flask 类）
• 若后端是 Jaeger 或 Zipkin，导出器要换为 OTLPSpanExporter(endpoint="http://localhost:4318/v1/traces", protocol="http/protobuf")，不是 http/json
• 跨服务调用时，Flask 视图里用 requests.get(url, headers=dict(request.headers)) 不够 —— 要用 trace.get_current_span().get_span_context() 提取并注入 traceparent header

为什么 Flask + OpenTelemetry 的 span 名称总是 "HTTP GET"

这是 FlaskInstrumentor 的默认行为：它把所有请求统一标记为 HTTP {method}，不体现路由或视图函数名。想区分不同接口的性能瓶颈，必须手动重命名 span。

• 在视图函数内获取当前 span：span = trace.get_current_span()
• 设置有意义的名称：span.update_name("user_profile_api")（注意不是 span.name = ...）
• 更稳妥的做法是用 @with_tracing 装饰器封装，避免每个视图都写重复逻辑
• 不要在 before_request 中设 span 名 —— 此时 span 尚未创建，get_current_span() 返回 NonRecordingSpan

如何让日志行自动带上 trace_id 和 span_id

Python logging 默认不感知 OpenTelemetry 上下文，trace_id 不会自动出现在 %(message)s 里。得靠 LoggerProvider + 自定义 LogRecord 注入，或者更简单的——用 otel-python 提供的 LoggingHandler。

Flask Wrap

火焰围攻 授权: q15040409-creator.功能概述火焰围攻 授权: q15040409-creator.是一项面向实际任务的技能，主要用于Description.；Flask Web. - Python.；核心要点HTTP?；.Version.1.0.tags. wrap.github.automation.。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。使用与执行使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要

下载

• 先配置全局 logger：logging.getLogger().addHandler(OTLPLogHandler())
• 确保 OTEL_PYTHON_LOG_LEVEL 环境变量设为 INFO 或更低，否则日志被过滤
• 在 formatter 中加入 %(otelTraceID)s %(otelSpanID)s 即可输出（前提是 handler 支持这些 format key）
• 如果用 structlog，需注册 structlog.contextvars.bind_contextvars(otel_trace_id=trace.get_current_span().context.trace_id)，但要注意 contextvar 在异步视图中可能丢失

本地调试时看不到 span 数据？检查这三处

常见现象是代码全跑通、没报错，但 Jaeger UI 或 OTLP endpoint 里空空如也。问题往往不在 instrumentation，而在数据根本没发出去。

立即学习“Python免费学习笔记（深入）”；

• 确认 OTEL_EXPORTER_OTLP_ENDPOINT 指向的是 collector 的接收地址（如 http://localhost:4318），不是 UI 地址（如 http://localhost:16686）
• 检查 collector 是否真正运行：docker ps | grep otelcol，且其配置启用了 otlp receiver 和对应 exporter
• Flask 开发服务器（app.run()）默认不支持多线程 span 上下文传递，加 threaded=True 参数或改用 gunicorn 启动

OpenTelemetry 的链路追踪不是“装上就灵”，Flask 的生命周期短、中间件链松散，容易在 request context 销毁前漏掉 span flush。最常被忽略的是：atexit.register(lambda: tracer_provider.shutdown()) 必须存在，否则进程退出时未发送的 span 会静默丢弃。