Designs and reviews production observability using structured logging, NDJSON, metrics, SLIs and SLOs, distributed tracing, OpenTelemetry, dashboards, alerts, telemetry pipelines, redaction, retention, and cost controls. Use when instrumenting services, defining log schemas, correlating microservices, designing monitoring or alerting, reviewing telemetry cardinality, or diagnosing whether production signals can answer operational questions.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Observability
Design observability from operational questions and user-visible outcomes. Do
not add logs, metrics, or spans merely to satisfy a three-pillars checklist.
Each signal must support a diagnostic, reliability, security, or business
decision at an acceptable cost.
## Observability Contract
- Start with critical journeys, SLIs, SLOs, failure modes, and the questions an
operator must answer during an incident.
- Use metrics for bounded aggregate behavior, traces for request and dependency
paths, and logs for discrete events requiring detailed context.
- Emit structured logs. For container streams, prefer one JSON object per
physical line on `stdout` or `stderr`; let the platform collect and rotate
logs.
- Propagate W3C trace context across process boundaries and correlate logs with
valid trace and span identifiers when context exists.
- Keep metric labels and span names bounded. Never use user IDs, request IDs,
email addresses, raw URLs, or other unbounded values as metric labels.
- Treat telemetry as sensitive data. Minimize, classify, redact, retain, and
authorize it deliberately.
…
The line at the top of this page pins the label git:20260830.f3ab767, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_okeda3t7wb3kzw6e
GET https://markdownregistry.com/api/v1/resolve?ref=d-padmanabhan/agent-engineering-handbook/observability
GET https://markdownregistry.com/api/v1/blob/3798fd2224b2f902b991c21488c070852db003c58446ce31dad24130a1f5d609
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
d-padmanabhan/agent-engineering-handbook · skills/agents-sdk/SKILL.md · Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows…
d-padmanabhan/agent-engineering-handbook · skills/cloud-platforms/SKILL.md · Cloud platform best practices for AWS, Azure, GCP, and Cloudflare. Covers Zero Trust architecture, IAM patterns…
d-padmanabhan/agent-engineering-handbook · skills/cloudflare-email-service/SKILL.md · Send and receive transactional emails with Cloudflare Email Service (Email Sending + Email Routing). Use when building…
d-padmanabhan/agent-engineering-handbook · skills/cloudflare-waf-author/SKILL.md · Workflow for crafting Cloudflare WAF rules across all three authoring interfaces - Terraform (cloudflare_ruleset), the…
d-padmanabhan/agent-engineering-handbook · skills/cloudflare-workers-author/SKILL.md · Workflow for building production-grade Cloudflare Workers in TypeScript - bootstrap, bindings and storage choice…
ericrisco/rsc-harness · skills/observability/SKILL.md · Use when instrumenting a service from the inside so an incident can be explained from telemetry alone — wiring…
nahid-sparktales/agent-dispatcher · skills/devops/observability/SKILL.md · Instrument a service so the questions asked during an incident are answerable from data already being collected — rate…
rjmurillo/ai-agents · .claude/skills/observability/SKILL.md · Use when you say `query agent logs`, `find slow tool calls`, `show agent errors`, or `what to log`. Query and analyze…
rjmurillo/ai-agents · src/claude/skills/observability/SKILL.md · Use when you say `query agent logs`, `find slow tool calls`, `show agent errors`, or `what to log`. Query and analyze…
outlinedriven/odin-claude-plugin · plugins/odin-infra/skills/observability/SKILL.md · Use when adding telemetry, composing an observability surface, reviewing alerts, shipping a production feature, or…
