Cómo monitorear tu servidor de MU Online con Grafana y Prometheus

Administrar un servidor de MU Online sin monitoreo es como pilotar a ciegas: solo descubres que MySQL se trabó, que la CPU se disparó o que el GameServer se cayó cuando los jugadores ya se están quejando en Discord. Prometheus y Grafana forman el dúo estándar de la industria para observabilidad — el primero recolecta métricas de CPU, memoria, disco, red y base de datos a lo largo del tiempo, y el segundo transforma esos datos en dashboards visuales y alertas automáticas. Este tutorial cubre la instalación de ambos, la configuración de exporters para MySQL y sistema operativo, la creación de un exporter personalizado para jugadores en línea, dashboards listos y alertas que avisan a tu equipo antes de que el jugador perciba el problema.

Por qué monitorear de forma proactiva

La mayoría de los administradores de servidores privados solo reaccionan después del problema — un pico de lag, una caída del GameServer, un disco lleno que traba MySQL. Con métricas históricas, identificas patrones (por ejemplo, MySQL siempre se atasca a las 21h cuando la población de jugadores llega al pico) y actúas antes de que la queja aparezca en Discord. El monitoreo también es evidencia concreta para justificar upgrades de hardware o la migración a un dedicado, en lugar de decisiones basadas en "impresión".

Visión general de la arquitectura

Requisitos previos

• Servidor Linux (o WSL/dedicado Windows con adaptaciones) con acceso root/sudo.
• Servidor de MU Online ya funcionando (mira el tutorial de creación de servidor).
• Docker instalado (recomendado, simplifica la instalación de todo el stack).
• Acceso de lectura a MySQL para el exporter de base de datos.

Paso 1 — Instalar Prometheus y Grafana vía Docker Compose

La forma más simple de levantar todo el stack es con Docker Compose, aislando cada servicio en su propio contenedor.

version: "3.8"
services:
  prometheus:
    image: prom/prometheus
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
    ports:
      - "9090:9090"
  grafana:
    image: grafana/grafana
    ports:
      - "3000:3000"
  node_exporter:
    image: prom/node-exporter
    ports:
      - "9100:9100"
  mysqld_exporter:
    image: prom/mysqld-exporter
    environment:
      - DATA_SOURCE_NAME=exporter:senha@(mysql-host:3306)/
    ports:
      - "9104:9104"

docker compose up -d

Paso 2 — Configurar Prometheus para recolectar los exporters

Edita el prometheus.yml agregando cada objetivo (target) que Prometheus debe consultar periódicamente:

scrape_configs:
  - job_name: 'node'
    static_configs:
      - targets: ['node_exporter:9100']
  - job_name: 'mysql'
    static_configs:
      - targets: ['mysqld_exporter:9104']
  - job_name: 'mu_online'
    static_configs:
      - targets: ['mu_exporter:9200']

Reinicia el contenedor de Prometheus y confirma en http://ip-del-servidor:9090/targets que todos los objetivos aparecen como UP.

Paso 3 — Crear un usuario MySQL dedicado al exporter

Nunca uses la cuenta root de MySQL en el exporter. Crea un usuario con permisos mínimos de lectura de métricas:

CREATE USER 'exporter'@'%' IDENTIFIED BY 'senha_forte' WITH MAX_USER_CONNECTIONS 3;
GRANT PROCESS, REPLICATION CLIENT, SELECT ON *.* TO 'exporter'@'%';

Paso 4 — Armar un exporter personalizado para jugadores en línea

No existe un exporter oficial para métricas específicas de MU Online, pero es simple armar un script periódico que consulta la base de datos (tabla de cuentas conectadas o conteo vía ConnectServer) y expone el resultado en formato Prometheus:

from prometheus_client import Gauge, start_http_server
import mysql.connector
import time

jogadores_online = Gauge('mu_jogadores_online', 'Jugadores conectados en este momento')

def coletar():
    conn = mysql.connector.connect(host="localhost", user="exporter", password="senha_forte", database="MuOnline")
    cursor = conn.cursor()
    cursor.execute("SELECT COUNT(*) FROM MEMB_STAT WHERE ConnectStat = 1")
    jogadores_online.set(cursor.fetchone()[0])
    conn.close()

if __name__ == "__main__":
    start_http_server(9200)
    while True:
        coletar()
        time.sleep(30)

Paso 5 — Conectar Grafana a Prometheus

Accede a http://ip-del-servidor:3000 (login predeterminado admin/admin la primera vez), ve a Data Sources y agrega Prometheus con la URL http://prometheus:9090. Guarda y prueba la conexión antes de seguir con los dashboards.

Paso 6 — Importar dashboards listos

La comunidad de Grafana ofrece dashboards listos para Node Exporter (ID 1860) y MySQL Exporter (ID 7362), que importas directamente por el ID en la pantalla de Import Dashboard. Para las métricas personalizadas de MU Online, arma un panel simple con un gráfico de línea usando la métrica mu_jogadores_online a lo largo del tiempo.

Paso 7 — Configurar alertas con Alertmanager

Crea reglas de alerta en Prometheus para condiciones críticas, como CPU por encima de 90% durante 5 minutos o caída en el número de jugadores en línea (indicio de GameServer fuera de línea):

groups:
  - name: mu_alerts
    rules:
      - alert: CPUAlta
        expr: 100 - (avg(rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100) > 90
        for: 5m
        labels:
          severity: critical
        annotations:
          summary: "CPU por encima de 90% durante 5 minutos"
      - alert: ServidorForaDoAr
        expr: mu_jogadores_online == 0
        for: 3m
        labels:
          severity: critical
        annotations:
          summary: "Ningún jugador en línea — posible GameServer fuera de línea"

Configura el Alertmanager con un webhook de Discord para recibir estas notificaciones automáticamente en el canal del equipo de administración.

Paso 8 — Definir retención y backup de las métricas

Configura la retención de Prometheus (predeterminada 15 días) según el espacio en disco disponible, e incluye el volumen de datos de Prometheus y Grafana en la rutina de backup del servidor, para no perder el historial en caso de falla de disco.

Errores comunes y soluciones

Lista de verificación de monitoreo

• Prometheus, Grafana y exporters corriendo vía Docker Compose.
• Todos los targets con estado UP en Prometheus.
• Usuario MySQL dedicado al exporter, con permisos mínimos.
• Exporter personalizado de jugadores en línea funcionando.
• Dashboards importados y mostrando datos reales.
• Reglas de alerta configuradas para CPU, disco y caída de jugadores.
• Alertmanager integrado al Discord del equipo.
• Retención de datos y backup del stack de monitoreo definidos.

Con el monitoreo activo, el siguiente paso natural es cruzar estas métricas con el proceso de respuesta a incidentes de tu equipo — saber que el disco se está llenando no sirve de nada si nadie es notificado a tiempo para actuar; revisa también el tutorial de creación de servidor de MU Online para garantizar que la infraestructura base soporta este nivel de observabilidad.

Preguntas frecuentes