Integración con Prometheus

Conecta ReliaPulse a tu servidor Prometheus para monitorear métricas y crear alertas basadas en consultas PromQL.

Requisitos Previos

• Servidor Prometheus accesible desde ReliaPulse
• Endpoint de API habilitado en Prometheus
• Conectividad de red entre los servicios

Configuración

Crear Integración

1. Ve a Dashboard → Configuración → Integraciones
2. Haz clic en Agregar Integración
3. Selecciona Prometheus
4. Completa la configuración:

Probar Conexión

Haz clic en Probar Conexión para verificar que ReliaPulse puede conectarse a tu servidor Prometheus.

Creación de Consultas de Métricas

Consulta Básica

1. Ve a la configuración de tu integración
2. Haz clic en la pestaña Métricas
3. Haz clic en Agregar Consulta
4. Ingresa tu consulta PromQL

Ejemplo - Uso de CPU:

avg(rate(node_cpu_seconds_total{mode!="idle"}[5m])) * 100

Ejemplo - Uso de Memoria:

(1 - (node_memory_MemAvailable_bytes / node_memory_MemTotal_bytes)) * 100

Ejemplo - Tasa de Requests HTTP:

sum(rate(http_requests_total[5m]))

Configuración de Consulta

Métricas Multi-Serie

Para consultas que retornan múltiples series de tiempo, habilita Modo Multi-Serie:

# Retorna una serie por instancia
node_cpu_seconds_total{mode="idle"}

Configura:

• Agrupar Por Tags: instance, job
• Agregación: AVG, SUM, MAX, MIN
• Máx Series: Limitar número de series rastreadas

Configuración de Umbrales

Operadores de Umbral

Ejemplos de Umbrales

Uso de CPU (mayor es peor):

• Advertencia: 70 (>70%)
• Crítico: 90 (>90%)
• Operador: Mayor Que

Memoria Disponible (menor es peor):

• Advertencia: 1073741824 (<1GB)
• Crítico: 536870912 (<512MB)
• Operador: Menor Que

Vincular a Componentes

Conecta métricas a componentes para actualizaciones automáticas de estado:

1. Edita un componente
2. Establece el tipo como METRIC
3. Selecciona tu integración Prometheus
4. Elige o crea una consulta de métricas
5. Configura los umbrales

Cuando la métrica excede el umbral crítico:

• El estado del componente cambia a MAJOR_OUTAGE
• Se crea un incidente automáticamente (si está habilitado)
• Se envían notificaciones a los suscriptores

Consejos de PromQL

Rate vs Instant

Usa rate() para métricas de contador:

# Bueno - muestra requests por segundo
rate(http_requests_total[5m])

# Malo - muestra conteo total (siempre incrementando)
http_requests_total

Agregación

Agregar entre instancias:

# Promedio de todos los nodos
avg(node_load1)

# Suma de todos los requests
sum(rate(http_requests_total[5m]))

# Latencia máxima de cualquier pod
max(http_request_duration_seconds)

Filtrado por Labels

Filtrar por etiquetas:

# Servicio específico
http_requests_total{service="api"}

# Excluir códigos de estado
http_requests_total{status!~"5.."}

# Múltiples condiciones
http_requests_total{service="api", method="POST"}

Rangos de Tiempo

Rangos comunes:

• [1m] - Último minuto
• [5m] - Últimos 5 minutos (recomendado para rate)
• [1h] - Última hora
• [1d] - Último día

Solución de Problemas

Conexión Fallida

• Verifica que la URL de Prometheus sea correcta
• Comprueba la conectividad de red
• Verifica las credenciales de autenticación
• Asegúrate de que la API de Prometheus esté habilitada

Sin Datos Retornados

• Prueba la consulta primero en la UI de Prometheus
• Verifica el rango de tiempo de los datos
• Comprueba la ortografía del nombre de la métrica
• Revisa los valores de las etiquetas

SSRF Bloqueado

ReliaPulse bloquea requests a redes privadas por seguridad. Asegúrate de que tu servidor Prometheus sea accesible en una IP pública o configura el acceso de red apropiado.

Seguridad

Seguridad de Red

• Usa HTTPS para conexiones a Prometheus
• Considera VPN o acceso a red privada
• Limita la API de Prometheus a consultas de solo lectura

Autenticación

Prometheus soporta:

• Autenticación básica
• Token Bearer (vía proxy inverso)
• mTLS (vía proxy inverso)

Relacionado

• Resumen de Métricas
• Componentes
• Alertas