SuperAPI AI 工具集

otel-instrumentation

数据与分析

查看项目

更新于 10-15 22:14

技能介绍

用途:为应用接入 OpenTelemetry 并将数据发送到 Honeycomb,覆盖 SDK 配置、自定义埋点、采样与分层遥测。

主要能力:配置 OTLP 环境变量(OTEL_SERVICE_NAME、OTEL_EXPORTER_OTLP_ENDPOINT、OTEL_EXPORTER_OTLP_HEADERS 等);选择协议(默认 http/protobuf,可选 grpc、http/json);设置信号专用端点;在自动埋点 span 上添加业务属性;创建自定义 span;用计时属性记录子操作耗时;通过 Logs API 发送异常事件并设置 span 状态;配置头部采样(OTEL_TRACES_SAMPLER)或尾部采样(Refinery、Collector tail_sampling);结合 trace、metrics、logs 分层遥测。

使用方式:设置必需环境变量后初始化对应语言 SDK;自定义埋点使用 tracer.Start、start_as_current_span、startActiveSpan 等 API;异常事件使用 Logs API 并包含 exception.type、exception.message、exception.stacktrace 等字段。各语言完整示例见技能内 references 文件。

适用场景:HTTP 服务、数据库查询、外部 API 调用、消息队列、业务逻辑事务等需要可观测性的系统。

限制:缺少 x-honeycomb-team 头会导致 Honeycomb 静默拒绝请求;采样会降低稀有错误可见性;span 过多或过少都会影响可观测效果;测试用 span 需移除;异常字段提升为可选兼容层,非默认行为。