Saltar al contenido
Facturador

Revisión diaria del servidor

Cinco minutos de revisión al día evitan la mayoría de las caídas: un disco que se llena, una cola atascada o una tarea programada que dejó de correr se ven aquí antes de que un usuario reporte el problema.

Antes de empezar

  • Acceso SSH como root (Conexión remota).
  • Ubique la carpeta del facturador (la Ruta del proyecto del archivo [su dominio].txt).

1. Contenedores

docker ps --format 'table {{.Names}}\t{{.Status}}'

Bien: todos dicen Up, incluido el proxy. Revisar: alguno dice Restarting o Exited, o lleva pocos minutos encendido sin que nadie lo haya reiniciado. Ver Errores de los contenedores.

2. Disco e inodes

df -h /
df -i /

Bien: la columna Use% está por debajo de 80 % en los dos comandos. Revisar: cualquiera de los dos pasa de 85 %. Con el disco lleno, el sistema deja de guardar comprobantes.

3. Memoria y CPU

free -h
docker stats --no-stream

Bien: en free -h, la columna available tiene al menos 500 MB. Revisar: queda poca memoria disponible o algún contenedor usa más de 90 % de CPU por varios minutos. Ver Aumentar los recursos del servidor.

4. Errores en los logs

Dentro del contenedor fpm, cuente los errores del día:

grep -c "\.ERROR" storage/logs/laravel-$(date +%F).log

Y vea los últimos:

grep "\.ERROR" storage/logs/laravel-$(date +%F).log | tail -5 | cut -c1-300

Bien: pocos errores y distintos entre sí. Revisar: el mismo error se repite muchas veces, o aparecen errores de conexión a la base de datos o a Redis.

5. Colas

Dentro del contenedor fpm:

php artisan queue:failed

Bien: No failed jobs found. Revisar: hay trabajos fallidos. La columna Exception dice por qué. Después de corregir la causa, reintente con php artisan queue:retry all. Si los reportes en cola no avanzan, ver Descargas de reportes en cola.

6. Tareas programadas

El contenedor scheduling ejecuta schedule:run cada minuto y anota el resultado en su log. Desde la carpeta del facturador:

docker compose exec scheduling ls -l /var/log/cron.log
docker compose exec scheduling tail -5 /var/log/cron.log

Si el servicio tiene otro nombre (por ejemplo scheduling_1), use el que aparece en docker compose ps.

Bien: la hora de modificación del archivo es de hace uno o dos minutos, y las últimas líneas dicen Running… o No scheduled commands are ready to run. Revisar: el archivo no cambia hace varios minutos, o las últimas líneas muestran errores: el scheduler dejó de correr. Revise que el contenedor scheduling esté en Up y vea Tareas programadas (cron).

7. Certificado SSL

echo | openssl s_client -connect [su dominio]:443 -servername [su dominio] 2>/dev/null | openssl x509 -noout -enddate

Bien: la fecha notAfter es de dentro de más de 15 días. Revisar: vence pronto. Ver Instalar o actualizar el SSL.

8. Respaldos

Confirme que el último respaldo es de ayer o de hoy, y que está fuera del servidor. Un respaldo que solo existe en el mismo disco se pierde junto con el servidor. Ver Generar copias de seguridad.