server-debug

Analyze FastAPI JSON server logs to identify startup failures and resilience issues.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Auto-one-Family/Automation-One --skill server-debug
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: server-debug
Source: https://github.com/Auto-one-Family/Automation-One/tree/main/.claude/skills/server-debug
Command: npx skills add https://github.com/Auto-one-Family/Automation-One --skill server-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured, repeatable approach to analyze FastAPI JSON logs and MQTT traces from the God-Kaiser server to find root causes of startup failures, error-code occurrences, resilience breaches, and WebSocket or database faults so teams can restore service faster.

Core Features & Use Cases

  • Startup sequence analysis: Detect missing security config, DB/MQTT connection failures, and incomplete scheduler or service initializations.
  • Resilience and circuit breaker triage: Identify circuit breaker state changes, offline-buffer flushes, and retry/timeouts correlated with error codes.
  • Exception and error-code mapping: Map log entries to the defined exception hierarchy and 5000-5699 error-code ranges for prioritized remediation.
  • Log-guided investigation: Produce grep patterns, request_id/MQTT correlation guidance, and specific health-endpoint checks for live triage and postmortem reports.

Quick Start

Analyze logs/server/god_kaiser.log for ERROR and resilience events and deliver a prioritized remediation checklist with correlated request_id traces.

Frequently Asked Questions about server-debug

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

FAQPage Schema
How do I analyze FastAPI JSON server logs for startup failures and error codes?▼

Analyze FastAPI JSON server logs by parsing startup sequences, mapping error codes, and tracing MQTT handler faults to identify missing security config or database connection failures and produce a prioritized remediation checklist.

How do I diagnose MQTT handler faults and circuit breaker state changes in FastAPI logs?▼

Diagnose MQTT handler faults and circuit breaker state changes by correlating log entries with offline-buffer flushes, retry timeouts, and error-code ranges to pinpoint resilience breaches and generate targeted grep patterns for triage.

What is the best way to triage 5000-5699 error codes and exception hierarchies from server logs?▼

The best way to triage 5000-5699 error codes is mapping log entries to the defined exception hierarchy, prioritizing remediation by correlating request_id traces and health-endpoint checks for root-cause analysis.

Can I use Docker-mounted logs for root-cause analysis on God-Kaiser server instances?▼

Yes, you can use Docker-mounted logs for root-cause analysis by applying structured log analysis to God-Kaiser server instances, mapping log patterns to exception hierarchies and circuit breaker states for postmortem reporting.

How do I generate grep patterns and request_id traces for FastAPI log investigation?▼

Generate grep patterns and request_id traces by analyzing FastAPI JSON logs to map error codes and MQTT correlations, producing structured findings that guide live triage and specific health-endpoint checks for postmortem reports.

Why does my FastAPI server startup fail with database and MQTT connection faults?▼

FastAPI server startup failures occur due to missing security config, DB or MQTT connection failures, and incomplete scheduler initializations, detectable by analyzing JSON server logs for resilience breaches and error-code occurrences.