Diagnóstico por capas
Cuando algo falla, mira de fuera hacia dentro: borde → web → app → servicios → datos. Casi siempre el fallo está en la primera capa que no responde.
1. Borde y red
Desde fuera de la máquina:
curl -sI https://tu-dominio/ | head -1 # ¿responde la web?
curl -s https://tu-dominio/announce/health/ping # ¿responde el announce?
- No responde nada: el borde (túnel de Cloudflare o tu proxy) o el puerto web (
HTTP_PORT). - Error 502/504: el borde llega a la máquina pero
webno contesta (mira el punto 2). - Todos los pares salen con la misma IP: el borde no pasa la cabecera de IP real (
REAL_IP_CABECERA).
2. Contenedores
docker compose ps # todo Up; healthy donde hay healthcheck
docker compose logs --tail=50 web # nginx
docker compose logs --tail=50 app # PHP-FPM y el entrypoint
make health # la comprobación de health_check.sh
Un contenedor que se reinicia en bucle casi siempre lo cuenta en las últimas líneas de su log.
3. Aplicación (Laravel)
tail -f storage/logs/laravel-$(date +%F).log # lo primero ante un error 500
docker compose exec -u www-data app php artisan about # versión, BD, caché, colas
docker compose exec -u www-data app php artisan queue:failed
Important
Un error 500 justo tras medianoche suele ser de permisos: el log del día lo creó root (el scheduler) y
www-datano puede escribirlo.ls -l storage/logs/y, si es eso,chown 82:82del fichero.
4. Servicios
| Servicio | Comprobación |
|---|---|
| BD | docker compose ps db (healthy); docker compose logs --tail=50 db |
| Redis | docker compose exec redis sh -c 'redis-cli -a "$REDIS_PASSWORD" --no-auth-warning ping' → PONG |
| Meilisearch | docker compose logs --tail=50 meilisearch; si la búsqueda o el control de duplicados dan 500, ver Meilisearch |
| Colas | docker compose logs --tail=50 worker meta-worker; tras cambiar código, reinícialas |
| Announce | docker compose logs --tail=50 announce |
5. Datos y disco
df -h # disco lleno = la BD se para y los logs dejan de escribirse
du -sh backups/* | sort -h # las copias son lo que más crece
Y el resultado de la última copia: backups/estado_backup.json.