name: opentelemetry-integrator description: 为SDK集成OpenTelemetry追踪与指标 allowed-tools:
- 读取
- 写入
- 编辑
- 全局搜索
- 文本搜索
- Bash
OpenTelemetry 集成技能
概述
此技能将OpenTelemetry可观测性集成到SDK中，为API监控提供分布式追踪、指标收集和上下文传播。
能力
- 为SDK操作添加追踪跨度
- 导出指标（延迟、错误、吞吐量）
- 配置上下文传播（W3C追踪上下文）
- 支持多种导出器（OTLP、Jaeger、Zipkin）
- 实现自定义跨度属性
- 配置采样策略
- 为SDK操作添加语义约定
- 支持行李传播
目标流程
- 可观测性集成
- 遥测与分析集成
- 日志记录与诊断
集成点
- OpenTelemetry SDK（所有语言）
- Jaeger用于分布式追踪
- Prometheus用于指标
- Grafana用于可视化
- 云可观测性平台
输入要求
- 追踪要求
- 需收集的指标
- 导出器配置
- 采样策略
- 语义约定映射
输出产物
- OpenTelemetry 仪表化
- 自定义跨度定义
- 指标收集器
- 导出器配置
- 传播器设置
- 采样配置
使用示例
skill:
name: opentelemetry-integrator
context:
tracing:
enabled: true
propagator: w3c-trace-context
sampling: parentBased
sampleRate: 0.1
metrics:
enabled: true
exportInterval: 30s
metrics:
- sdk.request.duration
- sdk.request.count
- sdk.error.count
exporters:
traces: otlp
metrics: prometheus
serviceName: "my-sdk"
最佳实践
- 遵循OpenTelemetry语义约定
- 使用适当的采样率
- 跨边界传播上下文
- 包含有用的跨度属性
- 避免高基数属性
- 为生产环境配置导出器