Vibe Index
🎯

root-cause-analysis

🎯Skill

from kopai-app/kopai-mono

VibeIndex|
What it does

Performs root cause analysis by tracing, correlating, and investigating telemetry data across services to identify and debug production issues.

πŸ“¦

Part of

kopai-app/kopai-mono(2 items)

root-cause-analysis

Installation

pnpmRun with pnpm
pnpm install
pnpmRun with pnpm
pnpm dev
πŸ“– Extracted from docs: kopai-app/kopai-mono
Need more details? View full documentation on GitHub β†’
1Installs
-
AddedFeb 4, 2026
View on GitHubBack to Skills

Skill Details

SKILL.md

Analyze telemetry data for root cause analysis using Kopai CLI. Use when debugging errors, investigating latency issues, tracing request flows across services, or correlating logs with traces.

Overview

# Root Cause Analysis with Kopai

Guide for debugging production issues using telemetry data (traces, logs, metrics) via Kopai CLI.

Prerequisites

Ensure access to Kopai app backend.

Make sure the services are set up to send their OpenTelemetry data to Kopai.

See otel-instrumentation skill for setup.

RCA Workflow Summary

  1. Find error traces
  2. Get full trace context
  3. Correlate logs with trace
  4. Check related metrics
  5. Identify root cause

Rules

1. Workflow (CRITICAL)

  • workflow-find-errors - Find Error Traces
  • workflow-get-context - Get Full Trace Context
  • workflow-correlate-logs - Correlate Logs with Trace
  • workflow-check-metrics - Check Related Metrics

2. Patterns (HIGH)

  • pattern-http-errors - HTTP Error Debugging
  • pattern-slow-requests - Slow Request Analysis
  • pattern-distributed - Distributed Failure Tracing
  • pattern-log-driven - Log-Driven Investigation

Read rules/.md for details.

Tips

  1. Always use --json for programmatic analysis
  2. Pipe to jq for filtering/aggregation
  3. Start with errors, then trace backwards
  4. Check span Duration to find bottlenecks
  5. Correlate TraceId across traces, logs, metrics

References

  • [trace-filters](references/trace-filters.md) - Trace search filter options
  • [log-filters](references/log-filters.md) - Log search filter options
  • [metric-filters](references/metric-filters.md) - Metric search filter options

More from this repository1

🎯
otel-instrumentation🎯Skill

Simplifies OpenTelemetry instrumentation for distributed tracing, metrics, and logging across microservices and cloud-native applications