开发与工程 ✓ Microsoft · 官方 javaazure-monitorapplication-insightsopentelemetrydistributed-tracingmetricstelemetry

Azure Monitor Java 遥测导出器

将 Java 应用的 OpenTelemetry 遥测数据发送到 Azure Monitor。

FollowSkills 评估 · FSRS-2.0
不推荐
44/ 100 五分制 2.2 / 5
1 2 3 4 5 6
1信任安全15 / 25 · 3.0/5

文档明确说明遥测会发送到 Azure Monitor/Application Insights,并使用连接字符串配置,未见恶意行为或过度权限要求;但未说明敏感属性过滤、数据保留、用户确认、网络出口控制或回滚方案,因此扣分。

2可靠稳定6 / 20 · 1.5/5

安装、初始化、Span、指标和异常处理路径描述较完整,但目标包已弃用,示例仍混用旧 exporter 包与 autoconfigure,版本写法包含 beta.x/LATEST,且没有针对该技能关键路径的专门测试或失败诊断,因此静态评分受限。

3适用触发8 / 15 · 2.7/5

面向 Java OpenTelemetry/Azure Monitor 场景,触发短语和迁移边界较清楚;但未充分说明不适用场景、运行时前置条件、依赖兼容性、中文支持或中国大陆网络可达性,因此扣分。

4规范维护7 / 15 · 2.3/5

包含 front matter、MIT 许可、版本、作者、安装步骤、分层示例、迁移说明和参考资料;但缺少明确维护责任、变更日志、稳定版本策略、故障排查、数据治理限制,且使用 LATEST 等不稳定依赖表达,因此扣分。

5有效结果5 / 15 · 1.7/5

可帮助用户理解遥测接入、创建 Span/指标及迁移方向,但目标包已弃用,部分示例可能与推荐包/API 不完全一致,且没有文件内可验证的实际输出或执行结果,预计仍需较多人工核验,因此扣分。

6证据核验3 / 10 · 1.5/5

提供 Maven、GitHub、迁移指南、OpenTelemetry 和 Application Insights 等可审计参考类别,但本次仅有静态文件证据,没有针对关键示例的提交测试、CI 结果或多来源复现证据,因此只能给有限分数。

证据充分度: 评估于 2026年7月20日 审查版本 9ccaf7c3704a
使用前请注意
  • 该技能针对已弃用包,迁移到 autoconfigure 应优先于照抄旧依赖。
  • 不要将真实连接字符串或敏感业务属性硬编码;应确认遥测数据、出口网络、保留策略和合规要求。
  • 示例中的 AzureMonitorExporter.customize、依赖版本及导入关系应在实际项目中按锁定版本和官方迁移指南核验。
  • 中国大陆网络、Azure 区域端点和企业出口策略未在文件中验证,部署前需单独确认可达性与合规性。
查看完整评分方法 →

这个 Skill 能做什么,适合哪些场景?

这是一项面向 Java 开发者的 Agent Skill,用于指导将 OpenTelemetry traces、metrics 和 logs 导出到 Azure Monitor 或 Application Insights。它涵盖 Maven 依赖、连接字符串、自动配置、创建和嵌套 spans、异常记录、span 属性、自定义 SpanProcessor 以及基础指标。该导出器包已被弃用,官方建议迁移到 azure-monitor-opentelemetry-autoconfigure。它适合维护旧集成或需要理解迁移路径的项目,不适合作为新项目的首选方案。

根据触发词提供 Java 配置示例:添加 Maven 依赖,使用 APPLICATIONINSIGHTS_CONNECTION_STRING 或显式连接字符串配置 OpenTelemetry,通过 AzureMonitorExporter.customize 接入 Azure Monitor;指导创建和结束 spans、设置属性、记录异常、建立父子 span 关系、注册自定义 SpanProcessor,并通过 OpenTelemetry 创建计数器和直方图。

  1. 维护使用 azure-monitor-opentelemetry-exporter 的 Java 应用,并需要确认现有遥测配置。
  2. 为 Java 服务添加 Application Insights 分布式追踪、指标和日志导出。
  3. 需要使用连接字符串初始化 OpenTelemetry 自动配置的 Java 开发者。
  4. 调试业务流程时,为 spans 增加订单、客户或请求等上下文属性。
  5. 需要记录异常、设置错误状态或通过 SpanProcessor 统一修改 spans 的工程团队。
  6. 将旧导出器集成迁移到 azure-monitor-opentelemetry-autoconfigure 的团队。

这个 Skill 有哪些优点和局限?

优点
  • 覆盖 traces、metrics 和 logs 导出到 Azure Monitor/Application Insights。
  • 提供连接字符串、自动配置、spans、属性、异常和指标的可复制 Java 示例。
  • 包含自定义 SpanProcessor、嵌套 spans 和迁移步骤。
  • 采用 MIT 许可,并由 Microsoft 发布。
局限
  • 目标导出器包已弃用,不能作为新项目的推荐长期方案。
  • 部分示例使用 `1.0.0-beta.x` 或 `LATEST` 占位符,不能直接视为固定生产版本。
  • 源材料没有提供该单项技能的平台测试结果或独立测试覆盖证据。
  • 导出遥测需要 Azure Monitor/Application Insights 连接字符串和网络访问。

如何安装这个 Skill?

安装整个仓库集合可运行 npx skills add microsoft/skills,再从向导中选择所需技能;README 说明技能会安装到所选 Agent 的目录,例如 .github/skills/。源材料没有提供该技能的独立安装命令。Java 项目中的旧依赖示例为 com.azure:azure-monitor-opentelemetry-exporter:1.0.0-beta.x,但新项目应使用 com.azure:azure-monitor-opentelemetry-autoconfigure

如何使用这个 Skill?

在支持 Agent Skills 的编码代理中使用触发词,例如 opentelemetry azure javaapplication insights java otelazure monitor tracing java。按照技能示例设置 APPLICATIONINSIGHTS_CONNECTION_STRING,或在 Java 中传入显式连接字符串,然后使用 AutoConfiguredOpenTelemetrySdkAzureMonitorExporter.customize 初始化。由于该包已弃用,应优先请求基于 autoconfigure 的实现或迁移方案。

这个 Skill 与同类方案有什么区别?

与已弃用的 azure-monitor-opentelemetry-exporter 相比,azure-monitor-opentelemetry-autoconfigure 是源材料明确推荐的替代方案,提供自动配置、常见库自动 instrumentation 和更好的 OpenTelemetry SDK 集成。

常见问题

这是新 Java 项目的推荐技能吗?
不是。源材料明确标记旧导出器包为弃用,并建议使用 azure-monitor-opentelemetry-autoconfigure。
需要哪些 Azure 配置?
需要 APPLICATIONINSIGHTS_CONNECTION_STRING 环境变量,或在初始化代码中提供显式连接字符串。
它会自动完成所有埋点吗?
该技能主要展示 OpenTelemetry 初始化、手动创建 spans、属性、异常、SpanProcessor 和指标。自动 instrumentation 被列为 autoconfigure 包的优势。
使用它是否需要 MCP 或特殊 Agent 工具?
源材料没有显示 MCP、Claude 专属扩展或 Codex 专属配置;它是包含标准 SKILL.md 前言的通用技能。

同仓库的其他 Skills

均来自 microsoft/agent-skills

开发与工程 ✓ Microsoft · 官方

Azure Monitor OpenTelemetry TypeScript

为 Node.js 应用接入 Application Insights 遥测。

开发与工程 ✓ Microsoft · 官方

Azure Monitor OpenTelemetry 导出器

为 Python 自定义 OpenTelemetry 管道提供发送遥测数据到 Application Insights 的低层导出能力。

开发与工程 ✓ Microsoft · 官方

Azure Monitor OpenTelemetry Python

用一行配置为 Python 应用接入 Application Insights 自动监控。

开发与工程 ✓ Microsoft · 官方

Application Insights Web 监控技能

为浏览器和 React Native 应用接入 Application Insights,实现用户行为、请求、异常与 GenAI 链路监控。

开发与工程 ✓ Microsoft · 官方

Azure Application Insights 插桩指南

为 Azure 上的 ASP.NET Core 和 Node.js Web 应用提供 Application Insights 遥测集成指导。

开发与工程 ✓ Microsoft · 官方

Azure Monitor 查询 Java 技能

用 Java 查询 Azure Monitor 日志与资源指标。

开发与工程 ✓ Microsoft · 官方

Azure Monitor 查询 Python 技能

帮助 Python 开发者查询 Azure Monitor 日志与指标。

开发与工程 ✓ Microsoft · 官方

Azure Monitor Java 日志摄取

帮助 Java 应用通过 DCR 将自定义日志发送到 Azure Monitor。

开发与工程 ✓ Microsoft · 官方

Azure Monitor 自定义日志采集

帮助 Python 编码代理通过 Logs Ingestion API 发送自定义日志。

自动化与运维 ✓ Microsoft · 官方

Azure 生产诊断

系统排查 Azure 生产故障,定位根因并提出安全的修复建议。

开发与工程 ✓ Microsoft · 官方

Azure Identity Java 认证助手

为 Java Azure 应用选择并配置安全的 Entra ID 凭据。

开发与工程 ✓ Microsoft · 官方

Azure AI 内容安全 Java 技能

帮助 Java 应用分析文本和图像中的有害内容并管理词表。

开发与工程 ✓ Microsoft · 官方

Azure 通信服务 SMS Java 技能

帮助 Java 应用通过 Azure 通信服务发送短信并处理投递结果。

开发与工程 ✓ Microsoft · 官方

Azure AI 持久化智能体 Java SDK

帮助 Java 开发者构建、运行和管理带线程、消息与工具的持久化 Azure AI 智能体。

开发与工程 ✓ Microsoft · 官方

Azure AI 异常检测 Java 技能

帮助 Java 开发者使用 Azure AI Anomaly Detector 构建单变量和多变量时间序列异常检测应用。

开发与工程 ✓ Microsoft · 官方

Azure Cosmos DB Java 开发技能

帮助 Java 开发者构建具备分区、全球分布与响应式访问能力的 Cosmos DB 应用。

开发与工程 ✓ Microsoft · 官方

Azure App Configuration Java 技能

指导 Java 应用集中管理配置、功能开关与发布快照。

开发与工程 ✓ Microsoft · 官方

Azure Application Insights .NET 资源管理技能

用 .NET 管理 Application Insights 资源、可用性测试和监控工作簿。

开发与工程 ✓ Microsoft · 官方

Azure Event Hubs Java 开发技能

帮助 Java 开发者构建高吞吐、可 checkpoint 的 Azure 事件流应用。

开发与工程 ✓ Microsoft · 官方

Azure CallingServer Java 遗留维护技能

帮助 Java 开发者维护旧版 CallingServer 代码并迁移到 Call Automation。

相关 Skills