otel-instrumentation
Installation
SKILL.md
OpenTelemetry Instrumentation with Kopai
Emit wide events, then prove they are good.
A span is a wide event: one flat record carrying the full context of a unit of work. Kopai runs on localhost, so you never ship instrumentation on faith — you drive traffic through the app yourself and assert on what arrived. The loop is green when every assertion in validate-traces passes. Nothing here is finished while an assertion is red.
Branches
| You are… | Start at |
|---|---|
| Setting up a service that has no telemetry | Workflow step 1 below |
| Retrofitting OTel into an existing codebase | context-propagation first — it is ~60% of the work — then the workflow |
| Chasing data that isn't arriving | troubleshoot-no-data, then step 4 of the workflow |