Cómo Instalar Netdata en Debian (Guía Completa 2026)

📘 Este artículo forma parte de nuestra Guía Completa de Servidores y Virtualización. Si buscas una plataforma de monitorización más completa para infraestructuras grandes, consulta nuestra Guía de instalación de Zabbix con Nginx.

Introducción

Netdata es una de las herramientas de monitorización en tiempo real más impresionantes del ecosistema Linux. A diferencia de otras soluciones, destaca por:

Dashboards preciosos y detallados.
Instalación en 1 comando.
Detección de anomalías con Machine Learning.
Bajísimo consumo de recursos.
Métricas en tiempo real (resolución de 1 segundo).

En 2026, Netdata es la mejor opción para monitorizar servidores individuales o pequeños clústeres sin complicaciones. Para infraestructuras grandes, mejor combinarlo con Zabbix o Prometheus.

En esta guía completa vas a aprender:

Qué es Netdata y por qué usarlo.
Instalación oficial (kickstart).
Instalación por paquete.
Configuración avanzada.
Netdata Cloud (opcional).
Parent-Child para redes grandes.
Alertas y notificaciones.
Machine Learning para anomalías.
Seguridad y autenticación.
Optimización y backups.
Troubleshooting.
FAQ.

Si ya tienes Zabbix y quieres comparar, consulta nuestra Guía de instalación de Zabbix con Nginx y Las mejores herramientas de monitorización.

Índice de contenidos

¿Qué es Netdata?
Requisitos
Instalación
Configuración básica
Netdata Cloud (opcional)
Parent-Child para redes grandes
Alertas y notificaciones
Machine Learning
Seguridad
Optimización
Backups y actualizaciones
Troubleshooting
Netdata vs Zabbix vs Prometheus
FAQ
Conclusión

1. ¿Qué es Netdata?

Netdata es una plataforma de monitorización en tiempo real open source que recopila y visualiza miles de métricas de:

Sistema (CPU, RAM, disco, red).
Aplicaciones (Nginx, MySQL, PostgreSQL, Docker).
Contenedores (Docker, Kubernetes).
Servicios (web, DNS, correo).
Hardware (sensores, GPU, RAID).

1.1 Características principales

Instalación en 1 comando.
Dashboards interactivos (más de 1.000 gráficos).
Resolución de 1 segundo.
Bajísimo consumo (~5% CPU, 100-200 MB RAM).
Machine Learning para anomalías.
Alertas configurables.
Multi-plataforma (Linux, macOS, BSD, Docker, Kubernetes).
Netdata Cloud para monitorización centralizada.

1.2 Diferencias con otras herramientas

Herramienta	Enfoque	Recursos	Ideal para
Netdata	Tiempo real	Muy bajo	Servidores individuales
Zabbix	Enterprise	Alto	Infraestructuras grandes
Prometheus	Cloud-native	Medio	Kubernetes, cloud
Nagios	Clásico	Bajo	Redes tradicionales

Conclusión: Netdata es ideal como primer sistema de monitorización o complemento a Zabbix.

1.3 Versiones

Netdata v2.x (2024-2026) — última versión con nuevas features.
Netdata v1.x — versión antigua (legacy).

Consulta Cómo instalar y configurar Zabbix si necesitas monitorización enterprise.

2. Requisitos

2.1 Hardware

Componente	Mínimo	Recomendado
CPU	1 core	2+ cores
RAM	512 MB	1-2 GB
Disco	1 GB	5-10 GB (para retención)
Red	100 Mbps	1 Gbps

Consumo típico: 100-200 MB RAM, 1-5% CPU.

2.2 Software

Debian 12 (Bookworm) — recomendado.
Debian 11 (Bullseye) — funciona con ajustes.
Debian 13 (Trixie) — soportado.
curl y wget.

2.3 Puertos

Puerto	Servicio
19999	Dashboard web de Netdata

2.4 Preparación

sudo apt update
sudo apt full-upgrade -y
sudo apt install -y curl wget

Consulta Guía Completa de Linux.

3. Instalación

3.1 Método 1: Kickstart (oficial, recomendado)

El método oficial y más rápido:

wget -O /tmp/netdata-kickstart.sh https://get.netdata.cloud/kickstart.sh
sudo sh /tmp/netdata-kickstart.sh

El script:

Detecta tu distribución.
Instala dependencias automáticamente.
Descarga la última versión.
Configura el servicio systemd.
Inicia Netdata.

Salida esperada:

Netdata installation completed successfully!
Visit http://localhost:19999 to see your dashboard.

3.2 Método 2: Repositorio oficial

Alternativa recomendada para producción:

# Añadir clave GPG
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.netdata.cloud/netdatabot.gpg.key | \
    sudo gpg --dearmor -o /etc/apt/keyrings/netdata.gpg

# Añadir repositorio
echo "deb [signed-by=/etc/apt/keyrings/netdata.gpg] https://repo.netdata.cloud/repos/stable/debian/ bookworm/" | \
    sudo tee /etc/apt/sources.list.d/netdata.list

# Instalar
sudo apt update
sudo apt install -y netdata

3.3 Método 3: Docker (si lo prefieres)

docker run -d --name=netdata \
  -p 19999:19999 \
  -v netdataconfig:/etc/netdata \
  -v netdatalib:/var/lib/netdata \
  -v netdatacache:/var/cache/netdata \
  -v /etc/passwd:/host/etc/passwd:ro \
  -v /etc/group:/host/etc/group:ro \
  -v /proc:/host/proc:ro \
  -v /sys:/host/sys:ro \
  -v /etc/os-release:/host/etc/os-release:ro \
  --restart unless-stopped \
  --cap-add SYS_PTRACE \
  --security-opt apparmor=unconfined \
  netdata/netdata

Consulta Qué es Docker.

3.4 Verificar instalación

sudo systemctl status netdata
sudo ss -tulpn | grep 19999

Debería estar active (running).

3.5 Acceder al dashboard

Abre en el navegador:

http://IP_DEL_SERVIDOR:19999

Verás el dashboard principal con gráficos en tiempo real.

Guía completa para instalar Netdata en Debian 11

4. Configuración básica

4.1 Estructura de configuración

Netdata usa:

/etc/netdata/netdata.conf: configuración global.
/etc/netdata/conf.d/: configuración modular.
/etc/netdata/stream.conf: parent-child.
/etc/netdata/health.d/: alertas.
/etc/netdata/edit-config: herramienta de edición.

4.2 Editar configuración

sudo /etc/netdata/edit-config netdata.conf

Configuración recomendada:

[global]
    run as user = netdata
    web files owner = root
    web files group = netdata
    memory mode = dbengine
    page cache size = 32
    dbengine multihost disk space = 1024

[web]
    bind to = *:19999
    default port = 19999
    allow connections from = localhost 192.168.*
    allow dashboard from = localhost 192.168.*
    allow badges from = *
    allow streaming from = *

[logs]
    debug flags = 0x0000000000000000

[plugins]
    proc = yes
    diskspace = yes
    cgroups = yes
    tc = yes
    idlejitter = yes
    enable running new plugins = yes
    check for new plugins every = 60

4.3 Configuración de retención

La retención depende del modo de almacenamiento:

dbengine (por defecto): retención de semanas/meses.
ram: solo en RAM (rápido pero efímero).
alloc: híbrido.

Ajustar retención:

[global]
    memory mode = dbengine
    page cache size = 32
    dbengine multihost disk space = 2048  # 2 GB

Para 30 días de retención:

    dbengine multihost disk space = 4096  # 4 GB

4.4 Configurar plugins adicionales

Nginx:

sudo /etc/netdata/edit-config go.d/nginx.conf

jobs:
  - name: local
    url: http://localhost/stub_status

MySQL/MariaDB:

sudo /etc/netdata/edit-config go.d/mysql.conf

jobs:
  - name: local
    dsn: netdata:password@tcp(localhost:3306)/

Docker:

Netdata detecta Docker automáticamente si está instalado.

PostgreSQL:

jobs:
  - name: local
    dsn: postgres://user:password@localhost:5432/database

Consulta Qué es Docker y Cómo instalar MariaDB.

4.5 Reiniciar

sudo systemctl restart netdata

5. Netdata Cloud (opcional)

Netdata Cloud permite monitorizar múltiples servidores desde una interfaz centralizada.

5.1 Crear cuenta

Visita https://app.netdata.cloud.
Crea una cuenta gratuita.
Crea un Space (workspace).
Añade un War Room.

5.2 Conectar el agente

En el dashboard de Netdata:

Sign in to Netdata.
Sigue las instrucciones.
Copia el comando de conexión.
Ejecútalo:

sudo netdata-claim.sh -token=XXXX -rooms=YYYY -url=https://app.netdata.cloud

5.3 Beneficios

Vista centralizada de múltiples servidores.
Alertas unificadas.
Dashboards compartidos.
Histórico extendido (60 días gratis).
Mobile app.

5.4 Privacidad

Los datos se envían cifrados.
Puedes usar Netdata sin Cloud (self-hosted).
Elige qué métricas compartir.

Consulta Privacidad de los datos en la era digital.

6. Parent-Child para redes grandes

Parent-Child permite que múltiples Netdata «children» envíen datos a un Netdata «parent».

6.1 Casos de uso

Múltiples servidores.
Redes remotas.
Reducir carga de la base de datos.
Alternativa gratuita a Netdata Cloud.

6.2 Configurar el Parent

En el servidor principal:

sudo /etc/netdata/edit-config stream.conf

[stream]
    enabled = yes
    destination = localhost:19999
    api key = 11111111-2222-3333-4444-555555555555
    timeout seconds = 60
    default memory mode = dbengine
    health enabled by default = auto
    allow from = *

Generar API key:

uuidgen

6.3 Configurar los Children

En cada servidor secundario:

sudo /etc/netdata/edit-config stream.conf

[stream]
    enabled = yes
    destination = IP_DEL_PARENT:19999
    api key = 11111111-2222-3333-4444-555555555555
    timeout seconds = 60
    default memory mode = ram
    health enabled by default = auto

Reiniciar:

sudo systemctl restart netdata

6.4 Verificar conexión

En el dashboard del parent, verás los hosts conectados en el menú superior.

6.5 Alertas centralizadas

Las alertas se evalúan en el parent, enviando notificaciones desde un solo punto.

Consulta Guía Completa de Redes.

7. Alertas y notificaciones

7.1 Alertas por defecto

Netdata incluye cientos de alertas predefinidas:

CPU al 80%.
RAM al 90%.
Disco casi lleno.
Servicio caído.
Latencia alta.
Errores en logs.

Ver todas:

ls /usr/lib/netdata/conf.d/health.d/

7.2 Configurar alertas personalizadas

sudo /etc/netdata/edit-config health.d/cpu.conf

Ejemplo: alerta CPU al 90%:

 alarm: my_cpu_usage
    on: system.cpu
    os: linux
 lookup: average -1m percentage of user
  units: %
  every: 10s
   warn: $this > 80
   crit: $this > 90
    info: CPU usage is high
    to: sysadmin

7.3 Configurar email

sudo /etc/netdata/edit-config health_alarm_notify.conf

SEND_EMAIL="YES"
EMAIL_SENDER="netdata@tudominio.com"
DEFAULT_RECIPIENT_EMAIL="admin@tudominio.com"

Requisitos: servidor de correo configurado. Consulta Guía de servidor de correo.

7.4 Configurar Slack

SEND_SLACK="YES"
SLACK_WEBHOOK_URL="https://hooks.slack.com/services/..."
DEFAULT_RECIPIENT_SLACK="#alertas"

7.5 Configurar Telegram

SEND_TELEGRAM="YES"
TELEGRAM_BOT_TOKEN="1234567890:AAA..."
DEFAULT_RECIPIENT_TELEGRAM="123456789"

7.6 Configurar Discord

SEND_DISCORD="YES"
DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/..."
DEFAULT_RECIPIENT_DISCORD="#alertas"

7.7 Silenciar alertas

Por servicio:

sudo /etc/netdata/edit-config health.d/silencer.conf

O desde el dashboard: Alerts → Silence.

7.8 Ver alertas activas

En el dashboard: Alerts → Active Alerts.

Consulta La importancia de la monitorización de redes.

8. Machine Learning

Netdata usa Machine Learning para detectar anomalías.

8.1 Cómo funciona

Aprende patrones normales de métricas.
Detecta desviaciones que podrían indicar problemas.
Genera alertas cuando el comportamiento es anómalo.

8.2 Configurar ML

Ver estado:

sudo cat /var/lib/netdata/ml/models.json | head -50

Habilitar/deshabilitar:

sudo /etc/netdata/edit-config netdata.conf

[ml]
    enabled = yes
    maximum num samples to train = 21600
    minimum num samples to train = 900
    train every = 10800
    number of models per dimension = 18

8.3 Anomalías en el dashboard

Las anomalías se muestran en:

Dashboard principal: indicador de anomalías.
Anomaly Advisor: página dedicada.
Charts: sombreado cuando hay anomalía.

8.4 Ajustar sensibilidad

[ml]
    dimension anomaly rate threshold = 1.0
    host anomaly rate threshold = 1.0

Consulta Machine Learning y ciberseguridad.

9. Seguridad

9.1 Por defecto

Netdata NO tiene autenticación por defecto y solo escucha en localhost:19999.

⚠️ Nunca expongas Netdata a internet sin protección.

9.2 Opciones de seguridad

Opción 1: Nginx como proxy con autenticación

server {
    listen 443 ssl http2;
    server_name netdata.tudominio.com;

    ssl_certificate /etc/letsencrypt/live/netdata.tudominio.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/netdata.tudominio.com/privkey.pem;

    auth_basic "Netdata";
    auth_basic_user_file /etc/nginx/.htpasswd;

    location / {
        proxy_pass http://127.0.0.1:19999;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # WebSocket
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

Crear usuario:

sudo apt install apache2-utils
sudo htpasswd -c /etc/nginx/.htpasswd admin

Opción 2: VPN para acceso remoto

Monta una VPN (WireGuard, Tailscale) y accede solo desde dentro.

Consulta Cómo montar tu propio servidor de VPN.

Opción 3: Cloudflare Access

Configura Cloudflare Access.
Añade netdata.tudominio.com.
Configura política de acceso.

Consulta Zero Trust.

9.3 Firewall

sudo ufw default deny incoming
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

NO abras el 19999 a internet.

Consulta Guía para configurar firewall en Debian.

9.4 Limitaciones por IP

[web]
    allow connections from = localhost 192.168.1.0/24
    allow dashboard from = localhost 192.168.1.0/24

9.5 Fail2ban

sudo apt install fail2ban

Crea /etc/fail2ban/jail.d/netdata.conf:

[netdata]
enabled = true
port = http,https
filter = netdata
logpath = /var/log/nginx/netdata.access.log
maxretry = 5
bantime = 3600

Consulta Cómo configurar y usar Fail2ban.

10. Optimización

10.1 Reducir consumo de recursos

Si Netdata consume mucho:

[global]
    memory mode = ram          # Alternativa rápida pero no persistente
    page cache size = 16       # Menos caché
    dbengine multihost disk space = 256  # Menos disco

10.2 Deshabilitar plugins innecesarios

sudo /etc/netdata/edit-config netdata.conf

[plugins]
    proc = yes
    diskspace = yes
    cgroups = yes
    tc = no                 # Deshabilitar si no necesitas traffic control
    idlejitter = no         # Deshabilitar si no lo necesitas
    apps = yes
    go.d = yes
    python.d = no           # Deshabilitar si no usas plugins Python
    charts.d = no           # Deshabilitar si no usas charts.d
    node.d = no             # Deshabilitar si no usas Node.js

10.3 Ajustar intervalo de recolección

[global]
    update every = 2        # Por defecto 1 segundo

Nota: valores más altos reducen carga pero pierden detalle.

10.4 Monitorizar el propio Netdata

Netdata se monitoriza a sí mismo. En el dashboard, busca la sección Netdata Monitoring.

Consulta Optimización de servidores Linux.

11. Backups y actualizaciones

11.1 Backup de configuración

sudo tar -czf netdata-config-$(date +%F).tar.gz /etc/netdata/

11.2 Backup de base de datos

sudo tar -czf netdata-db-$(date +%F).tar.gz /var/lib/netdata/ /var/cache/netdata/

⚠️ Detén Netdata antes:

sudo systemctl stop netdata
sudo tar -czf netdata-db-$(date +%F).tar.gz /var/lib/netdata/ /var/cache/netdata/
sudo systemctl start netdata

11.3 Automatizar backups

sudo crontab -e

0 3 * * * tar -czf /backup/netdata-config-$(date +\%F).tar.gz /etc/netdata/

11.4 Actualizar Netdata

Si instalaste con kickstart:

sudo /tmp/netdata-kickstart.sh --reinstall

Si instalaste con apt:

sudo apt update
sudo apt upgrade netdata

Reiniciar:

sudo systemctl restart netdata

Consulta La importancia de los backups.

12. Troubleshooting

12.1 Netdata no arranca

sudo systemctl status netdata
sudo journalctl -u netdata -n 50
sudo tail -f /var/log/netdata/error.log

Causas comunes:

Puerto 19999 ocupado.
Permisos incorrectos.
Configuración con errores.

12.2 No puedo acceder al dashboard

Causas:

Puerto cerrado en firewall.
Netdata no escucha en la IP correcta.
Proxy mal configurado.

Solución:

sudo ss -tulpn | grep 19999
sudo ufw status

Edita netdata.conf:

[web]
    bind to = *:19999

12.3 Dashboard lento

Causas:

Muchas métricas activas.
Disco lento.
CPU saturada.

Solución:

Reducir plugins.
Aumentar update every.
Disco SSD.

12.4 Netdata consume mucha CPU

Causas:

Demasiados plugins.
Intervalo muy corto.

Solución:

[global]
    update every = 2

O deshabilitar plugins específicos.

12.5 Alertas no llegan

Diagnóstico:

sudo grep "alarm" /var/log/netdata/error.log

Causas:

Configuración de email/Slack/Telegram mal.
Sin conectividad.
Alertas silenciadas.

12.6 No detecta servicios (Nginx, MySQL)

Causas:

Plugin no habilitado.
Credenciales incorrectas.
Servicio no accesible.

Solución:

sudo /etc/netdata/edit-config go.d/nginx.conf

Verificar que el servicio responde.

12.7 Base de datos corrupta

Solución:

sudo systemctl stop netdata
sudo rm -rf /var/lib/netdata/dbengine/
sudo systemctl start netdata

⚠️ Pierdes histórico.

12.8 Machine Learning no funciona

Diagnóstico:

sudo cat /var/lib/netdata/ml/models.json | jq

Causas:

ML deshabilitado.
Poco histórico entrenado.
Recursos insuficientes.

Esperar unas horas/días a que entrene.

12.9 Parent-Child no conecta

Diagnóstico:

sudo tail -f /var/log/netdata/error.log | grep stream

Causas:

API key incorrecta.
Firewall bloquea puerto 19999.
Configuración del parent incorrecta.

12.10 Ver logs

sudo tail -f /var/log/netdata/error.log
sudo journalctl -u netdata -f

Consulta Análisis de registros en Linux.

13. Netdata vs Zabbix vs Prometheus

Aspecto	Netdata	Zabbix	Prometheus
Complejidad	Muy baja	Alta	Media
Instalación	1 comando	Manual	Manual
Recursos	Muy bajos	Altos	Medios
Tiempo real	Sí (1s)	No	No
Retención	Semanas/meses	Meses/años	Configurable
Escalabilidad	Media	Alta	Muy alta
ML	Sí (integrado)	No	No
Alertas	Sí	Sí	Sí
Dashboards	Excelentes	Buenos	Buenos
Ideal para	Servidores individuales	Infraestructuras grandes	Cloud/K8s

Recomendación:

Solo 1-5 servidores: Netdata.
5-50 servidores: Netdata + Parent-Child o Prometheus.
50+ servidores: Zabbix o Prometheus + Grafana.
Cloud/Kubernetes: Prometheus + Grafana.

Consulta Las mejores herramientas de monitorización.

14. FAQ

¿Qué es Netdata?

Netdata es una plataforma de monitorización en tiempo real que recopila miles de métricas de sistemas, aplicaciones y servicios.

Destaca por: instalación en 1 comando, dashboards excelentes, bajo consumo.

¿Netdata es gratis?

Sí. Netdata es open source bajo licencia GPL.

Netdata Cloud tiene plan gratuito con retención limitada.

¿Netdata consume muchos recursos?

No. Consume ~1-5% CPU y 100-200 MB RAM con la configuración por defecto.

¿Netdata o Zabbix?

Netdata: fácil, tiempo real, servidor individual.
Zabbix: enterprise, escalable, muchos hosts.

Recomendación: Netdata para empezar; Zabbix para infraestructura grande.

¿Netdata tiene autenticación?

No por defecto. Se debe proteger con:

Nginx + Basic Auth.
VPN.
Cloudflare Access.

Nunca exponer directamente a internet.

¿Cómo monitorizo múltiples servidores?

Opción 1: Netdata Cloud (gratis con limitaciones).
Opción 2: Parent-Child (self-hosted).

Consulta la sección 6.

¿Cómo añado un plugin?

sudo /etc/netdata/edit-config go.d/mi-plugin.conf

Plugins disponibles: /usr/lib/netdata/conf.d/go.d/.

¿Cómo recibo alertas por email?

Configura health_alarm_notify.conf:

SEND_EMAIL="YES"
DEFAULT_RECIPIENT_EMAIL="admin@tudominio.com"

Consulta Guía de servidor de correo.

¿Qué es Machine Learning en Netdata?

Sistema que aprende patrones normales y detecta anomalías.

Ventaja: alerta de problemas sin configurar triggers manualmente.

¿Cómo actualizo Netdata?

Kickstart:

sudo /tmp/netdata-kickstart.sh --reinstall

APT:

sudo apt update && sudo apt upgrade netdata

¿Netdata funciona en Raspberry Pi?

Sí, perfectamente. Consumo muy bajo.

Consulta Guía completa de Raspberry Pi.

¿Netdata soporta Docker?

Sí. Detecta contenedores automáticamente.

Consulta Qué es Doc k er.

¿Netdata soporta Kubernetes?

Sí, con netdata-parent y helm chart.

Consulta Qué es Kubernetes.

¿Cuánto tiempo retiene datos?

Depende del modo:

dbengine: semanas/meses (según disco).
ram: solo en memoria.

Ejemplo: 1 GB disco ≈ 15 días.

¿Cómo hago backup?

bash

sudo systemctl stop netdata
sudo tar -czf netdata-$(date +%F).tar.gz /etc/netdata /var/lib/netdata
sudo systemctl start netdata

¿Netdata es seguro?

Sí, si lo proteges correctamente.

Buenas prácticas:

Nginx + SSL + Basic Auth.
Firewall restrictivo.
VPN para acceso remoto.
Actualizar regularmente.

Consulta Guía Completa de Ciberseguridad.

¿Cómo comparo Netdata con Prometheus?

Netdata: tiempo real, 1 comando, servidores individuales.
Prometheus: pull-based, cloud-native, Kubernetes.

Recomendación: ambos si tienes cloud.

¿Netdata consume ancho de banda?

Muy poco (~1-10 Mbps en el dashboard local).

Con Netdata Cloud: ~5-50 Mbps según número de métricas.

¿Puedo deshabilitar Netdata Cloud?

Sí. Puedes usarlo sin conectar al Cloud.

15. Conclusión

Netdata es una de las herramientas de monitorización más impresionantes del ecosistema Linux. Instalación en 1 comando, dashboards espectaculares, detección de anomalías con Machine Learning y bajísimo consumo.

Puntos clave: