Le preguntamos a Gemini, la inteligencia artificial de Google cómo solucionar problemas de Zammad en Linux
Expolicanos detalladamente cómo solucionar problemas de Zammad en LinuxSi Zammad es el "Ferrari" de los sistemas de tickets, sus averías suelen ser más complejas que cambiarle el aceite a un motor PHP. Al depender de Ruby on Rails, Elasticsearch y Redis, el diagnóstico requiere mirar varios frentes a la vez.
Aquí tienes el manual de rescate para cuando tu Zammad decida "tomarse el día libre".
1. El Primer Paso: ¿Quién se ha caído?
Antes de tocar código, verifica el estado de los "cuatro pilares" de Zammad.
Bash
# Verificar los servicios principales
sudo systemctl status zammad
sudo systemctl status elasticsearch
sudo systemctl status postgresql
sudo systemctl status redis-server
El "502 Bad Gateway" (El clásico)
Si ves este error en el navegador, Nginx está vivo, pero Zammad no responde.
Causa común: Zammad tarda mucho en arrancar (hasta 2 minutos en servidores lentos).
Solución: Dale tiempo. Si persiste, revisa si el servicio zammad-web falló: sudo systemctl restart zammad-web.
2. Los Logs: Donde Zammad confiesa sus pecados
Si el servicio dice que está "active", pero algo no funciona, los logs te dirán la verdad.
Log Principal (Errores de aplicación): /var/log/zammad/production.log
Log del Planificador (Tareas de correo): /var/log/zammad/scheduler.out
Log de Nginx (Errores de conexión): /var/log/nginx/zammad.error.log
Truco de experto: Usa tail -f /var/log/zammad/production.log mientras intentas reproducir el error en el navegador para ver el fallo en tiempo real.
3. Problemas con la Búsqueda (Elasticsearch)
Si buscas un ticket y no aparece nada, o recibes un error al buscar, el culpable es Elasticsearch.
Síntoma: "Search index not updated"
Verifica que corra en el puerto 9200: curl -X GET http://localhost:9200
Re-indexar todo: A veces el índice se corrompe o se desincroniza. Ejecuta:
Bash
sudo zammad run rails r 'search:reindex'
Esto puede tardar varios minutos si tienes miles de tickets.
4. El "Traga-RAM": Errores de Memoria
Zammad y Elasticsearch son devoradores de memoria. Si tu servidor tiene 4GB o menos, el sistema operativo puede matar procesos aleatoriamente (OOM Killer).
Diagnóstico: Revisa dmesg | grep -i kill. Si ves menciones a Ruby o Java, te has quedado sin RAM.
Solución rápida: Crea o aumenta el archivo de Swap (memoria virtual):
Bash
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
5. El Correo no llega o no sale
Si los tickets no se crean desde emails, el Scheduler (Planificador) suele estar bloqueado.
Reiniciar el planificador: sudo systemctl restart zammad-worker
Forzar limpieza de tareas: A veces una tarea de correo se queda "atascada" y bloquea las demás. Puedes limpiar el estado del procesador de fondos desde la consola de Rails:
Bash
sudo zammad run rails c
# Dentro de la consola:
Delayed::Job.delete_all
exit
Tabla de Referencia de Errores
Zammad es una pieza de software increíble, pero es muy sensible a las actualizaciones de sistema. Si haces un apt upgrade y se actualiza Elasticsearch o Ruby, es muy probable que algo se rompa. Mi recomendación: Siempre haz un snapshot o backup antes de actualizar.
¿Te gustaría que te ayudara a crear un script de monitoreo que te avise si Elasticsearch se detiene o prefieres que veamos cómo optimizar el rendimiento para que no consuma tanta RAM?
Configurar alertas de salud
Optimizar consumo de RAM
Backup y recuperación ante desastres
Configurar Webhooks de aviso
¿Cuál de estos puntos te ayudaría más a dormir tranquilo?