[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6NWQ7P2EZVC8JD06S5QTHHQ":3,"skill-same:01M6NWQ7P2EZVC8JD06S5QTHHQ":57},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":30,"linkOnly":31,"markdownContent":32,"markdownBody":33,"frontMatter":34,"refName":35,"commitSha":36,"skillDirectory":37,"forksCount":14,"repositoryHtmlUrl":38,"repositoryHomepageUrl":6,"ownerHtmlUrl":39,"ownerBlogUrl":40,"ownerDescription":41,"updatedAt":42,"install":43,"resources":56},"01M6NWQ7P2EZVC8JD06S5QTHHQ","tracing-patterns",null,"OpenTelemetry setup, span context propagation, sampling strategies, Jaeger queries","rubicanjr\u002FFinCognis","rubicanjr","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F234912519?v=4","01M6NT156NND8J474G34SB3923","Rubi","01M6NT15B70RWXE1N3YV0BZY8A",0,"MIT","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Ftracing-patterns\u002Fskill.md",[],[19,20,21,22,23,24,25,26,27,28,29],"tracing","patterns","tracing patterns","setup","OpenTelemetry","context","sampling","queries","strategies","propagation","jaeger","2026-11-10 10:12:30",false,"---\nname: tracing-patterns\ndescription: OpenTelemetry setup, span context propagation, sampling strategies, Jaeger queries\n---\n\n# Tracing Patterns\n\n## OpenTelemetry Setup (Node.js)\n\n```typescript\nimport { NodeSDK } from '@opentelemetry\u002Fsdk-node';\nimport { OTLPTraceExporter } from '@opentelemetry\u002Fexporter-trace-otlp-http';\nimport { getNodeAutoInstrumentations } from '@opentelemetry\u002Fauto-instrumentations-node';\nimport { Resource } from '@opentelemetry\u002Fresources';\nimport { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from '@opentelemetry\u002Fsemantic-conventions';\nimport { ParentBasedSampler, TraceIdRatioBasedSampler } from '@opentelemetry\u002Fsdk-trace-base';\n\nconst sdk = new NodeSDK({\n  resource: new Resource({\n    [ATTR_SERVICE_NAME]: 'order-service',\n    [ATTR_SERVICE_VERSION]: process.env.APP_VERSION || '1.0.0',\n    'deployment.environment': process.env.NODE_ENV || 'development',\n  }),\n  traceExporter: new OTLPTraceExporter({\n    url: process.env.OTEL_EXPORTER_OTLP_ENDPOINT || 'http:\u002F\u002Flocalhost:4318\u002Fv1\u002Ftraces',\n  }),\n  sampler: new ParentBasedSampler({\n    root: new TraceIdRatioBasedSampler(0.1), \u002F\u002F 10% sampling\n  }),\n  instrumentations: [getNodeAutoInstrumentations({\n    '@opentelemetry\u002Finstrumentation-fs': { enabled: false },\n  })],\n});\n\nsdk.start();\nprocess.on('SIGTERM', () => sdk.shutdown());\n```\n\n## Manual Span Creation\n\n```typescript\nimport { trace, SpanStatusCode, SpanKind } from '@opentelemetry\u002Fapi';\n\nconst tracer = trace.getTracer('order-service');\n\nasync function processOrder(orderId: string): Promise\u003COrder> {\n  return tracer.startActiveSpan('processOrder', {\n    kind: SpanKind.INTERNAL,\n    attributes: { 'order.id': orderId },\n  }, async (span) => {\n    try {\n      const order = await tracer.startActiveSpan('validateOrder', async (valSpan) => {\n        const result = await validateOrder(orderId);\n        valSpan.setAttribute('order.items_count', result.items.length);\n        valSpan.end();\n        return result;\n      });\n\n      await tracer.startActiveSpan('chargePayment', {\n        kind: SpanKind.CLIENT,\n        attributes: { 'payment.method': order.paymentMethod },\n      }, async (paySpan) => {\n        await chargePayment(order);\n        paySpan.addEvent('payment_charged', { 'payment.amount': order.total });\n        paySpan.end();\n      });\n\n      span.setStatus({ code: SpanStatusCode.OK });\n      return order;\n    } catch (error) {\n      span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });\n      span.recordException(error);\n      throw error;\n    } finally {\n      span.end();\n    }\n  });\n}\n```\n\n## Context Propagation (HTTP)\n\n```typescript\nimport { propagation, context } from '@opentelemetry\u002Fapi';\n\n\u002F\u002F Inject context into outgoing request\nfunction makeRequest(url: string, options: RequestInit = {}): Promise\u003CResponse> {\n  const headers: Record\u003Cstring, string> = {};\n  propagation.inject(context.active(), headers);\n  return fetch(url, {\n    ...options,\n    headers: { ...options.headers, ...headers },\n  });\n}\n\n\u002F\u002F Extract context from incoming request (middleware)\nfunction tracingMiddleware(req: Request, res: Response, next: NextFunction) {\n  const parentContext = propagation.extract(context.active(), req.headers);\n  context.with(parentContext, () => next());\n}\n```\n\n## Sampling Strategies\n\n```yaml\n# Head-based: Decide at trace start\nparent_based:\n  root: trace_id_ratio(0.1)   # 10% of new traces\n  # Child spans inherit parent decision\n\n# Tail-based (Collector config): Decide after trace complete\nprocessors:\n  tail_sampling:\n    policies:\n      - name: error-traces\n        type: status_code\n        status_code: { status_codes: [ERROR] }\n      - name: slow-traces\n        type: latency\n        latency: { threshold_ms: 1000 }\n      - name: baseline\n        type: probabilistic\n        probabilistic: { sampling_percentage: 5 }\n```\n\n## Jaeger Query Patterns\n\n```\n# Find slow traces for a service\nservice=order-service operation=processOrder minDuration=500ms\n\n# Find error traces\nservice=order-service tags={\"error\":\"true\"}\n\n# Cross-service trace\nservice=order-service operation=processOrder tags={\"order.id\":\"ORD-123\"}\n```\n\n## Checklist\n\n- [ ] Every service has OTEL SDK initialized before app code\n- [ ] Service name and version set in Resource attributes\n- [ ] Context propagation configured for all HTTP\u002FgRPC clients\n- [ ] Error spans have exception recorded and status set to ERROR\n- [ ] Sampling strategy defined (not 100% in production)\n- [ ] Span attributes follow semantic conventions\n- [ ] Sensitive data excluded from span attributes (no PII, passwords)\n- [ ] Graceful shutdown calls sdk.shutdown() to flush pending spans\n\n## Anti-Patterns\n\n- Sampling 100% of traces in production (storage explosion)\n- Not propagating context across async boundaries\n- Adding PII (emails, SSNs) as span attributes\n- Creating too many small spans (noise, overhead)\n- Not recording exceptions on error spans\n- Missing `span.end()` calls causing memory leaks\n- Using span names with high cardinality (e.g., including IDs)\n- Ignoring parent context in downstream services\n","# Tracing Patterns\n\n## OpenTelemetry Setup (Node.js)\n\n```typescript\nimport { NodeSDK } from '@opentelemetry\u002Fsdk-node';\nimport { OTLPTraceExporter } from '@opentelemetry\u002Fexporter-trace-otlp-http';\nimport { getNodeAutoInstrumentations } from '@opentelemetry\u002Fauto-instrumentations-node';\nimport { Resource } from '@opentelemetry\u002Fresources';\nimport { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from '@opentelemetry\u002Fsemantic-conventions';\nimport { ParentBasedSampler, TraceIdRatioBasedSampler } from '@opentelemetry\u002Fsdk-trace-base';\n\nconst sdk = new NodeSDK({\n  resource: new Resource({\n    [ATTR_SERVICE_NAME]: 'order-service',\n    [ATTR_SERVICE_VERSION]: process.env.APP_VERSION || '1.0.0',\n    'deployment.environment': process.env.NODE_ENV || 'development',\n  }),\n  traceExporter: new OTLPTraceExporter({\n    url: process.env.OTEL_EXPORTER_OTLP_ENDPOINT || 'http:\u002F\u002Flocalhost:4318\u002Fv1\u002Ftraces',\n  }),\n  sampler: new ParentBasedSampler({\n    root: new TraceIdRatioBasedSampler(0.1), \u002F\u002F 10% sampling\n  }),\n  instrumentations: [getNodeAutoInstrumentations({\n    '@opentelemetry\u002Finstrumentation-fs': { enabled: false },\n  })],\n});\n\nsdk.start();\nprocess.on('SIGTERM', () => sdk.shutdown());\n```\n\n## Manual Span Creation\n\n```typescript\nimport { trace, SpanStatusCode, SpanKind } from '@opentelemetry\u002Fapi';\n\nconst tracer = trace.getTracer('order-service');\n\nasync function processOrder(orderId: string): Promise\u003COrder> {\n  return tracer.startActiveSpan('processOrder', {\n    kind: SpanKind.INTERNAL,\n    attributes: { 'order.id': orderId },\n  }, async (span) => {\n    try {\n      const order = await tracer.startActiveSpan('validateOrder', async (valSpan) => {\n        const result = await validateOrder(orderId);\n        valSpan.setAttribute('order.items_count', result.items.length);\n        valSpan.end();\n        return result;\n      });\n\n      await tracer.startActiveSpan('chargePayment', {\n        kind: SpanKind.CLIENT,\n        attributes: { 'payment.method': order.paymentMethod },\n      }, async (paySpan) => {\n        await chargePayment(order);\n        paySpan.addEvent('payment_charged', { 'payment.amount': order.total });\n        paySpan.end();\n      });\n\n      span.setStatus({ code: SpanStatusCode.OK });\n      return order;\n    } catch (error) {\n      span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });\n      span.recordException(error);\n      throw error;\n    } finally {\n      span.end();\n    }\n  });\n}\n```\n\n## Context Propagation (HTTP)\n\n```typescript\nimport { propagation, context } from '@opentelemetry\u002Fapi';\n\n\u002F\u002F Inject context into outgoing request\nfunction makeRequest(url: string, options: RequestInit = {}): Promise\u003CResponse> {\n  const headers: Record\u003Cstring, string> = {};\n  propagation.inject(context.active(), headers);\n  return fetch(url, {\n    ...options,\n    headers: { ...options.headers, ...headers },\n  });\n}\n\n\u002F\u002F Extract context from incoming request (middleware)\nfunction tracingMiddleware(req: Request, res: Response, next: NextFunction) {\n  const parentContext = propagation.extract(context.active(), req.headers);\n  context.with(parentContext, () => next());\n}\n```\n\n## Sampling Strategies\n\n```yaml\n# Head-based: Decide at trace start\nparent_based:\n  root: trace_id_ratio(0.1)   # 10% of new traces\n  # Child spans inherit parent decision\n\n# Tail-based (Collector config): Decide after trace complete\nprocessors:\n  tail_sampling:\n    policies:\n      - name: error-traces\n        type: status_code\n        status_code: { status_codes: [ERROR] }\n      - name: slow-traces\n        type: latency\n        latency: { threshold_ms: 1000 }\n      - name: baseline\n        type: probabilistic\n        probabilistic: { sampling_percentage: 5 }\n```\n\n## Jaeger Query Patterns\n\n```\n# Find slow traces for a service\nservice=order-service operation=processOrder minDuration=500ms\n\n# Find error traces\nservice=order-service tags={\"error\":\"true\"}\n\n# Cross-service trace\nservice=order-service operation=processOrder tags={\"order.id\":\"ORD-123\"}\n```\n\n## Checklist\n\n- [ ] Every service has OTEL SDK initialized before app code\n- [ ] Service name and version set in Resource attributes\n- [ ] Context propagation configured for all HTTP\u002FgRPC clients\n- [ ] Error spans have exception recorded and status set to ERROR\n- [ ] Sampling strategy defined (not 100% in production)\n- [ ] Span attributes follow semantic conventions\n- [ ] Sensitive data excluded from span attributes (no PII, passwords)\n- [ ] Graceful shutdown calls sdk.shutdown() to flush pending spans\n\n## Anti-Patterns\n\n- Sampling 100% of traces in production (storage explosion)\n- Not propagating context across async boundaries\n- Adding PII (emails, SSNs) as span attributes\n- Creating too many small spans (noise, overhead)\n- Not recording exceptions on error spans\n- Missing `span.end()` calls causing memory leaks\n- Using span names with high cardinality (e.g., including IDs)\n- Ignoring parent context in downstream services\n",{"name":5,"description":7},"main","70e1c350500ee750987420bbae48837afa906b7e","skills\u002Ftracing-patterns","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis","https:\u002F\u002Fgithub.com\u002Frubicanjr","linktr.ee\u002Ffinanskodu","Industrial Engineer & CIO @FinansKodu. Architecting AI-driven financial agents and autonomous workflows. 🏗️ Building systems, not just prompts.","2026-06-09 13:50:15",{"source":8,"skillName":5,"commands":44,"prompt":54,"zipAvailable":55},[45,48,51],{"tool":46,"command":47},"npx","npx skills add rubicanjr\u002FFinCognis --skill tracing-patterns",{"tool":49,"command":50},"bunx","bunx skills add rubicanjr\u002FFinCognis --skill tracing-patterns",{"tool":52,"command":53},"pnpm","pnpm dlx skills add rubicanjr\u002FFinCognis --skill tracing-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Ftracing-patterns\u002Fskill.md",true,[],[58,79,88,106,136,155],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":69,"publishedAt":30},"01M6NWS9DAXJTADT4T5MB49X8W","workflow-router","Goal-based workflow orchestration - routes tasks to specialist agents based on user goals","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow-router\u002FSKILL.md",[64],{"categoryNo":65,"categoryName":66,"taxonomyType":67,"taxonomyTypeDesc":68},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[70,71,72,73,74,75,76,77,78],"workflow router","workflow","router","orchestration","goals","goal","user","workflow orchestration","tasks",{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":30},"01M6NWS3RETSC0SHP16HP66E14","wiring","Wiring Verification","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fwiring\u002FSKILL.md",[],[81,86,87],"verification","false",{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":97,"publishedAt":30},"01M6NWS0XW9CVQZBDA1EGW0TWC","websocket-patterns","Connection management, room patterns, reconnection strategies, message buffering, and binary protocol design.","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fwebsocket-patterns\u002Fskill.md",[94],{"categoryNo":95,"categoryName":96,"taxonomyType":67,"taxonomyTypeDesc":68},"01JBSEEDCAT000000000000015","视觉设计",[98,20,99,100,101,102,103,27,104,105],"websocket","websocket patterns","design","protocol","management","message","binary","connection",{"skillNo":107,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":110,"categories":111,"keywords":116,"publishedAt":30},"01M6NWRDQDX9ZNETAWRRMQWV52","visual-verdict","Screenshot comparison QA for frontend development. Takes a screenshot of the current implementation, scores it across multiple visual dimensions, and returns a structured PASS\u002FREVISE\u002FFAIL verdict with concrete fixes. Use when implementing UI from a design reference or verifying visual correctness.","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fvisual-verdict\u002FSKILL.md",[112,115],{"categoryNo":113,"categoryName":114,"taxonomyType":67,"taxonomyTypeDesc":68},"01JBSEEDCAT000000000000009","前端开发",{"categoryNo":65,"categoryName":66,"taxonomyType":67,"taxonomyTypeDesc":68},[117,118,119,120,121,122,123,124,125,126,127,128,129,100,130,131,132,133,134,135],"visual","verdict","visual verdict","ui","across","revise","comparison","correctness","implementing","for","fixes","dimensions","frontend","development","qa","screenshot","returns","use","frontend development",{"skillNo":137,"name":138,"nameZh":6,"description":139,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":140,"categories":141,"keywords":142,"publishedAt":30},"01M6NWR8HSNRS7MNDK2J02QYMN","verification-loop","Comprehensive verification system covering build, types, lint, tests, security, and diff review before a PR.","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fverification-loop\u002FSKILL.md",[],[143,144,86,145,146,147,148,149,150,151,152,153,154],"verification loop","loop","lint","review","security","pr","system","diff","build","tests","diff review","types",{"skillNo":156,"name":157,"nameZh":6,"description":158,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":159,"categories":160,"keywords":161,"publishedAt":30},"01M6NWR4HHSFR0VR5EXFRWA747","vector-db-patterns","Embedding strategies, ANN algorithms, hybrid search, RAG chunking strategies, and reranking for semantic search and retrieval.","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fvector-db-patterns\u002Fskill.md",[],[162,163,164,165,20,166,167,168,169,27,170,171,172,173,174,126,175,176],"vector db patterns","vector db","db","vector","semantic search","search","embedding strategies","algorithms","chunking","semantic","retrieval","embedding","Hybrid Search","hybrid","rag"]