Observability Design

Design observability strategies covering metrics, logging, tracing, alerting, and SLOs.

1|1|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/dtsong/claude-code-windows-setup --skill observability-design-dtsong
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Observability Design
Source: https://github.com/dtsong/claude-code-windows-setup/tree/main/skills/council/operator/observability-design
Command: npx skills add https://github.com/dtsong/claude-code-windows-setup --skill observability-design-dtsong

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the challenge of creating a comprehensive strategy for monitoring, alerting, and logging, ensuring systems are observable and incidents can be rapidly detected and resolved.

Core Features & Use Cases

  • Defines Observability Pillars: Establishes metrics, logs, and traces as core components.
  • Designs Metric Collection: Specifies metric taxonomy, naming conventions, and labeling strategies.
  • Plans Structured Logging: Outlines log levels, fields, and correlation ID propagation.
  • Designs Distributed Tracing: Details span naming, context propagation, and sampling.
  • Defines SLIs/SLOs: Sets reliability targets and error budget calculations.
  • Use Case: A startup needs to define how they will monitor their new microservices architecture, ensuring they can quickly identify and fix issues before they impact users.

Quick Start

Design an observability strategy for a new e-commerce service, including metrics, logging, tracing, and SLOs.

Frequently Asked Questions about Observability Design

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

FAQPage Schema
How do I design an observability strategy for microservices?

To design an observability strategy for microservices, establish core pillars encompassing metrics, structured logging, distributed tracing, alerting, and Service Level Objectives (SLOs) to ensure rapid incident detection and resolution.

What is the best way to define SLIs and SLOs for system reliability?

Defining SLIs and SLOs involves setting specific reliability targets and calculating error budgets. This establishes clear thresholds for system performance monitoring and incident management to maintain expected service quality.

How do I plan structured logging and distributed tracing?

Planning structured logging and distributed tracing requires outlining specific log levels, fields, and correlation ID propagation, alongside detailing span naming, context propagation, and sampling for comprehensive monitoring.

How do I design metric collection and alerting thresholds?

Designing metric collection and alerting involves specifying a metric taxonomy, naming conventions, and labeling strategies, while setting precise alert thresholds to promptly notify teams of performance anomalies.

When do I need a comprehensive observability strategy?

You need a comprehensive observability strategy when adopting new architectures like microservices, ensuring you can quickly identify and fix issues before they impact users and satisfying requirements for system reliability.

Does this approach cover dashboard requirements and incident management?

Yes, this approach covers dashboard requirements and incident management by defining observability pillars, SLI/SLO specifications, and alerting thresholds to facilitate rapid detection and resolution of system issues.