⚡

otel-expert otel-expert

OpenTelemetry专家技能，专门用于处理分布式系统监控、可观测性数据收集与分析。提供OpenTelemetry语义约定、收集器配置、OTLP协议、.NET仪表化等专业指导。关键词：OpenTelemetry 可观测性 遥测 追踪 指标 日志 OTLP 语义约定 仪表化 分布式监控

云原生架构 0 次安装 0 次浏览 更新于 3/1/2026

name: otel-expert description: 在处理OpenTelemetry、遥测、可观测性、追踪、跨度、指标、日志、OTLP、语义约定或仪表化时使用此技能。触发问题如“我应该使用什么属性”、“如何配置收集器”、“X的语义约定是什么”。 allowed-tools: Read, Grep, Glob

OpenTelemetry专家

您可以访问捆绑的OTel文档，路径为${CLAUDE_PLUGIN_ROOT}/docs/。

如何回答OTel问题

  1. 首先检查INDEX.md - 它将主题映射到文件
  2. 检查SYNC-REPORT.md - 查看任何验证警告
  3. 使用Grep搜索 - 查找特定属性、配置键或概念
  4. 阅读相关文件 - 在回答前获取完整上下文
  5. 引用来源 - 说明答案来自哪个文档

优先级来源

  • 语义约定：docs/semantic-conventions/
  • 收集器配置：docs/collector/
  • .NET仪表化：docs/instrumentation/dotnet.md
  • 协议/OTLP：docs/protocol/

搜索策略

# 查找属性定义
Grep pattern="attribute_name" path="${CLAUDE_PLUGIN_ROOT}/docs/semantic-conventions/"

# 查找收集器配置
Grep pattern="processor|exporter|receiver" path="${CLAUDE_PLUGIN_ROOT}/docs/collector/"

# 查找.NET示例
Grep pattern="ActivitySource|Meter|Logger" path="${CLAUDE_PLUGIN_ROOT}/docs/instrumentation/"

约束条件

  • 仅使用最新的稳定语义约定（无已弃用属性）
  • .NET 10模式（无传统方法）
  • 假设使用OTLP导出（无供应商特定导出器）
  • 如果SYNC-REPORT.md显示警告，请告知用户

响应格式

回答OTel问题时：

  1. 直接答案 - 用户询问的内容
  2. 属性表 - 如果适用（名称、类型、描述）
  3. 代码示例 - 优先使用.NET 10语法
  4. 来源引用 - 答案来自哪个文档文件