AgentArea Troubleshooting Guide
🚨 Quick Diagnostics
Health Check Commands
Service Status Overview
| Service | Port | Health Check | Expected Response |
|---|---|---|---|
| Core API | 8000 | curl http://localhost:8000/health | {"status": "healthy"} |
| MCP Manager | 7999 | curl http://localhost:7999/health | {"status": "healthy"} |
| Traefik | 8080 | curl http://localhost:8080/api/rawdata | JSON response |
| Database | 5432 | Internal | Check via app logs |
| Redis | 6379 | Internal | Check via app logs |
| MinIO | 9000 | curl http://localhost:9000/minio/health/live | 200 OK |
🔧 Common Issues
1. Services Won’t Start
Symptoms
docker compose upfails- Services exit immediately
- Port binding errors
Diagnosis
Solutions
Port Conflicts:2. Database Connection Errors
Symptoms
- “Connection refused” errors
- Migration failures
- App can’t connect to database
Diagnosis
Solutions
Database Not Ready:3. Migration Issues
Symptoms
- Alembic migration errors
- “Revision not found” errors
- Database schema mismatches
Diagnosis
Solutions
Run Migrations:4. Module Import Errors
Symptoms
ModuleNotFoundError- Import path issues
- Python package not found