observability

Design privacy-safe logs, metrics, traces, and alerts for production changes.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/machenjie/rd-skills --skill observability-machenjie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observability
Source: https://github.com/machenjie/rd-skills/tree/main/src/foundation/capabilities/observability
Command: npx skills add https://github.com/machenjie/rd-skills --skill observability-machenjie

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures production changes come with privacy-safe, correlated telemetry so operators can quickly detect user impact, diagnose root cause, and validate remediation without drowning in noisy alerts.

Core Features & Use Cases

  • Production-grade signals: Design structured JSON logs, latency/traffic/error/saturation metrics, and distributed trace spans across boundaries.
  • Actionable alerting: Define threshold-based, owned alerts linked to runbooks and tuned to avoid alert fatigue.
  • SLI/SLO alignment: Establish user-impact SLI/SLO pairs and error budgets before release, with burn-rate alerting.
  • Correlation and privacy guardrails: Enforce W3C traceparent propagation and prohibit logging sensitive data or high-cardinality metric labels.

Quick Start

Use the observability capability to design logs, metrics, traces, dashboards, and alerts for a production change so you can detect user impact within minutes and investigate by correlating evidence across systems.

Frequently Asked Questions about observability

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design distributed tracing and structured logging for production APIs?

Design production observability by specifying privacy-safe structured JSON logs, golden-signal metrics, and distributed trace spans across boundaries. This correlated telemetry allows operators to detect user impact, diagnose root causes, and validate remediation without drowning in noisy alerts.

How do I set up SLI and SLO targets with burn-rate alerting before a release?

Establish user-impact SLI and SLO pairs with error budgets prior to release by defining burn-rate alerting. This approach ensures production changes come with actionable alerts linked to runbooks, enabling quick detection of user impact and preventing alert fatigue.

What is the best way to enforce W3C traceparent propagation and bounded metric label cardinality?

Enforcing W3C traceparent correlation propagation and bounded metric label cardinality ensures privacy-safe, correlated telemetry across distributed systems. This prevents logging sensitive data and avoids high-cardinality metric labels that cause noisy alerts and system performance degradation.

How do I create actionable alerting and runbooks for incident investigation?

Define threshold-based, owned alerts linked to runbooks and tuned to avoid alert fatigue for incident investigation. This actionable alerting strategy ensures operators can quickly detect user impact, diagnose root causes, and validate remediation during production releases.

Can I use this observability design for background jobs and queue consumers?

Yes, this observability design applies to HTTP APIs, background jobs, queue consumers, database queries, and external dependencies. It specifies privacy-safe structured logs, golden-signal metrics, and distributed traces to detect user impact within minutes during release and incident investigation.

Why do I need dead-man's-switch detection and dashboards for post-release validation?

Dead-man's-switch detection and dashboards support post-release validation by monitoring golden-signal metrics and validating remediation. They ensure production changes maintain observability standards, allowing operators to confirm system health and detect user impact continuously.