用途:为 Java 服务接入 OpenTelemetry 提供技能入口,按任务加载对应参考资料,每份参考自包含。
主要能力与用法:
- references/declarative-setup.md:用于通过声明式 YAML 配置 SDK,涵盖 Javaagent 启用、Spring Boot Starter、autoconfigure SDK、BOM、仅 agent 属性以及手动埋点入口点。
- references/sensitive-data-capture.md:用于了解 HTTP 埋点默认采集内容(查询字符串开启、请求头与参数关闭)、查询参数脱敏(sensitive-query-parameters)、请求头与 servlet 参数采集开关,以及 SQL 净化。
- 事实来源:YAML schema 细节需查阅 otel-declarative-config 技能所列上游来源。Java 特有事实可按资料给出的命令与地址获取,例如最新 BOM 与 Javaagent 版本命令:gh api repos/open-telemetry/opentelemetry-java/releases/latest -q '.tag_name' 和 gh api repos/open-telemetry/opentelemetry-java-instrumentation/releases/latest -q '.tag_name';也可查阅声明式配置文档、烟囱测试夹具、CHANGELOG、生成配置参考及 Spring Boot Starter 文档等 URL。
- 遥测查询:要了解某库或某埋点产生哪些 span、属性、指标与配置项,使用 OpenTelemetry Ecosystem Explorer,通过其 Markdown 索引与解析后的 JSON 获取,不应凭模型记忆作答。版本差异可查 versions.md 与版本 index JSON,同一 id 哈希不同即表示该埋点有变化。
适用场景:Java 服务可观测性接入、声明式配置、敏感数据采集与脱敏、埋点遥测细节与版本变更查询。
限制:本技能本身是导航入口,具体 schema 与版本事实需按指向上游来源获取;暂未提供完整代码示例与安装命令。