Instrumentation planning
Skill nexus-labs-automation/backend-observability/skills/instrumentation-planning
Plan backend observability using RED + USE + 4 Golden Signals + JTBDFrom its SKILL.md
npx -y skills add nexus-labs-automation/backend-observability --skill instrumentation-planningAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
2.0 KB, as published. Nobody here has run it
Instrumentation Planning
"What job is this telemetry helping someone accomplish?"
Every metric/span should answer a job. If you can't name the job, don't add the telemetry.
Framework Selection
| Service Type | Use |
|---|---|
| HTTP/gRPC APIs | RED (Rate, Errors, Duration) |
| Resources (pools, memory) | USE (Utilization, Saturation, Errors) |
| Comprehensive SRE | 4 Golden Signals |
Prioritization Tiers
| Tier | What | Examples |
|---|---|---|
| T0: Foundation | Must have | Service tags, HTTP middleware, error tracking, health checks |
| T1: Performance | Should have | RED per endpoint, DB tracing, external service spans, context propagation |
| T2: Resources | Should have | USE for pools, memory/GC, queue depth |
| T3: Business | Nice to have | JTBD tags, user tier, feature flags |
| T4: Resilience | Nice to have | Circuit breaker state, retry counts, timeouts |
JTBD Context
Link observability to user value:
| Job | Success | Failure | Friction |
|---|---|---|---|
| "Place order" | Order created <2s | Order error | Retries >0, duration >5s |
| "Process payment" | Payment success | Declined | Gateway timeout |
Anti-Patterns
- Measure everything → Noise, cost, no signal
- High-cardinality labels → User IDs explode storage
- 100% sampling → Unnecessary overhead
- Missing context → Can't debug without job/step
Output
Present prioritized instrumentation plan organized by tier, with specific metrics and implementation order.
References
Load based on need:
references/methodology/red-methodology.mdreferences/methodology/use-methodology.mdreferences/methodology/four-golden-signals.mdreferences/methodology/jtbd-for-backend.md