Monitoreo y Alertas en MySQL: Visibilidad Completa con Prometheus y Grafana

El monitoreo es un pilar fundamental en la gestión de cualquier sistema, y las bases de datos MySQL no son una excepción. Una buena estrategia de monitoreo te permite identificar cuellos de botella, prever problemas antes de que afecten a los usuarios y reaccionar rápidamente ante cualquier incidente. En este tutorial, construiremos un sistema de monitoreo completo y escalable utilizando dos de las herramientas más populares en el ecosistema DevOps: Prometheus para la recolección de métricas y Grafana para la visualización y las alertas.

🎯 ¿Por qué monitorear MySQL con Prometheus y Grafana?

La combinación de Prometheus y Grafana ofrece una solución potente, flexible y de código abierto para el monitoreo de bases de datos. Aquí te explicamos por qué son una excelente elección:

• Prometheus:
  • Modelo pull: Prometheus 'jala' las métricas de los objetivos configurados, lo que simplifica la configuración en entornos dinámicos.
  • Almacenamiento de series de tiempo: Optimizado para almacenar y consultar grandes volúmenes de datos de series de tiempo.
  • Lenguaje de consulta (PromQL): Un lenguaje potente para agregar, filtrar y analizar métricas.
  • Fiabilidad: Diseñado para ser altamente disponible y tolerante a fallos.
• Grafana:
  • Visualización de datos: Crea dashboards interactivos y personalizables con una amplia gama de paneles.
  • Fuentes de datos: Soporta múltiples fuentes de datos, incluyendo Prometheus.
  • Alertas: Permite configurar reglas de alerta basadas en las métricas visualizadas, con notificaciones a diversos canales.
  • Flexibilidad: Ideal para equipos que necesitan una visión clara y en tiempo real de sus sistemas.

🛠️ Componentes Clave de Nuestra Solución

Para implementar nuestro sistema de monitoreo, necesitaremos los siguientes componentes:

1. MySQL Server: La base de datos que queremos monitorear.
2. mysqld_exporter: Un exportador de métricas para MySQL, que Prometheus utilizará para extraer datos del servidor MySQL.
3. Prometheus Server: El componente principal que recolectará, almacenará y consultará las métricas.
4. Grafana Server: La interfaz de usuario para visualizar los datos y configurar alertas.

---

🚀 Paso 1: Configuración del Exportador de MySQL (mysqld_exporter)

El mysqld_exporter es el puente entre tu servidor MySQL y Prometheus. Se encarga de conectarse a MySQL, recolectar métricas internas y exponerlas en un formato que Prometheus pueda entender.

1.1. Creación de un Usuario de Monitoreo en MySQL

Es una buena práctica crear un usuario específico con permisos mínimos solo para el monitoreo. Esto mejora la seguridad.

Conéctate a tu servidor MySQL como root o un usuario con privilegios administrativos:

mysql -u root -p

Una vez dentro, ejecuta los siguientes comandos para crear el usuario y otorgar los permisos necesarios:

CREATE USER 'exporter'@'localhost' IDENTIFIED BY 'tu_contraseña_segura';
GRANT PROCESS, REPLICATION CLIENT, SELECT ON *.* TO 'exporter'@'localhost';
FLUSH PRIVILEGES;
EXIT;

1.2. Descarga e Instalación de mysqld_exporter

Puedes descargar la última versión de mysqld_exporter desde la página de releases de GitHub de Prometheus. Asegúrate de elegir la versión correcta para tu arquitectura de sistema operativo.

# Ejemplo para Linux AMD64
wget https://github.com/prometheus/mysqld_exporter/releases/download/v0.15.0/mysqld_exporter-0.15.0.linux-amd64.tar.gz
tar xvfz mysqld_exporter-0.15.0.linux-amd64.tar.gz
sudo mv mysqld_exporter-0.15.0.linux-amd64/mysqld_exporter /usr/local/bin/

1.3. Configuración del mysqld_exporter

mysqld_exporter necesita saber cómo conectarse a MySQL. Esto se hace a través de una variable de entorno o un archivo .my.cnf.

Opción A: Usando variable de entorno (recomendado para simplicidad inicial)

export DATA_SOURCE_NAME="exporter:tu_contraseña_segura@(localhost:3306)/"

Opción B: Usando un archivo .my.cnf (más seguro para entornos de producción)

Crea un archivo llamado .my.cnf en el directorio donde se ejecutará mysqld_exporter o en el directorio home del usuario bajo el que se ejecutará (/home/exporter/.my.cnf si creas un usuario exporter del sistema).

# .my.cnf
[client]
user=exporter
password=tu_contraseña_segura
host=localhost
port=3306

Protege este archivo con permisos restrictivos:

sudo chmod 600 /path/to/.my.cnf

1.4. Ejecución como Servicio Systemd (Recomendado)

Para asegurar que mysqld_exporter se ejecute al iniciar el sistema y se gestione fácilmente, configúralo como un servicio systemd.

Crea el archivo /etc/systemd/system/mysqld_exporter.service:

[Unit]
Description=Prometheus MySQL Exporter
After=network.target

[Service]
User=mysqld_exporter # Asegúrate de crear este usuario del sistema o usa 'nobody'
Group=mysqld_exporter
Type=simple
Restart=always
ExecStart=/usr/local/bin/mysqld_exporter --web.listen-address=":9104" --collect.global_status --collect.info_schema.innodb_metrics # Agrega más flags --collect. lo que necesites
Environment="DATA_SOURCE_NAME=exporter:tu_contraseña_segura@(localhost:3306)/"

[Install]
WantedBy=multi-user.target

Crea el usuario y grupo del sistema mysqld_exporter (si no lo tienes):

sudo groupadd --system mysqld_exporter
sudo useradd -s /sbin/nologin --system -g mysqld_exporter mysqld_exporter

Recarga systemd, inicia y habilita el servicio:

sudo systemctl daemon-reload
sudo systemctl start mysqld_exporter
sudo systemctl enable mysqld_exporter
sudo systemctl status mysqld_exporter

Verifica que el exportador esté funcionando accediendo a http://your_server_ip:9104/metrics en tu navegador. Deberías ver una gran cantidad de métricas de MySQL.

---

📖 Paso 2: Instalación y Configuración de Prometheus

Prometheus es el corazón de nuestro sistema de monitoreo. Recolectará las métricas del mysqld_exporter.

2.1. Descarga e Instalación de Prometheus

Descarga la última versión de Prometheus desde su sitio web oficial:

wget https://github.com/prometheus/prometheus/releases/download/v2.45.0/prometheus-2.45.0.linux-amd64.tar.gz
tar xvfz prometheus-2.45.0.linux-amd64.tar.gz
sudo mv prometheus-2.45.0.linux-amd64 /usr/local/prometheus

Crea un usuario y grupo del sistema para Prometheus:

sudo groupadd --system prometheus
sudo useradd -s /sbin/nologin --system -g prometheus prometheus

Establece los permisos correctos para los directorios de Prometheus:

sudo mkdir /var/lib/prometheus
sudo chown prometheus:prometheus /var/lib/prometheus
sudo chown -R prometheus:prometheus /usr/local/prometheus

2.2. Configuración de Prometheus (prometheus.yml)

El archivo de configuración principal de Prometheus es prometheus.yml. Aquí le diremos a Prometheus dónde encontrar el mysqld_exporter.

Crea o edita el archivo /usr/local/prometheus/prometheus.yml:

global:
  scrape_interval: 15s # Rasca métricas cada 15 segundos
  evaluation_interval: 15s # Evalúa las reglas de alerta cada 15 segundos

alerting:
  alertmanagers:
  - static_configs:
    - targets:
      # - localhost:9093 # Si usas Alertmanager, descomenta y ajusta

rule_files:
  # - "alert.rules"

scrape_configs:
  - job_name: 'prometheus'
    static_configs:
      - targets: ['localhost:9090'] # El propio Prometheus

  - job_name: 'mysql'
    static_configs:
      - targets: ['localhost:9104'] # La dirección del mysqld_exporter
    relabel_configs:
      - source_labels: [__address__]
        regex: "(.*):9104"
        target_label: instance
        replacement: "$1:3306" # Etiqueta para identificar el servidor MySQL

2.3. Ejecución como Servicio Systemd

Crea el archivo /etc/systemd/system/prometheus.service:

[Unit]
Description=Prometheus Server
After=network.target

[Service]
User=prometheus
Group=prometheus
Type=simple
Restart=always
ExecStart=/usr/local/prometheus/prometheus --config.file /usr/local/prometheus/prometheus.yml --storage.tsdb.path /var/lib/prometheus --web.enable-lifecycle

[Install]
WantedBy=multi-user.target

Recarga systemd, inicia y habilita el servicio:

sudo systemctl daemon-reload
sudo systemctl start prometheus
sudo systemctl enable prometheus
sudo systemctl status prometheus

Verifica que Prometheus esté funcionando accediendo a http://your_server_ip:9090. En la interfaz web, ve a 'Status' -> 'Targets'. Deberías ver mysql con un estado UP.

---

📈 Paso 3: Instalación y Configuración de Grafana

Grafana nos permitirá visualizar nuestras métricas de forma atractiva y configurar alertas.

3.1. Instalación de Grafana

Grafana proporciona paquetes .deb y .rpm para una fácil instalación. Para sistemas basados en Debian/Ubuntu:

sudo apt-get install -y apt-transport-https software-properties-common wget
wget -q -O - https://packages.grafana.com/gpg.key | sudo apt-key add -
echo "deb https://packages.grafana.com/oss/deb stable main" | sudo tee -a /etc/apt/sources.list.d/grafana.list
sudo apt-get update
sudo apt-get install grafana

Inicia y habilita el servicio Grafana:

sudo systemctl daemon-reload
sudo systemctl start grafana-server
sudo systemctl enable grafana-server
sudo systemctl status grafana-server

Grafana por defecto escucha en el puerto 3000. Accede a http://your_server_ip:3000. Las credenciales por defecto son admin/admin. Se te pedirá que cambies la contraseña la primera vez.

3.2. Añadir Prometheus como Fuente de Datos en Grafana

1. Inicia sesión en Grafana.
2. En el menú lateral izquierdo, haz clic en el icono de 'Configuration' (engranaje) y luego en 'Data Sources'.
3. Haz clic en 'Add data source'.
4. Selecciona 'Prometheus'.
5. Configura lo siguiente:
   • Name: Prometheus (o un nombre descriptivo como MySQL_Prometheus)
   • URL: http://localhost:9090 (la dirección de tu servidor Prometheus)
   • Deja el resto de las opciones por defecto o ajústalas según tus necesidades.
6. Haz clic en 'Save & Test'. Deberías ver 'Data source is working'.

3.3. Importación de un Dashboard de MySQL Pre-construido

Grafana tiene una gran comunidad que comparte dashboards pre-construidos. Podemos importar uno para MySQL y tener una visibilidad instantánea.

1. En el menú lateral, haz clic en el icono de 'Dashboards' y luego en 'Import'.
2. En el campo 'Import via grafana.com', introduce el ID de un dashboard popular de MySQL. Por ejemplo, 1860 (MySQL Overview) o 7362 (MySQL Exporter Dashboard).
3. Haz clic en 'Load'.
4. En la siguiente pantalla, selecciona tu fuente de datos Prometheus (Prometheus o el nombre que le hayas dado) en el campo 'Prometheus'.
5. Haz clic en 'Import'.

¡Felicidades! Ahora deberías tener un dashboard completo mostrando métricas clave de tu servidor MySQL, como conexiones, QPS (Queries Per Second), latencia, uso de CPU/memoria y más.

---

🔔 Paso 4: Configuración de Alertas en Grafana

El monitoreo no es completo sin un sistema de alertas. Grafana te permite configurar reglas de alerta directamente desde tus paneles.

4.1. Configurar un Canal de Notificación

Antes de crear alertas, necesitas un lugar donde enviarlas (email, Slack, PagerDuty, etc.).

1. En el menú lateral, ve a 'Alerting' -> 'Notification channels'.
2. Haz clic en 'New channel'.
3. Selecciona el 'Type' que desees (ej. 'Email', 'Slack').
4. Rellena los detalles de configuración (dirección de correo, webhook de Slack, etc.).
5. Haz clic en 'Send Test' para asegurarte de que funciona y luego en 'Save'.

4.2. Crear una Regla de Alerta en un Panel

Vamos a crear una alerta simple para cuando las conexiones activas a MySQL superen un umbral.

1. Abre tu dashboard de MySQL.
2. En un panel que muestre 'Conexiones activas' (o similar), haz clic en el título del panel y selecciona 'Edit'.
3. En el lado izquierdo, ve a la pestaña 'Alert'.
4. Haz clic en 'Create Alert'.
5. Name: MySQL - High Active Connections
6. Evaluate every: 1m (Evaluar cada minuto)
7. For: 5m (Mantenerse en estado de alerta durante 5 minutos antes de enviar la notificación para evitar falsos positivos).
8. Conditions: Aquí definirás la lógica de la alerta. Por ejemplo, si tu consulta es mysql_global_status_threads_connected:
   • WHEN last() OF query(A, 5m, now) IS ABOVE 100 (alerta si las conexiones activas superan 100 durante 5 minutos).
9. Notifications: Selecciona tu canal de notificación configurado. Puedes añadir un mensaje personalizado.
10. Haz clic en 'Save Alert' o 'Apply' y luego 'Save Dashboard'.

Ahora, si las conexiones activas de tu MySQL superan el umbral establecido, Grafana enviará una notificación a tu canal configurado.

---

✨ Métricas Clave de MySQL para Monitorear

Para un monitoreo efectivo, es vital saber qué métricas son importantes. Aquí una tabla con algunas de las más críticas:

Categoría	Métrica de Prometheus (mysqld_exporter)	Descripción	Importancia
---	---	---	---
Conexiones	mysql_global_status_threads_connected	Número de clientes conectados actualmente.	Crítica
	mysql_global_status_max_used_connections	El número máximo de conexiones que MySQL ha manejado simultáneamente.	Importante
---	---	---
Rendimiento	mysql_global_status_queries	Número de consultas ejecutadas por segundo (QPS).	Crítica
	mysql_global_status_slow_queries	Número de consultas que tardaron más de long_query_time segundos.	Crítica
	mysql_global_status_questions	Número de comandos ejecutados (similar a QPS, pero incluye conexiones).	Intermedia
---	---	---
Uso de Memoria	mysql_global_variables_innodb_buffer_pool_size	Tamaño total del buffer pool de InnoDB.	Importante
	mysql_global_status_innodb_buffer_pool_read_requests_total	Peticiones de lectura al buffer pool.	Intermedia
---	---	---
Bloqueos	mysql_global_status_table_locks_waited	Número de veces que una tabla tuvo que esperar un bloqueo.	Crítica
	mysql_global_status_innodb_row_lock_waits	Número de veces que una fila tuvo que esperar por un bloqueo de InnoDB.	Crítica
---	---	---
Replicación	mysql_slave_status_slave_sql_running	Estado de si el hilo SQL de la réplica está corriendo (1 si sí, 0 si no).	Crítica
	mysql_slave_status_slave_io_running	Estado de si el hilo IO de la réplica está corriendo (1 si sí, 0 si no).	Crítica
	mysql_slave_status_seconds_behind_master	Retraso en segundos de la réplica con respecto al maestro.	Crítica

---

🔍 Solución de Problemas Comunes

Aquí hay algunos problemas comunes que podrías encontrar y cómo resolverlos:

mysqld_exporter no muestra métricas (404 Not Found o sin datos)

Verifica que el usuario de MySQL `exporter` tenga los permisos correctos (`PROCESS`, `REPLICATION CLIENT`, `SELECT`). Asegúrate de que `DATA_SOURCE_NAME` o el archivo `.my.cnf` esté correctamente configurado con la contraseña y host correctos. Revisa los logs del servicio `mysqld_exporter` (`sudo journalctl -u mysqld_exporter.service`).

Prometheus no ve el target de MySQL (estado DOWN)

Confirma que `mysqld_exporter` esté corriendo y accesible en la dirección y puerto configurados en `prometheus.yml` (por defecto `localhost:9104`). Revisa el firewall si los componentes están en diferentes máquinas. Asegúrate de que la configuración `scrape_configs` en `prometheus.yml` sea correcta y que Prometheus se haya recargado (`sudo systemctl restart prometheus`).

Grafana no puede conectar con Prometheus

Verifica que Prometheus esté corriendo y accesible en la URL configurada en la fuente de datos de Grafana. Revisa los logs de Grafana para posibles errores de conexión (`sudo journalctl -u grafana-server.service`). Asegúrate de que no haya firewalls bloqueando la comunicación entre Grafana y Prometheus.

Las alertas de Grafana no se disparan o no llegan

Confirma que las condiciones de la alerta estén configuradas correctamente y que las métricas estén llegando a Grafana. Verifica la configuración del canal de notificación (credenciales de email, webhook de Slack, etc.) y realiza una prueba de envío desde Grafana. Revisa el historial de alertas en Grafana ('Alerting' -> 'Alert Rules') para ver si se han disparado y el estado de notificación.

---

✅ Conclusión

Has implementado un sistema de monitoreo y alertas completo para tu base de datos MySQL utilizando la potente combinación de Prometheus y Grafana. Ahora tienes la capacidad de:

• Recolectar métricas detalladas del rendimiento y el estado de tu MySQL.
• Visualizar estos datos en dashboards interactivos para una comprensión rápida.
• Configurar alertas proactivas para ser notificado de problemas antes de que se conviertan en incidentes críticos.

Este setup te proporcionará la visibilidad necesaria para mantener tu entorno MySQL saludable y garantizar un alto rendimiento y disponibilidad. No dudes en explorar más a fondo las capacidades de PromQL para crear consultas personalizadas y añadir más paneles y alertas según las necesidades específicas de tu aplicación.