Troubleshooting: Issue Title
Symptoms
- Observable symptom 1
- Observable symptom 2
- Error message:
exact error text
Affected Services
- Service A
- Service B
Diagnosis
Step 1: Check service status
docker ps | grep service-name
Look for: [what to look for in output]
Step 2: Check logs
docker logs service-name --tail 100
Look for: [specific error patterns]
Step 3: Verify configuration
docker exec service-name env | grep CONFIG
Expected: [expected values]
Root Causes
Cause A: Description
Indicators:
- Specific log pattern
- Specific symptom
Resolution:
# Fix command
fix command here
Cause B: Description
Indicators:
- Different log pattern
- Different symptom
Resolution:
# Alternative fix
alternative fix here
Prevention
- Preventive measure 1
- Monitoring recommendation
- Configuration best practice