observability

📁 srstomp/pokayokay 📅 Jan 24, 2026
13
总安装量
13
周安装量
#24450
全站排名
安装命令
npx skills add https://github.com/srstomp/pokayokay --skill observability

Agent 安装分布

opencode 10
gemini-cli 10
github-copilot 10
codex 10
cursor 9
codebuddy 8

Skill 文档

Observability

Implement the three pillars of observability: logs, metrics, and traces.

The Three Pillars

Pillar Purpose Key Question
Logs Discrete events with context What happened?
Metrics Aggregated measurements How much/many?
Traces Request flow across services Where did time go?

Quick Pick

  • Debug specific request? → Logs + Traces
  • Alert on thresholds? → Metrics
  • Understand system health? → All three
  • Starting from zero? → Logs first, then metrics, then traces

Key Principles

  • Use structured logging (JSON) with correlation IDs across all services
  • Instrument the four golden signals: latency, traffic, errors, saturation
  • Define SLIs/SLOs before building dashboards or alerts
  • Alert on symptoms (user impact), not causes (CPU usage)

Quick Start Checklist

  1. Set up structured logger (Pino recommended for Node.js)
  2. Add request correlation IDs (middleware)
  3. Instrument key metrics (RED: Rate, Errors, Duration)
  4. Configure distributed tracing (OpenTelemetry)
  5. Create dashboards for golden signals
  6. Set up alerts with appropriate severity levels

References

Reference Description
logging-patterns.md Structured logging, log levels, Pino/Winston setup
metrics-guide.md Prometheus, counters/gauges/histograms, golden signals
tracing-basics.md OpenTelemetry, distributed tracing, span design
alerting-guide.md Alert design, SLIs/SLOs, severity levels, dashboards