rockclaver/systemcraft

observability-instrumentation

Adds structured logging, metrics, tracing, and actionable alerts so financial systems are explainable in production. Use for hard-to-diagnose incidents, new money-moving paths, or drift/queue-depth/latency/failure-rate observability.

First seen Jun 11, 2026

Installation

$ npx skills add rockclaver/systemcraft --skill observability-instrumentation

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from rockclaver/systemcraft · top by installs.

npx skills add rockclaver/systemcraft

Browse all from rockclaver/systemcraft

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Also listed on

Alternate registries and mirrors of this skill.

Repository health

Default branch main
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,945 B
  • docs SUMMARY.md 270 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 5 installs

SKILL.md

Observability Instrumentation

Use when scale-readiness-review/resilience-patterns says "add a metric"; use debug-runtime to diagnose live failures.

Workflow

  1. Pick the path (payment, payout, settlement, reconciliation, hot endpoint); list the questions ops will ask (did X succeed, failure rate/p95, queue depth, reconciliation drift).
  2. Log: structured key-value/JSON, correlation id, stable business keys (transaction, account, idempotency key, provider ref, tenant) — never secrets/PANs/credentials; log decisions/transitions and call boundaries.
  3. Metrics via the repo's client:

- RED: Rate, Errors, Duration (histogram) for request-driven paths. - USE: Utilization, Saturation, Errors for resources (pools, workers, connections). - Domain signals: queue depth/age, settlement lag, retry counts, breaker state, reconciliation drift, idempotency-conflict rate. - Label by operation/outcome; bound cardinality.

  1. Trace: propagate context through jobs/queues/calls; span each external call with duration/status.
  2. Alert on symptoms users feel (error rate, latency, backlog, drift); SLO thresholds/burn rates; name cause and next step; delete unused alerts.
  3. Verify: trigger the path, confirm logs/metrics/traces appear and alerts fire on failure.

Guardrails

  • Do not log secrets, full card numbers, credentials, or unmasked PII.
  • Do not use unbounded label cardinality (raw ids, emails).
  • Do not rely on average latency; use histograms/percentiles.
  • Do not add alerts without an owner and a response action.
  • Do not over-instrument the hot path; sample where appropriate.