obs-observability-and-monitoring

Design observability plans for metrics, logs, traces, and alerts.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/FernanSuoza/AIDD-project-bootstrap --skill obs-observability-and-monitoring
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obs-observability-and-monitoring
Source: https://github.com/FernanSuoza/AIDD-project-bootstrap/tree/main/templates/skills/obs-observability-and-monitoring
Command: npx skills add https://github.com/FernanSuoza/AIDD-project-bootstrap --skill obs-observability-and-monitoring

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design and implement practical observability so teams can understand service behavior, detect regressions, and perform actionable operational responses without excess noise or sensitive data leakage.

Core Features & Use Cases

  • Signal selection and naming: choose the minimal set of traces, metrics, logs, and exemplars with stable, low-cardinality names and units.
  • Correlation and identity: ensure consistent service/resource identity across telemetry for tracing and root-cause analysis.
  • Alerting and dashboards: create actionable alerts, dashboard panels, and validation smoke checks tied to SLOs and operational runbooks.
  • Use Case: instrument a checkout flow with request latency, error rates, dependency spans, and a dashboard plus alerts for sustained error rate increases.

Quick Start

Run the obs-observability-and-monitoring skill for the current user story to produce a signal selection, naming conventions, and actionable alerting plan.

Frequently Asked Questions about obs-observability-and-monitoring

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

FAQPage Schema
How do I implement observability for a new backend service?

To implement observability, you need to select the minimal set of metrics, logs, and traces with stable, low-cardinality names, then create actionable alerts and dashboard panels tied to your service SLOs.

What is the best way to design actionable alerts without sensitive data leakage?

Design actionable alerts by tying them directly to SLOs and operational runbooks, selecting telemetry signals carefully to avoid excess noise while ensuring no sensitive data is exposed in logs or metrics.

How do I ensure consistent service identity across distributed traces and metrics?

Ensure consistent service identity by applying correlation standards across all telemetry, using standardized naming conventions for resources so traces and metrics can be joined for root-cause analysis.

How do I choose metrics and traces with low cardinality for monitoring?

Choose low-cardinality metrics by applying strict naming conventions and selecting the minimal necessary set of signals, preventing unbounded label growth while maintaining enough granularity for regression detection.

Can I use this approach to instrument a checkout flow with dashboards and alerts?

Yes, you can instrument a checkout flow by tracking request latency, error rates, and dependency spans, then configuring a dashboard and alerts for sustained error rate increases.

Why do I need validation smoke checks for my observability setup?

Validation smoke checks verify that your instrumentation actually emits the expected signals, ensuring your dashboards and alerts function correctly before relying on them for operational responses.