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.