Python服务上报Trace到SkyWalking需装skywalking-python并设环境变量,Flask用@sw.entry装饰器,FastAPI需ASGI中间件,异步函数须用sw.async_trace包裹;Elastic APM须最早初始化、配置正确且网络可达,禁与SkyWalking混用。
Python服务怎么自动上报Trace到SkyWalking
直接装
并初始化即可,但默认不捕获 HTTP 框架(如 Flask/FastAPI)的入口请求,必须手动注册中间件或装饰器。
用
,别用旧版
(已弃用)
启动前设环境变量:
、
Flask 需加
装饰器在视图函数上;FastAPI 要自己写 ASGI 中间件,否则 root span 为空
异步函数(
)默认不支持,得用
显式包裹,不然子 span 全丢
Elastic APM 的 Python 客户端为什么收不到 Span
大概率是没启用自动 instrumentation,或者
启动时机太晚——它必须在所有框架导入前就初始化。
不能在
底部才调
,得放在最顶上,甚至比
还早
确认
和
环境变量已设置,后者默认是
,不是 9200
Flask 默认只捕获 request/response,DB 查询要额外装
或
,否则 ORM 调用不出 span
日志里出现
通常意味着网络不通或 Server 未开 intake API
两个 APM 同时接会冲突吗
会。两个 agent 都劫持
/
等底层模块,后加载的那个大概率覆盖前一个的 hook,导致部分链路断裂或数据重复上报。
绝对不要同时 import
和
—— 即使没初始化也危险
如果公司已用 SkyWalking 做基础设施监控,就别再塞 Elastic APM;反之亦然。混用只适合临时对比场景,且需用不同进程隔离
想做多后端上报?选一个作为主 agent,另一个用 OpenTelemetry SDK 手动导出,而不是拉两个 full agent
本地调试时 Trace 总是断掉一截
常见于开发机没连通 Collector,或用了 localhost 但容器/WSL 网络隔离导致地址不可达。
Python 3.14.3
微软官方的 Python 扩展,是 VS Code 安装量最高的扩展(209M+)。集成 IntelliSense(通过 Pylance)、调试(通过 Python Debugger)、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
下载
立即学习
“
Python免费学习笔记(深入)
”;
SkyWalking:检查
是不是写了
,Docker 内要用宿主机 IP 或
Elastic APM:
若指向
,WSL2 用户得换
Python 进程退出太快(比如 CLI 脚本),agent 来不及 flush 数据,加
或
用
测试 Collector 是否响应,返回 404 是正常,返回 Connection refused 就真连不上
最常被忽略的是 agent 初始化顺序和网络可达性——不是配置写错了,而是它根本没跑起来。先确认日志里有 “started” 字样,再查 trace ID 是否出现在 UI 里。
skywalking-pythonpip install skywalking-pythonskywalking-agentSW_AGENT_NAME=your-service-nameSW_AGENT_COLLECTOR_BACKEND_SERVICES=127.0.0.1:11800@sw.entry() async defsw.async_trace()elastic-apmapp.pyelasticapm.instrument()from flask import FlaskELASTIC_APM_SERVICE_NAMEELASTIC_APM_SERVER_URLhttp://localhost:8200elastic-apm[flask][sqlalchemy]"Failed to send metrics to APM Server"urllibrequestsskywalkingelasticapmSW_AGENT_COLLECTOR_BACKEND_SERVICESlocalhost:11800host.docker.internalELASTIC_APM_SERVER_URLhttp://localhost:8200http://host.docker.internal:8200atexit.register(elasticapm.flush)sw.cleanup()curl -v http://127.0.0.1:11800