SuperAPI AI 工具集

otel-java

部署与运维

查看项目

更新于 10-16 10:21

技能介绍

用途:为 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 与版本事实需按指向上游来源获取;暂未提供完整代码示例与安装命令。