Cómo monitorizar Odoo en producción: alertas, Zabbix y Grafana
Cómo monitorizar Odoo en producción: señales de alerta clave
Para monitorizar Odoo en producción necesitas configurar alertas de CPU y memoria del servidor, revisar los logs diariamente filtrando por niveles ERROR y CRITICAL, controlar que los tiempos de respuesta se mantengan por debajo de 3 segundos en operaciones clave, supervisar el estado de las integraciones externas y ejecutar mantenimiento periódico de PostgreSQL con VACUUM y REINDEX. Herramientas como Zabbix para monitorización de infraestructura y Grafana para dashboards visuales complementan la monitorización nativa de Odoo y proporcionan visibilidad completa del estado del ERP.
Odoo es el ERP que más PYMEs españolas están adoptando gracias a su flexibilidad, su modelo open source y su amplia cobertura funcional. Sin embargo, pasar de un Odoo recién instalado a un Odoo en producción con decenas de usuarios concurrentes, miles de registros y múltiples integraciones es un cambio radical que muchas empresas no gestionan correctamente.
Según la documentación oficial de Odoo, el 80 % de los problemas de rendimiento en producción se deben a consultas SQL no optimizadas y falta de monitorización proactiva (Odoo Documentation, Performance Optimization Guide). Un estudio de Panorama Consulting revela que el 56 % de las implementaciones de ERP experimentan interrupciones operativas durante el primer año en producción por falta de supervisión adecuada (Panorama Consulting, ERP Report 2024). El informe de Gartner sobre operaciones IT añade que las empresas con monitorización proactiva reducen el tiempo de inactividad no planificado en un 70 % respecto a las que operan de forma reactiva (Gartner, IT Operations Management Survey 2024).
Un Odoo lento o inestable no solo frustra a los usuarios: paraliza la facturación, retrasa los pedidos, corrompe datos de inventario y genera pérdidas económicas directas. La monitorización proactiva es la diferencia entre detectar un problema antes de que afecte al negocio y descubrirlo cuando los usuarios ya no pueden trabajar.
Señales de alerta que no debes ignorar
Tiempos de respuesta degradados
El indicador más evidente de un problema en Odoo es la lentitud. Si validar una factura tarda más de 3 segundos, generar un informe de ventas supera los 10 segundos o buscar un producto en el inventario se percibe como lento, hay un problema que requiere investigación inmediata.
Mide los tiempos de respuesta de las operaciones críticas de forma regular. Documenta los tiempos base cuando el sistema funciona correctamente para tener una referencia con la que comparar. Puedes usar la herramienta de desarrollo del navegador (pestaña Network en Chrome DevTools) para medir los tiempos de las peticiones HTTP a Odoo, o activar el modo debug de Odoo añadiendo ?debug=1 a la URL para obtener información adicional sobre las consultas ejecutadas.
Errores recurrentes en logs
Los logs de Odoo son la primera fuente de información ante cualquier problema. Odoo utiliza el módulo logging de Python con los siguientes niveles de gravedad:
- DEBUG: información detallada para desarrollo, no relevante en producción.
- INFO: eventos operativos normales como inicio de servicios o ejecución de crons.
- WARNING: situaciones anómalas que no interrumpen el servicio pero requieren atención.
- ERROR: fallos que impiden completar una operación concreta.
- CRITICAL: fallos graves que pueden provocar la caída del servicio.
Filtra los logs por módulo y nivel de gravedad con el siguiente comando:
grep -E "ERROR|CRITICAL" /var/log/odoo/odoo-server.log | grep "account\|stock\|sale" | tail -100
Un error aislado puede ser una anomalía. Un error que se repite sistemáticamente es un problema estructural que empeorará con el tiempo. Presta atención especial a errores de tipo TransactionRollbackError (bloqueos en PostgreSQL), MemoryError (falta de RAM) y ConnectionError (fallos de integraciones externas).
Consumo anómalo de recursos del servidor
Un servidor que mantiene la CPU por encima del 80 % de forma sostenida, la memoria RAM por encima del 90 % o el disco con menos del 15 % libre está al borde del fallo. Estos umbrales deben monitorizarse continuamente, no revisarse ocasionalmente.
Para una comprobación rápida desde la terminal del servidor:
# CPU y memoria en tiempo real
top -bn1 | head -20
# Espacio en disco
df -h
# Procesos de Odoo y su consumo
ps aux | grep odoo | grep -v grep
Crecimiento descontrolado de la base de datos
PostgreSQL, la base de datos de Odoo, puede crecer de forma descontrolada si no se gestionan correctamente los logs, los adjuntos y las tablas temporales. Una base de datos que pasa de 5 GB a 15 GB en un mes sin un aumento proporcional de la actividad indica un problema que debe investigarse.
Consulta el tamaño de las tablas más grandes para identificar el origen del crecimiento:
SELECT relname AS tabla,
pg_size_pretty(pg_total_relation_size(relid)) AS tamano
FROM pg_catalog.pg_statio_user_tables
ORDER BY pg_total_relation_size(relid) DESC
LIMIT 15;
Las tablas ir_attachment, ir_logging, mail_message y ir_sessions suelen ser las principales responsables del crecimiento inesperado.
Fallos en integraciones externas
Las integraciones con bancos, pasarelas de pago, terminales POS, plataformas de ecommerce y servicios de correo son puntos frecuentes de fallo. Un cambio en la API del proveedor, un certificado SSL expirado o un token de autenticación caducado puede romper silenciosamente una integración crítica sin que nadie se entere hasta que un usuario reporta el problema.
Workers y longpolling mal configurados
Odoo utiliza workers para gestionar las peticiones HTTP y un proceso de longpolling para las notificaciones en tiempo real (chat, actualizaciones de formularios). Una configuración incorrecta es causa frecuente de lentitud y caídas:
- Workers insuficientes: la fórmula recomendada es
(2 x CPU cores) + 1. Con 4 núcleos, configura 9 workers. - limit_memory_hard: establece el límite máximo de RAM por worker. Si un worker lo supera, se reinicia automáticamente. Un valor habitual es 2684354560 (2.5 GB).
- limit_time_real: tiempo máximo en segundos que un worker puede procesar una petición. Valor recomendado: 120 segundos.
- longpolling_port: debe estar configurado en un puerto separado (por defecto 8072) y gestionado por un proxy inverso como Nginx.
Comprueba la configuración activa en el archivo /etc/odoo/odoo.conf:
[options]
workers = 9
limit_memory_hard = 2684354560
limit_memory_soft = 2147483648
limit_time_real = 120
limit_time_cpu = 60
longpolling_port = 8072
Cómo configurar la monitorización paso a paso
Paso 1. Monitorización del servidor con Zabbix
Configura Zabbix para supervisar el servidor de Odoo 24/7 con alertas automáticas:
- CPU: alerta cuando supere el 80 % de uso sostenido durante más de 5 minutos.
- Memoria RAM: alerta cuando el uso supere el 85 %.
- Disco: alerta cuando el espacio libre baje del 20 %.
- Red: alerta ante latencia anormal o pérdida de paquetes.
- Servicios: verifica que los procesos de Odoo (workers + longpolling) y PostgreSQL están activos.
- Certificados SSL: alerta cuando falten menos de 30 días para la expiración.
Añade un item personalizado en Zabbix para monitorizar el número de workers activos de Odoo:
# Script para Zabbix UserParameter
UserParameter=odoo.workers,ps aux | grep "odoo.*--workers" | grep -v grep | wc -l
Paso 2. Revisión sistemática de logs de Odoo
Configura la rotación de logs con logrotate para evitar que crezcan indefinidamente:
# /etc/logrotate.d/odoo
/var/log/odoo/*.log {
daily
rotate 30
compress
delaycompress
missingok
notifempty
copytruncate
}
Establece una rutina de revisión:
- Diaria: revisa los errores de nivel CRITICAL y ERROR con el comando
grepmostrado anteriormente. - Semanal: analiza los warnings y busca patrones recurrentes. Presta atención a errores de cron jobs que no se ejecutan.
- Mensual: revisión completa con análisis de tendencias. Compara el volumen de errores con el mes anterior.
Para centralizar logs de múltiples servidores, utiliza herramientas como Graylog o ELK Stack que permiten buscar, filtrar y crear alertas sobre patrones específicos.
Paso 3. Monitorización de tiempos de respuesta
Establece un conjunto de operaciones críticas que se monitorizan activamente:
- Validar una factura de venta (objetivo: menos de 3 segundos).
- Generar el informe de ventas del mes (objetivo: menos de 10 segundos).
- Buscar un producto en el inventario (objetivo: menos de 2 segundos).
- Crear un pedido de compra (objetivo: menos de 3 segundos).
- Procesar una venta en el punto de venta (objetivo: menos de 2 segundos).
Documenta los tiempos base y configura alertas cuando se superen en más de un 50 %. Puedes crear un script de monitorización que mida los tiempos de respuesta de las URLs críticas de Odoo:
#!/bin/bash
# Medir tiempo de respuesta de Odoo
RESPONSE_TIME=$(curl -o /dev/null -s -w "%{time_total}" https://tuodoo.empresa.com/web/login)
if (( $(echo "$RESPONSE_TIME > 3.0" | bc -l) )); then
echo "ALERTA: Tiempo de respuesta elevado: ${RESPONSE_TIME}s"
fi
Paso 4. Monitorización de cron jobs
Los cron jobs de Odoo ejecutan tareas programadas como sincronización de correo, actualización de tipos de cambio, cálculo de costes y generación de informes. Un cron que falla silenciosamente puede provocar datos desactualizados durante días sin que nadie lo detecte.
Revisa el estado de los cron jobs desde la interfaz de Odoo en Ajustes > Técnico > Automatización > Acciones planificadas. Comprueba la fecha de la última ejecución y busca errores en los logs filtrando por ir.cron:
grep "ir.cron" /var/log/odoo/odoo-server.log | grep -i "error\|failed" | tail -20
Paso 5. Supervisión de integraciones externas
Crea verificaciones automáticas para cada integración:
- Bancos: verifica la sincronización diaria de extractos. Si usas OCA bank modules, comprueba la tabla
account_bank_statement_importpor errores. - Pasarelas de pago: confirma que las transacciones se procesan correctamente. Revisa los webhooks de Redsys, Stripe o PayPal.
- Ecommerce: verifica la sincronización de pedidos y stock entre Odoo y la tienda online.
- Correo: confirma que los emails de facturación salen y se entregan revisando la cola de correo en Ajustes > Técnico > Correo electrónico > Emails.
- POS: comprueba que los terminales de punto de venta sincronizan las sesiones y los pagos correctamente.
Programa estas verificaciones en horarios críticos: primera hora de la mañana y después de cada cierre contable.
Paso 6. Optimización de la base de datos PostgreSQL
La base de datos es el corazón de Odoo y requiere mantenimiento regular:
- VACUUM ANALYZE: ejecuta semanalmente para recuperar espacio y actualizar las estadísticas del planificador de consultas.
VACUUM ANALYZE;
- REINDEX: reindexar las tablas más grandes trimestralmente mejora los tiempos de consulta.
REINDEX DATABASE nombre_base_datos;
- Consultas lentas: activa
pg_stat_statementspara identificar las consultas que más tiempo consumen.
-- Top 10 consultas mas lentas
SELECT query, calls, mean_exec_time, total_exec_time
FROM pg_stat_statements
ORDER BY mean_exec_time DESC
LIMIT 10;
- Limpieza de sesiones: elimina las sesiones expiradas de la tabla
ir_sessionsque pueden acumular millones de registros. - Adjuntos huérfanos: revisa y elimina adjuntos que no están vinculados a ningún registro.
- Backups verificados: programa backups diarios con
pg_dumpy verifica su restauración mensualmente.
pg_dump -Fc nombre_base_datos > /backups/odoo_$(date +%Y%m%d).dump
Paso 7. Pruebas periódicas de carga
Simula escenarios de uso intensivo para detectar cuellos de botella antes de que se manifiesten en producción:
- Prueba con el doble de usuarios concurrentes habituales usando herramientas como Locust o Apache JMeter.
- Genera informes pesados durante operaciones normales para medir el impacto.
- Simula picos de actividad como cierres de mes o campañas comerciales.
- Configura un informe semanal automatizado que resuma: tiempo medio de respuesta, errores detectados, estado de integraciones y consumo de recursos.
Dashboards con Grafana para visibilidad completa
Grafana permite crear paneles visuales en tiempo real que muestran el estado de todo el ecosistema de Odoo en una sola pantalla:
- Panel de infraestructura: CPU, RAM, disco y red del servidor con gráficos de tendencia.
- Panel de Odoo: usuarios conectados, tiempos de respuesta, errores por módulo y estado de workers.
- Panel de PostgreSQL: tamaño de la base de datos, consultas lentas, conexiones activas, bloqueos y tasa de cache hit (debería estar por encima del 99 %).
- Panel de integraciones: estado de cada conexión externa con indicadores semáforo (verde/amarillo/rojo).
Conecta Grafana a Zabbix como fuente de datos para reutilizar las métricas ya recopiladas. Estos dashboards se pueden compartir con gerencia como parte del informe mensual IT, proporcionando visibilidad del estado del ERP sin necesidad de conocimientos técnicos.
Cuándo escalar los recursos del servidor
Si tras optimizar consultas, limpiar la base de datos y ajustar la configuración de workers, el rendimiento sigue siendo insuficiente, es momento de escalar:
- Más RAM: Odoo se beneficia enormemente de memoria adicional para la caché de PostgreSQL. La recomendación es asignar al menos el 25 % de la RAM total a
shared_buffersy el 50 % aeffective_cache_size. - CPU más rápida: las operaciones de Odoo son más sensibles a la velocidad por núcleo que al número de núcleos.
- Disco SSD/NVMe: si aún usas discos mecánicos, la migración a SSD es la mejora con mayor impacto inmediato.
- Separación de servicios: en entornos con más de 50 usuarios, considera separar Odoo y PostgreSQL en servidores distintos.
Problemas frecuentes y solución
- Errores repentinos en módulos clave: verifica si se han aplicado actualizaciones recientes de Odoo o módulos de terceros. Comprueba conflictos entre módulos personalizados y actualizaciones del core. Revierte la actualización si es necesario y prueba en un entorno de staging antes de reaplicar.
- Lentitud general del sistema: ejecuta
VACUUM ANALYZEen PostgreSQL, revisa las consultas más lentas conpg_stat_statements, comprueba que los workers están correctamente dimensionados y verifica que no haya procesos cron acumulados ejecutándose simultáneamente. - Caídas periódicas del servicio: revisa los logs del sistema operativo (
dmesg,/var/log/syslog) y de Odoo en busca de errores de memoria (OOM killer). Ajusta el parámetrolimit_memory_harden la configuración de Odoo y aumenta la RAM del servidor si es necesario. - Integraciones que dejan de funcionar: comprueba certificados SSL, tokens de autenticación y cambios en las APIs de los proveedores. Configura verificaciones automáticas para detectar estos fallos antes de que afecten a los usuarios.
- Cron jobs que no se ejecutan: verifica que los registros de
ir.cronestán activos en la base de datos, que no hay workers bloqueados y que el parámetromax_cron_threadses al menos 1 en la configuración de Odoo. - Longpolling no funciona: comprueba que Nginx está redirigiendo correctamente las peticiones del bus al puerto 8072 y que el worker de longpolling está activo.
Preguntas frecuentes
¿Qué señales indican un problema grave en Odoo?
Errores constantes al facturar, tiempos de carga superiores a 5 segundos en operaciones básicas, reinicios frecuentes del servicio, crecimiento inusual del uso de disco o mensajes de error OOM (Out of Memory) en los logs del sistema. También la acumulación de cron jobs pendientes y fallos recurrentes en integraciones bancarias o de pagos.
¿Con qué frecuencia debo revisar los logs?
En entornos críticos con facturación diaria, diariamente. Para uso estándar en PYMEs con menos de 20 usuarios, 2-3 veces por semana es suficiente. La monitorización automatizada con alertas de Zabbix complementa la revisión manual y te avisa en tiempo real de los problemas críticos.
¿Puede la monitorización afectar al rendimiento de Odoo?
Si se configura correctamente, el impacto es mínimo. El agente de Zabbix consume menos del 1 % de CPU y RAM. Los dashboards de Grafana consultan métricas ya recopiladas, no generan carga adicional en Odoo. Evita ejecutar consultas pesadas de monitorización directamente contra la base de datos de producción en horas punta.
¿Necesito un DBA para gestionar PostgreSQL?
Para PYMEs con uso estándar de Odoo, las tareas básicas de mantenimiento como VACUUM, REINDEX y backups pueden gestionarse con conocimientos intermedios y scripts automatizados. Para optimizaciones avanzadas de consultas, particionamiento de tablas o problemas complejos de rendimiento con bloqueos, un DBA o un partner Odoo especializado es recomendable.
¿Cuántos workers debo configurar en Odoo?
La fórmula recomendada es (2 x nucleos de CPU) + 1. Para un servidor con 4 núcleos, configura 9 workers. Asigna al menos 1 worker exclusivo para cron jobs con el parámetro max_cron_threads. Monitoriza el consumo de memoria de los workers y ajusta limit_memory_hard si observas reinicios frecuentes.
En IBERSYA somos especialistas en implementación, mantenimiento y monitorización de Odoo para PYMEs. Configuramos monitorización proactiva con Zabbix para supervisar el servidor 24/7, dashboards personalizados en Grafana para que tengas visibilidad completa del estado de tu ERP, rutinas automatizadas de mantenimiento de PostgreSQL con scripts de VACUUM y REINDEX programados, y revisión periódica de la configuración de workers y longpolling para asegurar el rendimiento óptimo. Si tu Odoo va lento, sufre caídas o simplemente quieres asegurar su estabilidad a largo plazo, contacta con nosotros para una revisión de rendimiento sin compromiso.