🔧 AML TROUBLESHOOTING

Známé problémy a jejich řešení.

🔴 PROBLÉM 1: Infinite Restart Loop (VYŘEŠENO)

Datum opravy: 2026-01-09

Symptomy: - PM2 restartuje každé 2 minuty - Health check timeouty - 278 restartů za 9 hodin

Root Cause: - Health monitor restartoval API během načítání sanctions databáze - Sanctions: 3.6M záznamů → načítání 5-10 minut - Monitor timeout 5s → viděl "not responding" → restart

Řešení: 1. Health endpoint vrací "status": "loading" během inicializace 2. Monitor akceptuje "loading" jako OK stav 3. Restart jen po 3+ consecutive failures 4. Timeout zvýšen z 5s na 10s

Ověření:

curl http://localhost:8093/health | jq .status
# Během načítání: "loading"
# Po načtení: "healthy"

🟡 PROBLÉM 2: SSL Certificate Error

Symptomy:

SSLError: Hostname mismatch for evidenceexekuci.cevre.cz

Řešení: ✅ Fallback scraper s --ignore-certificate-errors

Ověření:

# Module executions používá fallback
curl ... | jq '.modules.executions.source'
# Response: "FALLBACK"

🟡 PROBLÉM 3: 404 Not Found (ISIR, Justice)

Symptomy:

404 Client Error for url: https://isir.justice.cz/...

Řešení: ✅ Graceful degradation - vrací prázdný result

Není chyba - subjekt prostě není v databázi.

🟡 PROBLÉM 4: Rate Limiting

Symptomy:

429 Too Many Requests

Řešení: 1. Circuit breaker automaticky přepne na fallback 2. Cooldown period 5-30 minut 3. Fallback scraper obchází rate limits

🟢 PROBLÉM 5: Service Loading

Symptomy:

curl /health
{"status": "loading", "message": "Sanctions loading..."}

Řešení: Počkej 5-10 minut

První start po PM2 restart načítá 3.6M sanctions záznamů.

Monitorování:

pm2 logs aml-api | grep -i loading
# Uvidíš progress

🔧 DIAGNOSTIC PŘÍKAZY

# Status
curl http://localhost:8093/health | jq

# PM2 logy
pm2 logs aml-api --lines 50

# Health monitor logy
pm2 logs health_monitor --lines 50

# Restarty
pm2 list | grep aml-api
# Kontroluj sloupec "↺" (restart count)

🆘 EMERGENCY RESTART

# Stop vše
pm2 stop aml-api health_monitor

# Počkej 10 sekund
sleep 10

# Restart
pm2 restart aml-api health_monitor

# Monitor
pm2 logs aml-api health_monitor

---

Systém stabilní od: 2026-01-09 | Uptime: 99.9%+