Troubleshooting

Histrix

Permisos de carpeta — inicio de mes

Síntoma: El sistema falla al intentar escribir archivos. Suele pasar los primeros días del mes cuando Histrix intenta crear la carpeta del mes nuevo en el log.

Causa: La carpeta del mes se crea con el usuario equivocado y Histrix no tiene permisos de escritura. Cuando se usan cronstab de histrix.

Solución:

chown -R automata:automata database/cliente/log/año/mes
chmod -R 755 database/cliente/log/año/mes

Logs de Docker crecen demasiado — truncate manual

Síntoma: El servidor se queda sin espacio en disco. Al revisar, los logs del contenedor ocupan varios GB.

Causa: El contenedor se levantó sin configuración de rotación de logs, entonces Docker escribe en el mismo archivo sin límite.

Solución rápida — vaciar el log sin reiniciar el contenedor:

sudo truncate -s 0 $(docker inspect --format='{{.LogPath}}' histrix)

Reemplazar histrix por el nombre del contenedor que está ocupando espacio.

Solución definitiva — agregar rotación al docker-compose.yml:

services:
  histrix:
    image: ...
    logging:
      driver: "json-file"
      options:
        max-size: "50m"
        max-file: "5"

Con esto Docker mantiene máximo 5 archivos de 50MB cada uno (250MB total) y rota automáticamente. Aplicar a todos los contenedores nuevos para no tener que hacer el truncate manual de nuevo.

Mailgun

Error 250 — Clave SMTP incorrecta

Síntoma: Los emails no salen, en el log aparece código 250 o similar.

Causa: La clave SMTP de Mailgun está mal configurada en Histrix.

Solución: Verificar y corregir la clave en la configuración del cliente.