debug-buttercup

What problem does it solve?

This Skill helps diagnose and resolve issues within the Buttercup Cyber Reasoning System (CRS) running on Kubernetes, addressing common failure points like pod crashes, resource pressure, and service misbehavior.

Core Features & Use Cases

• Triage & Diagnosis: Quickly identify the root cause of failures using kubectl commands for pod status, events, and logs.
• Resource Monitoring: Analyze CPU, memory, and disk usage to pinpoint resource contention.
• Service-Specific Debugging: Provides targeted guidance for common issues with Redis, DinD, and various Buttercup services.
• Use Case: When multiple Buttercup pods in the crs namespace are in CrashLoopBackOff, this Skill guides you through checking Redis health, examining pod events, and analyzing logs to find the underlying cause, such as disk saturation or a Redis connection error.

Quick Start

Run the diagnose.sh script to collect a snapshot of the Buttercup CRS environment.