Grafana es la herramienta de visualización de métricas más popular del ecosistema open source. Combinada con Proxmox VE, te permite tener en un único panel el estado de CPU, RAM, discos, red y VMs de tu hipervisor, con alertas y dashboards listos para usar.
En esta guía te explico cómo instalar Grafana en Debian 11, conectarlo con Proxmox por dos vías (el plugin oficial y el almacenamiento en InfluxDB) y crear tu primer panel de métricas.
Si estás empezando con Proxmox, te recomiendo antes leer la guía completa sobre Proxmox y, si quieres montar un entorno más ambicioso, el laboratorio de ciberseguridad con Proxmox y pfSense.
📑 Índice de contenidos
- Requisitos previos
- Instalación de Grafana en Debian 11
- Acceso a Grafana y primer login
- Método 1: conectar Proxmox VE con Grafana
- Método 2: monitorizar Proxmox vía InfluxDB
- Crear tu primer panel con métricas de Proxmox
- Recomendaciones de seguridad
- Solución de problemas comunes
- Conclusión y siguientes pasos
🛠️ 1. Requisitos previos
- Debian 11 (los comandos funcionan también en Debian 12; si vienes de la versión anterior, consulta cómo actualizar de Debian 11 a Debian 12).
- Un servidor Proxmox VE accesible por red. Aquí tienes la guía completa sobre Proxmox.
- Usuario con
sudo. - Conocimientos básicos de terminal (si no los tienes, empieza por los 10 comandos esenciales de Linux).
💡 Consejo: puedes instalar Grafana en una VM Debian o, si prefieres, en un contenedor LXC. Si eliges LXC, revisa la guía de crear y administrar contenedores LXC en Linux.
📦 2. Instalación de Grafana en Debian 11
2.1. Actualizar el sistema
sudo apt update && sudo apt upgrade -y2.2. Instalar dependencias
sudo apt install -y curl gnupg apt-transport-https2.3. Añadir la clave GPG oficial (método actual)
⚠️ Importante: el antiguo
apt-keyestá obsoleto desde Debian 11 y el dominiopackages.grafana.comfue reemplazado porapt.grafana.com. Usa el método modernosigned-by.
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://apt.grafana.com/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/grafana.gpg2.4. Añadir el repositorio
echo "deb [signed-by=/etc/apt/keyrings/grafana.gpg] https://apt.grafana.com stable main" | sudo tee /etc/apt/sources.list.d/grafana.list
sudo apt update2.5. Instalar Grafana
sudo apt install -y grafana2.6. Iniciar y habilitar el servicio
sudo systemctl start grafana-server
sudo systemctl enable grafana-server
sudo systemctl status grafana-serverDeberías ver active (running). Grafana escucha por defecto en el puerto 3000.
2.7. Abrir el puerto en el firewall (si aplica)
sudo ufw allow 3000/tcp🔒 Para configuraciones de firewall más avanzadas, consulta nuestra guía de firewall en Linux con UFW y firewalld.
🌐 3. Acceso a Grafana y primer login
Abre en el navegador:
http://IP-DE-TU-SERVIDOR:3000Credenciales iniciales:
| Campo | Valor por defecto |
|---|---|
| Usuario | admin |
| Contraseña | admin |
Grafana te pedirá cambiar la contraseña en el primer acceso. Hazlo y guarda la nueva en tu gestor de contraseñas (aquí tienes una guía de buenas prácticas en el uso de contraseñas y 2FA).
⚠️ No expongas el puerto 3000 directamente a Internet. Lo ideal es poner Grafana detrás de un reverse proxy con HTTPS. Puedes reutilizar lo aprendido en la guía para configurar SSL en Nginx y en la de implementación correcta de HTTPS.
🔌 4. Método 1: conectar Proxmox VE con Grafana (plugin)
Este método es el más rápido para empezar: consulta directamente la API de Proxmox.
4.1. Crear un usuario API en Proxmox
En Proxmox VE, ve a Datacenter → Permissions → Users → Add y crea un usuario, por ejemplo grafana@pve. Asígnale el rol PVEAuditor (solo lectura) sobre / en Permissions → Add → User Permission.
4.2. Instalar el plugin Proxmox en Grafana
Ve a Connections → Add new connection (o Configuration → Data sources en versiones antiguas) y busca «Proxmox VE». Instálalo si no aparece por defecto:
sudo grafana-cli plugins install camptocamp-prometheus-alertmanager-datasource
# o el plugin que prefieras para Proxmox, según el repositorio oficial4.3. Configurar el origen de datos
Rellena:
| Campo | Valor |
|---|---|
| URL | https://IP-PROXMOX:8006 |
| User | grafana@pve |
| Password | La contraseña del usuario API |
| Skip TLS Verify | Activar (solo en red interna) |
Pulsa Save & Test. Si la conexión es correcta, ya puedes crear paneles con los datos que te devuelve el plugin.
🗄️ 5. Método 2: monitorizar Proxmox vía InfluxDB
Este método es el recomendado para históricos y dashboards avanzados. Proxmox envía sus métricas a InfluxDB y Grafana las consulta.
5.1. Instalar InfluxDB
Puedes instalarlo en el propio Proxmox o en una VM aparte. Sigue la documentación oficial de InfluxDB 2.x. Una vez creado, apunta:
- URL:
http://IP-INFLUX:8086 - Base de datos y usuario que crearás en InfluxDB.
5.2. Habilitar el envío de métricas en Proxmox
Edita /etc/pve/status.cfg en el nodo Proxmox:
influxdb: influx
server IP-INFLUX
port 8086
database proxmox
username grafana
password TU_PASSWORDReinicia el servicio de métricas:
systemctl restart pvestatd5.3. Añadir InfluxDB como origen de datos en Grafana
En Grafana: Connections → Data sources → InfluxDB. Rellena:
| Campo | Valor |
|---|---|
| URL | http://IP-INFLUX:8086 |
| Database | proxmox |
| User | grafana |
| Password | La contraseña de InfluxDB |
Pulsa Save & Test. Si todo está bien, verás el mensaje verde de conexión correcta.
📘 Si vienes de una instalación con InfluxDB 2.x, necesitarás el token de API en lugar de usuario/contraseña. Consulta la documentación oficial de Grafana-InfluxDB.
📊 6. Crear tu primer panel con métricas de Proxmox
6.1. Crear el dashboard
- Dashboards → New → New dashboard → Add visualization.
- Selecciona el origen de datos (InfluxDB o el plugin de Proxmox).
- Elige el tipo de gráfico (Time series para métricas temporales).
6.2. Consulta de ejemplo: carga de CPU
En la sección Query pega:
SELECT mean("value") FROM "proxmox_data"."cpu"
WHERE ("host" = 'TU-SERVIDOR-PROXMOX') AND $timeFilter
GROUP BY time($__interval) fill(null)Sustituye TU-SERVIDOR-PROXMOX por el nombre de host que identifica a tu nodo en InfluxDB.
6.3. Otras consultas útiles
| Métrica | Consulta InfluxQL |
|---|---|
| RAM usada | SELECT mean("value") FROM "proxmox_data"."memory" WHERE ("host" = 'TU-SERVIDOR-PROXMOX') AND $timeFilter GROUP BY time($__interval) fill(null) |
| Red entrante | SELECT mean("value") FROM "proxmox_data"."netin" WHERE ("host" = 'TU-SERVIDOR-PROXMOX') AND $timeFilter GROUP BY time($__interval) fill(null) |
| Disco root | SELECT mean("value") FROM "proxmox_data"."rootfs" WHERE ("host" = 'TU-SERVIDOR-PROXMOX') AND $timeFilter GROUP BY time($__interval) fill(null) |
6.4. Importar un dashboard ya hecho (atajo)
En Dashboards → New → Import, introduce el ID 10048 (dashboard oficial de Proxmox para InfluxDB) o busca «Proxmox» en grafana.com/grafana/dashboards. Solo tienes que seleccionar tu origen de datos y listo.
6.5. Guardar el panel
Pulsa Apply en la parte superior y luego Save dashboard. Ponle un nombre descriptivo (por ejemplo, «Proxmox – Nodo principal»).
🔐 7. Recomendaciones de seguridad
- No expongas Grafana directamente a Internet. Usa un reverse proxy con HTTPS (por ejemplo, Nginx: configurar SSL en Nginx).
- Cambia la contraseña por defecto de
adminen el primer login. - Crea usuarios de solo lectura en Proxmox (
PVEAuditor) para Grafana: nunca usesroot@pam. - Habilita 2FA en la cuenta de administrador de Grafana.
- Aplica un hardening general del servidor siguiendo la guía de hardening de servidores web Apache vs Nginx (los principios aplican aunque no uses Apache/Nginx).
- Protege el servidor con Fail2Ban siguiendo la guía de Fail2Ban en Linux.
🧰 8. Solución de problemas comunes
| Síntoma | Causa probable | Solución |
|---|---|---|
Failed to fetch grafana | Repositorio antiguo (packages.grafana.com) | Usar apt.grafana.com con signed-by |
NO_PUBKEY al hacer apt update | Clave GPG mal importada | Repetir paso 2.3 en /etc/apt/keyrings/grafana.gpg |
| Grafana no arranca | Puerto 3000 ocupado | sudo ss -tlnp | grep 3000 |
502 Bad Gateway en el plugin Proxmox | Certificado TLS autofirmado | Activar Skip TLS Verify en el data source |
| No aparecen métricas en InfluxDB | status.cfg mal configurado o pvestatd parado | systemctl restart pvestatd y revisar logs |
| Dashboard importado sin datos | Origen de datos no seleccionado al importar | Reasignar en Dashboard settings → Variables |
| Consumo alto de RAM | Grafana + InfluxDB en la misma VM | Consulta la guía de optimización de recursos en máquinas virtuales |
| Servidor lento tras el despliegue | Falta tuning del sistema | Revisa optimización de rendimiento de servidores Linux |
Si tras todo esto el servidor va lento, consulta también cómo mejorar el rendimiento de tu servidor Linux.
🏁 9. Conclusión y siguientes pasos
Ya tienes Grafana instalado en Debian 11 y monitorizando tu servidor Proxmox, con dos métodos disponibles:
- Plugin Proxmox VE: rápido de configurar, ideal para consultas puntuales.
- InfluxDB + Grafana: la opción profesional para históricos, alertas y dashboards completos.
Siguientes pasos recomendados:
- 📈 Complementa con Netdata para métricas en tiempo real → Guía para instalar Netdata en Debian 11
- 🖥️ Monitoriza más servidores → Las mejores herramientas de monitorización de servidor
- 🛡️ Protege el entorno → Configurar Fail2Ban en Linux y auditoría de ciberseguridad paso a paso
- 🖧 Amplía con pfSense → Instalar y configurar pfSense en una red doméstica y el laboratorio Proxmox + pfSense
- 🔄 Automatiza el mantenimiento → Automatizar backups en Linux con rsync y cron y automatizar tareas con Ansible
- 🖧 Documenta la red → Guía completa de redes
¿Te ha resultado útil esta guía? Déjanos un comentario con tus dudas o cuéntanos qué métricas has empezado a monitorizar en tu Proxmox.
