debug-stack

Correlate Docker container logs, database records, and Redis state to diagnose production failures.

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/michaelayoade/dotmac_crm --skill debug-stack
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-stack
Source: https://github.com/michaelayoade/dotmac_crm/tree/main/.claude/skills/debug-stack
Command: npx skills add https://github.com/michaelayoade/dotmac_crm --skill debug-stack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly identify why production requests fail or background jobs misbehave by correlating application container logs with the database records and Redis state.

Core Features & Use Cases

  • Docker log triage for root-cause signals: Pinpoint FastAPI tracebacks, Celery task exceptions, and scheduler (beat) scheduling issues by container and time.
  • Database verification of affected entities: Validate whether tickets, subscriber syncs, campaigns, and notification delivery records are stuck in unexpected statuses or contain failure reasons.
  • Redis cache/queue inspection: Detect rate-limiting counters, stale cache TTL problems, and Celery task state/queue backlogs that can amplify or mask app bugs.
  • Cross-reference diagnosis workflow: Combine evidence across Docker, DB, and Redis to produce an actionable root-cause narrative and next steps.

Quick Start

Diagnose a failing issue by asking the AI to guide you through Step 1 Docker log triage, then Step 2 database queries for the impacted IDs and statuses, and finally Step 3 Redis inspection for rate limits, cache freshness, and Celery/task backlog.

Frequently Asked Questions about debug-stack

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

FAQPage Schema
How do I debug FastAPI 500 errors in production using Docker logs and Redis?

Debug FastAPI 500 errors by triaging Docker container logs for tracebacks, verifying affected database records for stuck statuses, and inspecting Redis for rate_limit keys or stale TTL to produce a structured root-cause diagnosis.

Why are my Celery worker tasks failing and how can I trace the root cause?

Trace failing Celery worker tasks by inspecting Docker container logs for task exceptions, querying the database for impacted entities like campaigns or notifications, and checking Redis for Celery task state backlogs and queue issues.

What is the best way to diagnose Celery beat scheduling problems and missed tasks?

Diagnose Celery beat scheduling problems by reviewing Docker logs for scheduler issues, verifying database records for expected entity updates, and inspecting Redis for stale cache TTL or task queue backlogs that indicate missed executions.

How do I troubleshoot notification delivery failures and stuck subscriber syncs?

Troubleshoot notification delivery failures and subscriber syncs by cross-referencing Docker application logs with database records containing failure reasons, and checking Redis cache state for rate-limiting counters or synchronization blockages.

Can I use this production debugging approach for database anomalies and unexpected ticket statuses?

Yes, you can debug database anomalies and unexpected ticket statuses by querying relevant database entities for failure reasons, correlating findings with Docker container logs, and inspecting Redis cache freshness to isolate the root cause.

What are the limitations of correlating Docker logs with Redis and SQL for production debugging?

This production debugging approach requires targeted container log inspection, specific SQL queries for impacted entities, and Redis checks for rate limits and task state, meaning it relies on having accessible Docker, database, and Redis environments.