error-detective

Analyze distributed system error patterns to identify root causes and prevent cascades.

68|6|Updated Apr 16, 2020
One-click install
npx skills add https://github.com/zenobi-us/dotfiles --skill error-detective-zenobi-us
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: error-detective
Source: https://github.com/zenobi-us/dotfiles/tree/main/devtools/files/opencode/skills/error-detective
Command: npx skills add https://github.com/zenobi-us/dotfiles --skill error-detective-zenobi-us

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solves? Complex distributed systems generate vast amounts of error data, making it hard to identify root causes, predict failures, and prevent error cascades, leading to system instability and costly incidents.

Core Features & Use Cases

  • Error Pattern Analysis: Identifies frequency, time-based, service, and user impact patterns across distributed systems.
  • Log & Trace Correlation: Correlates errors across services, traces request flows, and analyzes causal chains to pinpoint root causes.
  • Predictive Prevention: Designs strategies for error prediction, proactive monitoring, and implementing circuit breakers to prevent future incidents.
  • Use Case: Your microservices architecture is experiencing a surge in '500 Internal Server Errors' across multiple services. Use this Skill to correlate logs, traces, and metrics, identify the underlying database connection pool exhaustion, and propose circuit breakers to prevent future cascades.

Quick Start

Use the error-detective skill to investigate a recent spike in 'connection refused' errors across your services, starting with log correlation and pattern analysis.

Frequently Asked Questions about error-detective

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

FAQPage Schema
How do I correlate errors across multiple services in a distributed system?

Error correlation across services traces request flows through distributed logs and traces to connect failures across service boundaries. Aggregate logs from all services by request ID or trace ID, then analyze timestamps and causal chains to identify which service failure triggered others, revealing whether the root cause is in a single service or a cascading interaction.

What's the best way to identify root causes in microservices incidents?

Root-cause discovery in microservices combines log aggregation, distributed tracing, and metrics analysis to reconstruct the causal chain of failures. Map service dependencies, correlate error timestamps across services, and assess which initial failure propagated downstream, then validate against metrics to confirm the trigger point.

How can I detect and prevent error cascades in my services?

Cascade prevention detects patterns where one service's failure spreads to dependent services. Analyze error frequency and timing across services, identify dependency chains, then implement circuit breakers at critical points and design monitoring rules to alert before cascades reach users.

Can I use log correlation to assess the business impact of errors?

Log correlation enables impact assessment by linking errors to affected users and business transactions. Correlate error logs with transaction IDs or user sessions to quantify how many users were affected, which features failed, and the duration of impact, informing incident severity and prioritization.

What patterns should I look for when analyzing distributed system errors?

Error pattern analysis identifies frequency trends, service-specific concentrations, time-based spikes, and user-impact clusters. Look for synchronized failures across services indicating a shared dependency, temporal correlations between services suggesting cascades, and anomalies that deviate from baseline behavior.

Do I need distributed tracing and log aggregation to find error root causes?

Distributed tracing and log aggregation are essential for root-cause analysis in multi-service architectures. Tracing connects request flows across services with microsecond precision, while log aggregation provides error context and timing; together they enable causal chain reconstruction that neither alone can reliably achieve.