分布式追踪模式生成器Skill tracing-schema-generator

这是一个用于生成分布式追踪系统配置的技能工具,专门为OpenTelemetry框架设计,支持与Jaeger、Zipkin等主流追踪后端集成。它能自动化生成跨度定义、上下文传播配置、采样策略以及导出器设置,帮助开发团队快速构建微服务可观测性体系。关键词:分布式追踪,OpenTelemetry,Jaeger,Zipkin,微服务监控,可观测性,跨度定义,采样策略。

微服务 1 次安装 6 次浏览 更新于 2/26/2026

名称: 追踪模式生成器 描述: 为 OpenTelemetry 生成分布式追踪模式,集成 Jaeger/Zipkin 允许工具:

  • Bash
  • Read
  • Write
  • Glob

追踪模式生成器技能

概述

生成 OpenTelemetry 追踪模式,包括跨度属性定义、追踪上下文传播以及 Jaeger/Zipkin 集成配置。

能力

  • OpenTelemetry 追踪模式
  • 跨度属性定义
  • 追踪上下文传播 (W3C, B3)
  • Jaeger 集成
  • Zipkin 集成
  • 行李传播
  • 采样策略配置
  • 跨度命名约定

目标流程

  • 可观测性实施
  • 微服务解构

输入模式

{
  "type": "object",
  "required": ["services"],
  "properties": {
    "services": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "operations": { "type": "array" },
          "dependencies": { "type": "array" }
        }
      }
    },
    "propagation": {
      "type": "string",
      "enum": ["w3c", "b3", "jaeger"],
      "default": "w3c"
    },
    "backend": {
      "type": "string",
      "enum": ["jaeger", "zipkin", "tempo", "xray"],
      "default": "jaeger"
    },
    "options": {
      "type": "object",
      "properties": {
        "samplingRate": {
          "type": "number",
          "default": 0.1
        },
        "samplingStrategy": {
          "type": "string",
          "enum": ["always_on", "always_off", "trace_id_ratio", "parent_based"],
          "default": "trace_id_ratio"
        },
        "includeBaggage": {
          "type": "boolean",
          "default": true
        },
        "semanticConventions": {
          "type": "string",
          "enum": ["http", "db", "messaging", "rpc"],
          "default": "http"
        }
      }
    }
  }
}

输出模式

{
  "type": "object",
  "properties": {
    "spanDefinitions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "kind": { "type": "string" },
          "attributes": { "type": "array" },
          "events": { "type": "array" }
        }
      }
    },
    "propagationConfig": {
      "type": "object"
    },
    "samplerConfig": {
      "type": "object"
    },
    "exporterConfig": {
      "type": "object",
      "description": "Jaeger/Zipkin 导出器配置"
    },
    "instrumentation": {
      "type": "object",
      "description": "自动插桩配置"
    }
  }
}

使用示例

{
  kind: 'skill',
  skill: {
    name: 'tracing-schema-generator',
    context: {
      services: [
        {
          name: 'order-service',
          operations: ['createOrder', 'getOrder', 'updateOrder'],
          dependencies: ['inventory-service', 'payment-service']
        }
      ],
      propagation: 'w3c',
      backend: 'jaeger',
      options: {
        samplingRate: 0.1,
        samplingStrategy: 'trace_id_ratio'
      }
    }
  }
}