Le preguntamos a gemini, la inteligencia artificial de Google, cómo resolver problemas de GoAlert en linux
Explicanos detalladamente cómo resolver problemas de GoAlert en linuxPara diagnosticar y resolver fallos en GoAlert sobre un entorno Linux, es necesario revisar de forma metódica el estado del servicio en systemd, los registros de eventos (logs), la conectividad con la base de datos PostgreSQL y la capa de proxy inverso (Nginx).
1 1. Verificar el Estado del Servicio y Registros en Tiempo Real
Comprobar estado y logs de systemd
Si GoAlert no responde o el servicio se detiene de forma imprevista, el primer paso es consultar el estado del demonio y los registros generados en el journal:
Comprueba si el servicio se encuentra activo:
Bash
sudo systemctl status goalert
Analiza las últimas líneas del registro para identificar excepciones o errores fatales al iniciar:
Bash
sudo journalctl -u goalert -n 100 --no-pager
Verification: El comando systemctl status debe reportar Active: active (running) y el journal no debe mostrar bucles de reinicio (Restarting).
2 2. Diagnosticar Fallos de Conexión a la Base de Datos
Errores de conexión con PostgreSQL
Un error común al actualizar o reiniciar GoAlert es la pérdida de comunicación con la base de datos PostgreSQL, lo cual impide que el binario levante el servidor HTTP.
Valida que el servicio de PostgreSQL esté activo y escuchando conexiones locales:
Bash
sudo systemctl status postgresql
Revisa la cadena de conexión configurada en el archivo de entorno (/etc/goalert/goalert.env):
env
GOALERT_DB_URL=postgres://goalert:TuPasswordSeguraBaseDatos@localhost:5432/goalert?sslmode=disable
Comprueba manualmente la conectividad utilizando la herramienta psql:
Bash
psql -h localhost -U goalert -d goalert -c "SELECT version();"
Verification: La consola debe retornar la versión activa de PostgreSQL sin solicitar contraseñas erróneas ni arrojar errores de tiempo de espera (Connection refused).
3 3. Corregir Problemas con el Proxy Inverso (Nginx)
Puerto HTTP local
Si el servicio de GoAlert corre correctamente pero la página web arroja un error 502 Bad Gateway, el proxy inverso no se está comunicando con el puerto interno de GoAlert.
Comprueba en qué puerto local está escuchando GoAlert (por defecto 8081):
Bash
sudo netstat -tulpn | grep goalert
# O alternativamente:
sudo ss -tulpn | grep 8081
Revisa el archivo de configuración de Nginx (/etc/nginx/sites-available/goalert.conf) para asegurarte de que el parámetro proxy_pass apunte exactamente al puerto correcto:
Nginx
location / {
proxy_pass http://127.0.0.1:8081;
...
}
Valida la sintaxis de Nginx y recarga el servicio:
Bash
sudo nginx -t && sudo systemctl reload nginx
Verification: El comando nginx -t debe confirmar que la sintaxis es correcta (syntax is ok) y el acceso por navegador web debe cargar la interfaz de inicio de sesión de GoAlert.
4 4. Analizar Errores de Envío de Alertas y Proveedores Externos
Depurar fallos en notificaciones (SMS/Llamadas)
Si GoAlert opera con normalidad pero los usuarios no reciben llamadas telefónicas, mensajes SMS o notificaciones:
Filtra los registros de systemd buscando eventos asociados a fallos de proveedores (como Twilio o pasarelas SMTP):
Bash
sudo journalctl -u goalert -g "twilio|smtp|error|failed" --no-pager
Asegúrate de que las credenciales de la API del proveedor de notificaciones estén actualizadas y vigentes en el panel de administración web de GoAlert bajo la sección Admin > Mental / Integrations o en las variables de entorno correspondientes.
Verification: Al disparar una alerta de prueba desde la interfaz web, el registro en vivo (journalctl -u goalert -f) debe mostrar una respuesta HTTP 200 o un acuse de recibo exitoso por parte de la pasarela externa.