使用方法
- 复制安装命令，在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物，并对照来源检查输出。
npx skills add https://github.com/sickn33/agentic-awesome-skills --skill distributed-tracing开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。
按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。
Distributed Tracing
When to Use
Trace a request across services, diagnose latency and error propagation, or add observable boundaries to a new integration.
Inputs and prerequisites
Record installed SDK and backend versions, permitted collector endpoints, the service graph and a staging request. Inspect the installed version's primary documentation before selecting exporter APIs or deployment configuration. This bundle does not install a tracing backend.
Procedure
- Read
resources/implementation-playbook.mdand identify one user journey. - Configure the matching OpenTelemetry SDK and OTLP exporter before loading instrumented frameworks. Use
references/instrumentation.mdfor propagation, shutdown and privacy checks. - Configure Jaeger using
references/jaeger-setup.md, or the existing Tempo/collector deployment's supported configuration. Review listeners, authentication, transport protection, storage and retention before any deployment. - Propagate context over HTTP and asynchronous messages. Use stable operation names and allowlisted attributes. Do not log credentials, raw request bodies or sensitive query values.
- Send successful and failing staging requests and verify connected spans in the backend. Record service identity, parentage, duration units and exporter errors.
- Measure queue loss and overhead. Select sampling based on those observations; no fixed percentage guarantees coverage or performance.
Example
A checkout calls inventory and payment. Verify that the root request and both downstream operations share a trace, that a simulated payment timeout is recorded, and that no card data is present. Repeat with exporter connectivity unavailable: request handling must retain the application's defined behavior.
Verification
- Actual trace evidence for each exercised boundary, including queue consumers.
- Allowed fields only; bounded attribute cardinality.
- Shutdown flush and exporter failure behavior observed.
- Access, storage and retention checked independently from UI availability.
Limitations
Head sampling can discard errors before tail sampling sees them. In-memory demos do not prove durable storage. Context propagation and cross-service clocks need actual integration tests; this guide is not a runnable multi-service application.
Sources
- OpenTelemetry exporter documentation — use the installed SDK's matching documentation.
