Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

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 web no 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-data no puede escribirlo. ls -l storage/logs/ y, si es eso, chown 82:82 del fichero.

4. Servicios

ServicioComprobación
BDdocker compose ps db (healthy); docker compose logs --tail=50 db
Redisdocker compose exec redis sh -c 'redis-cli -a "$REDIS_PASSWORD" --no-auth-warning ping' → PONG
Meilisearchdocker compose logs --tail=50 meilisearch; si la búsqueda o el control de duplicados dan 500, ver Meilisearch
Colasdocker compose logs --tail=50 worker meta-worker; tras cambiar código, reinícialas
Announcedocker 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.