Marketplace

instrumentation-planning

Plan backend observability using RED + USE + 4 Golden Signals + JTBD

$ 설치

git clone https://github.com/nexus-labs-automation/backend-observability /tmp/backend-observability && cp -r /tmp/backend-observability/skills/instrumentation-planning ~/.claude/skills/backend-observability

// tip: Run this command in your terminal to install the skill


name: instrumentation-planning description: "Plan backend observability using RED + USE + 4 Golden Signals + JTBD" triggers:

  • "what should I measure"
  • "what metrics do I need"
  • "observability plan"
  • "instrumentation strategy"
  • "which metrics matter" priority: 1

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 TypeUse
HTTP/gRPC APIsRED (Rate, Errors, Duration)
Resources (pools, memory)USE (Utilization, Saturation, Errors)
Comprehensive SRE4 Golden Signals

Prioritization Tiers

TierWhatExamples
T0: FoundationMust haveService tags, HTTP middleware, error tracking, health checks
T1: PerformanceShould haveRED per endpoint, DB tracing, external service spans, context propagation
T2: ResourcesShould haveUSE for pools, memory/GC, queue depth
T3: BusinessNice to haveJTBD tags, user tier, feature flags
T4: ResilienceNice to haveCircuit breaker state, retry counts, timeouts

JTBD Context

Link observability to user value:

JobSuccessFailureFriction
"Place order"Order created <2sOrder errorRetries >0, duration >5s
"Process payment"Payment successDeclinedGateway 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.md
  • references/methodology/use-methodology.md
  • references/methodology/four-golden-signals.md
  • references/methodology/jtbd-for-backend.md