design-observability

Design observability systems with SLI/SLOs, distributed tracing, and log aggregation.

12|1|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/wfukatsu/nexus-architect --skill design-observability
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-observability
Source: https://github.com/wfukatsu/nexus-architect/tree/main/skills/design-observability
Command: npx skills add https://github.com/wfukatsu/nexus-architect --skill design-observability

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a structured approach to designing observability systems, including SLI/SLO definitions and distributed tracing, ensuring comprehensive monitoring and alerting for complex systems.

Core Features & Use Cases

  • System Architecture Design: Create SLI/SLO definitions aligned with business KPIs.
  • Distributed Tracing: Design OpenTelemetry-based distributed tracing solutions.
  • Log Aggregation: Develop a log aggregation strategy for centralized management.
  • Metrics Design: Establish metrics using RED/USE methods for performance evaluation.
  • Alerting Design: Set up alerting mechanisms with thresholds and escalation policies.
  • ScalarDB Integration: Generate ScalarDB-specific metrics for transaction tracking.
  • Use Case: Design an observability system for a microservices architecture, ensuring that developers have the necessary insights to maintain service reliability.

Quick Start

Run the /architect:design-observability command to initiate the observability design process.

Frequently Asked Questions about design-observability

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

FAQPage Schema
How do I design an observability system with SLI/SLO definitions for microservices?

Design an observability system by creating SLI/SLO definitions aligned with business KPIs, ensuring comprehensive monitoring and alerting for complex microservices architectures using structured methodologies.

What is the best way to implement distributed tracing using OpenTelemetry?

Implement distributed tracing by designing an OpenTelemetry-based solution that tracks requests across services, providing deep visibility into transaction flows within complex distributed systems.

How do I establish metrics using RED and USE methods for performance evaluation?

Establish metrics using RED and USE methods to evaluate system performance comprehensively. The RED method monitors Rate, Errors, and Duration, while USE tracks Utilization, Saturation, and Errors of resources.

Can I generate specific metrics for tracking ScalarDB transactions?

Yes, you can generate ScalarDB-specific metrics for transaction tracking. This integration allows precise monitoring of transaction states and performance within your ScalarDB database environment.

How do I set up alerting mechanisms with thresholds and escalation policies?

Set up alerting mechanisms by defining specific thresholds and establishing escalation policies, ensuring that critical system anomalies trigger appropriate notifications to maintain service reliability.

Do I need a log aggregation strategy for centralized management in complex systems?

Yes, developing a log aggregation strategy is essential for centralized management in complex systems. It consolidates logs from multiple services into a single location for efficient searching and analysis.