Despliegue de Grafana

Qué configuramos y por qué

En el mundo moderno, donde las aplicaciones y servicios generan enormes volúmenes de datos, el registro centralizado se convierte no solo en una comodidad, sino en una necesidad. Desplegaremos Grafana Loki — un sistema de agregación de logs escalable horizontalmente, de alta disponibilidad y multi-inquilino, desarrollado por Grafana Labs. Loki se diferencia de otros sistemas de registro en que solo indexa los metadatos (etiquetas) de los logs, y los logs en sí los almacena de forma comprimida. Esto lo hace muy eficiente en términos de uso de recursos y costo de almacenamiento.

En el marco de este tutorial, configuraremos una pila completa para la recopilación, almacenamiento y acceso centralizado a los logs:

• Grafana Loki: El núcleo del sistema que recibe los logs, los indexa por etiquetas y los almacena.
• Promtail: Agente que se instala en cada servidor donde se generan los logs. Monitorea los archivos de logs especificados, les aplica etiquetas y los envía a Loki.
• Nginx: Actuará como proxy inverso para Loki, proporcionando acceso seguro a través de HTTPS y la capacidad de alojar Loki en puertos estándar.
• Systemd: Utilizaremos Systemd para gestionar los servicios de Loki y Promtail, asegurando su inicio automático y monitoreo.

Al final, el lector obtendrá un sistema de registro centralizado completamente funcional. Esto permitirá recopilar logs de todas sus aplicaciones y servicios en un VPS (o varios VPS), visualizarlos en la cómoda interfaz de Grafana (que se puede conectar a Loki), encontrar rápidamente los eventos necesarios, depurar problemas y monitorear el estado del sistema. Esto simplifica significativamente la gestión de la infraestructura, especialmente cuando tiene varios servicios o microservicios desplegados en uno o diferentes servidores.

Alternativas: Cloud-managed vs. Self-hosted en un VPS

Existen varios enfoques para el registro centralizado:

• Servicios Cloud-managed (SaaS): Plataformas como Datadog, Splunk Cloud, Logz.io, AWS CloudWatch, Google Cloud Logging, Azure Monitor. Ofrecen soluciones listas para usar con configuración mínima, alta disponibilidad, escalabilidad y una rica funcionalidad. Ventajas: Facilidad de uso, no es necesario gestionar la infraestructura, potentes herramientas analíticas. Desventajas: Alto costo, especialmente con grandes volúmenes de logs; posibles problemas de privacidad de datos, ya que los logs se almacenan con un proveedor externo; menor control sobre la infraestructura.
• Soluciones Self-hosted en un servidor dedicado/VPS: Este es el enfoque que implementamos con Loki. Usted controla completamente todo el sistema, desde la infraestructura hasta la configuración. Ventajas: Control total sobre los datos y la seguridad, costo potencialmente mucho menor para grandes volúmenes de logs (solo se paga por el VPS/dedicado), flexibilidad en la configuración para necesidades específicas. Desventajas: Requiere conocimientos técnicos para el despliegue y mantenimiento, la responsabilidad de la disponibilidad y escalabilidad recae en usted.

La elección de una solución self-hosted en un VPS con Loki es especialmente relevante para propietarios de VPS, desarrolladores, fundadores individuales y entusiastas que desean tener control total sobre su infraestructura, optimizar costos y no depender de proveedores de nube externos. Loki, gracias a su diseño, es una excelente opción para esta tarea, ya que es menos exigente en recursos en comparación con otros sistemas, como la pila ELK (Elasticsearch, Logstash, Kibana), especialmente en términos de consumo de RAM y espacio en disco debido a la indexación solo de metadatos.

Qué configuración de VPS se necesita para esta tarea

La elección de un VPS adecuado para Grafana Loki depende del volumen de logs que planee recopilar y del período de su almacenamiento. Loki comprime los logs de manera eficiente, pero aún requiere suficiente espacio en disco y recursos moderados de CPU/RAM para la indexación y las consultas.

Requisitos mínimos para Loki y Promtail (para proyectos pequeños, hasta 100 GB de logs al mes)

• CPU: 2 núcleos. Loki y Promtail no sobrecargan mucho el procesador en modo de espera, pero las cargas pico durante la indexación o consultas complejas pueden requerir más.
• RAM: 4 GB. Loki puede ser bastante exigente con la memoria para grandes volúmenes de consultas o el almacenamiento a largo plazo de índices en memoria. Promtail consume poco.
• Disco: NVMe SSD de 100 GB. La velocidad del disco es crítica para la escritura de logs y la ejecución de consultas. El volumen depende del volumen de logs y de su política de almacenamiento. Para 100 GB de logs al mes y un almacenamiento de 3 meses, se necesitarán aproximadamente 300 GB.
• Red: 100 Mbps. Para la transferencia de logs de Promtail a Loki y el acceso a la UI.

Plan de VPS recomendado para proyectos medianos (hasta 500 GB de logs al mes, varias fuentes)

Para tareas más serias, donde recopila logs de varias aplicaciones o servidores, y espera hasta 500 GB de logs al mes, debe considerar una configuración más potente:

• CPU: 4 núcleos.
• RAM: 8 GB.
• Disco: NVMe SSD de 500 GB a 1 TB.
• Red: 1 Gbps.

Este plan proporcionará suficiente rendimiento para procesar consultas y almacenar un mayor volumen de datos. Puede considerar un VPS con las características indicadas para el despliegue de su sistema de registro centralizado.

Cuándo se necesita un dedicado, no un VPS

Un servidor dedicado (dedicated server) se vuelve preferible cuando:

• Volúmenes muy grandes de logs: Si planea recopilar terabytes de logs al mes (por ejemplo, de un gran clúster de Kubernetes o de muchos microservicios).
• Alto rendimiento de consultas: Se requiere acceso instantáneo a los logs y la ejecución de consultas analíticas complejas en enormes conjuntos de datos.
• Recursos garantizados: Necesita recursos de CPU, RAM y disco 100% garantizados, sin el efecto de "vecindad" que a veces se encuentra en los VPS.
• Requisitos estrictos de almacenamiento: Necesidad de arreglos RAID para aumentar la fiabilidad del subsistema de disco o requisitos específicos para el tipo de discos (por ejemplo, HDD de alto rendimiento para el almacenamiento de logs archivados, junto con SSD para datos "calientes").
• Aislamiento físico: Para cumplir con estrictas normas de seguridad y cumplimiento (por ejemplo, PCI DSS, HIPAA), donde se requiere un aislamiento físico completo.

Para la mayoría de los desarrolladores individuales, fundadores en solitario y equipos pequeños, un VPS será más que suficiente y más rentable. Sin embargo, si ve que su volumen de logs supera 1-2 TB al mes, o el rendimiento del VPS comienza a sufrir, el cambio a un dedicado adecuado estará justificado.

Ubicación del VPS: qué factores influye

La elección de la ubicación del VPS influye en varios aspectos clave:

• Latencia (Latency): Cuanto más cerca esté el VPS de las fuentes de logs (sus otros servidores, clientes de aplicaciones), menor será la latencia en la transmisión de logs. Esto es importante para el monitoreo operativo y la reducción de la carga de red.
• Cumplimiento normativo: En algunas jurisdicciones existen requisitos estrictos para el almacenamiento de datos, incluidos los logs. Asegúrese de que la ubicación seleccionada cumpla con las leyes de privacidad de datos aplicables (por ejemplo, GDPR en Europa).
• Costo: Los precios de los VPS pueden variar según la región.
• Disponibilidad: Elija regiones con buena infraestructura de red y alta disponibilidad de centros de datos.

Idealmente, elija una ubicación que esté geográficamente cerca de sus servidores principales que generan logs para minimizar las latencias de red y garantizar una rápida transferencia de datos.

Preparación del servidor

Preparación del servidor

Antes de proceder con la instalación de Loki y Promtail, es necesario realizar una configuración básica de su nuevo VPS. Esto aumentará la seguridad y la comodidad de uso.

Se asume que está utilizando la distribución Ubuntu Server 22.04 LTS o 24.04 LTS, que es una opción popular para VPS.

1. Conexión por SSH y actualización del sistema

Conéctese a su servidor por SSH utilizando los datos proporcionados por el proveedor. Normalmente, esto es el usuario root y la contraseña.

ssh root@SU_DIRECCIÓN_IP

Después de iniciar sesión correctamente, actualice la lista de paquetes y los paquetes instalados a las últimas versiones:

sudo apt update && sudo apt upgrade -y

2. Creación de un nuevo usuario con permisos sudo

Trabajar con la cuenta de root no es seguro. Crearemos un nuevo usuario y le otorgaremos permisos sudo.

adduser lokiadmin
usermod -aG sudo lokiadmin

Ahora, salga de la sesión de root e inicie sesión como el nuevo usuario:

exit
ssh lokiadmin@SU_DIRECCIÓN_IP

3. Configuración de la autenticación por claves SSH

Para mejorar la seguridad, se recomienda utilizar claves SSH en lugar de contraseñas. Si aún no tiene claves, genérelas en su máquina local:

ssh-keygen -t rsa -b 4096

Copie la clave pública al servidor (reemplace lokiadmin y SU_DIRECCIÓN_IP):

ssh-copy-id lokiadmin@SU_DIRECCIÓN_IP

Ahora puede deshabilitar la autenticación por contraseña para SSH. Edite el archivo /etc/ssh/sshd_config:

sudo nano /etc/ssh/sshd_config

Encuentre y modifique las siguientes líneas:

#PasswordAuthentication yes
PasswordAuthentication no
#PermitRootLogin yes
PermitRootLogin no

Guarde los cambios (Ctrl+O, Enter) y salga (Ctrl+X). Reinicie el servicio SSH:

sudo systemctl restart sshd

Después de esto, asegúrese de que puede iniciar sesión con la clave SSH antes de cerrar la sesión actual.

4. Configuración del firewall (UFW)

UFW (Uncomplicated Firewall) es una interfaz conveniente para iptables. Instálelo y configúrelo:

sudo apt install ufw -y
sudo ufw allow OpenSSH
sudo ufw allow http
sudo ufw allow https
sudo ufw enable
sudo ufw status

Verifique el estado. Los puertos 22 (SSH), 80 (HTTP) y 443 (HTTPS) deben estar permitidos. Más adelante, añadiremos un puerto para Loki.

5. Instalación de Fail2Ban

Fail2Ban ayuda a proteger contra ataques de fuerza bruta, bloqueando las direcciones IP que realizan demasiados intentos de inicio de sesión fallidos.

sudo apt install fail2ban -y
sudo systemctl enable fail2ban
sudo systemctl start fail2ban

Fail2Ban protege SSH por defecto. Puede configurarlo editando el archivo /etc/fail2ban/jail.local (créelo si no existe) y añadiendo sus propias reglas.

6. Instalación de utilidades básicas

Instale algunas utilidades útiles que le serán de ayuda durante el proceso de configuración y depuración:

sudo apt install curl wget git nano htop unzip -y

Ahora su servidor está listo para el despliegue de Grafana Loki y Promtail.

Instalación de software — paso a paso

Instalaremos Loki y Promtail descargando los archivos binarios de los repositorios oficiales de GitHub y configurándolos como servicios de Systemd. Nginx se instalará desde el repositorio APT.

Las versiones actuales del software para 2026 serán condicionales, pero utilizaremos las últimas versiones estables disponibles en el momento de la generación.

Instalación de Grafana Loki

Crearemos los directorios para Loki y descargaremos el archivo binario actual.

# 1. Creamos los directorios para Loki
sudo mkdir -p /etc/loki
sudo mkdir -p /var/lib/loki
sudo chown -R lokiadmin:lokiadmin /var/lib/loki # Damos permisos de escritura al usuario actual

# 2. Nos movemos al directorio temporal
cd /tmp

# 3. Descargamos la última versión estable de Loki (por ejemplo, v3.1.0 para 2026)
# Siempre verifique la versión actual en GitHub: https://github.com/grafana/loki/releases
LOKI_VERSION="3.1.0" # Indicamos la versión actual
wget "https://github.com/grafana/loki/releases/download/v${LOKI_VERSION}/loki-linux-amd64.zip"

# 4. Descomprimimos el archivo
unzip "loki-linux-amd64.zip"

# 5. Movemos el archivo binario a /usr/local/bin
sudo mv loki-linux-amd64 /usr/local/bin/loki

# 6. Nos aseguramos de que el archivo sea ejecutable
sudo chmod a+x /usr/local/bin/loki

# 7. Verificamos la versión
loki --version

Ahora crearemos el usuario loki, bajo el cual se ejecutará el servicio, para asegurar el principio de mínimos privilegios.

# 1. Creamos el usuario de sistema loki sin directorio personal ni shell
sudo useradd --system --no-create-home --shell /bin/false loki

# 2. Transferimos la propiedad del directorio de datos de Loki al usuario loki
sudo chown -R loki:loki /var/lib/loki

Instalación de Promtail

De manera similar a Loki, descargamos e instalamos Promtail.

# 1. Creamos el directorio para Promtail
sudo mkdir -p /etc/promtail

# 2. Nos movemos al directorio temporal
cd /tmp

# 3. Descargamos la última versión estable de Promtail (por ejemplo, v3.1.0 para 2026)
# Siempre verifique la versión actual en GitHub: https://github.com/grafana/loki/releases
PROMTAIL_VERSION="3.1.0" # Indicamos la versión actual
wget "https://github.com/grafana/loki/releases/download/v${PROMTAIL_VERSION}/promtail-linux-amd64.zip"

# 4. Descomprimimos el archivo
unzip "promtail-linux-amd64.zip"

# 5. Movemos el archivo binario a /usr/local/bin
sudo mv promtail-linux-amd64 /usr/local/bin/promtail

# 6. Nos aseguramos de que el archivo sea ejecutable
sudo chmod a+x /usr/local/bin/promtail

# 7. Verificamos la versión
promtail --version

Crearemos el usuario promtail para ejecutar el servicio.

# 1. Creamos el usuario de sistema promtail sin directorio personal ni shell
sudo useradd --system --no-create-home --shell /bin/false promtail

Instalación de Nginx y Certbot

Nginx actuará como proxy inverso y proporcionará acceso HTTPS a Loki. Certbot ayudará a automatizar la emisión y renovación de certificados TLS de Let's Encrypt.

# 1. Instalamos Nginx desde los repositorios de Ubuntu
sudo apt install nginx -y

# 2. Iniciamos Nginx y lo añadimos al inicio automático
sudo systemctl start nginx
sudo systemctl enable nginx

# 3. Instalamos Certbot y el plugin para Nginx
sudo apt install certbot python3-certbot-nginx -y

En este punto, los componentes principales están instalados. Ahora pasaremos a su configuración.