Integración con Grafana

Conecta ReliaPulse a Grafana para aprovechar sus capacidades de alertas unificadas y datasources.

Requisitos Previos

• Instancia de Grafana (8.0+ recomendado)
• Acceso API habilitado
• Cuenta de servicio o API key

Configuración

Crear Integración

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

Generar API Key

En Grafana:

1. Ve a Administración → Cuentas de Servicio
2. Crea una nueva cuenta de servicio
3. Agrega un token con rol Viewer
4. Copia el token a ReliaPulse

Creación de Consultas de Métricas

Grafana soporta múltiples datasources. El formato de consulta depende de tu datasource.

Datasource Prometheus

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

Datasource InfluxDB

from(bucket: "metrics")
  |> range(start: -5m)
  |> filter(fn: (r) => r._measurement == "cpu")
  |> mean()

Datasource Elasticsearch

Configura mediante el constructor de consultas de Grafana.

Integración de Alertas Unificadas

Receptor Webhook

Configura Grafana para enviar alertas a ReliaPulse:

1. En Grafana, ve a Alertas → Puntos de Contacto
2. Agrega un nuevo punto de contacto
3. Selecciona Webhook
4. Ingresa la URL del webhook de ReliaPulse:

   https://status.example.com/api/webhooks/grafana/{token}

Reglas de Alerta

Las alertas de Grafana pueden automáticamente:

• Crear incidentes en ReliaPulse
• Actualizar el estado de componentes
• Disparar notificaciones on-call

Payload de Alerta

ReliaPulse procesa el payload de alerta de Grafana:

{
  "status": "firing",
  "alerts": [
    {
      "status": "firing",
      "labels": {
        "alertname": "HighCPU",
        "severity": "critical"
      },
      "annotations": {
        "summary": "Uso de CPU superior al 90%"
      }
    }
  ]
}

Embeber Dashboards

Embeber Paneles

Los paneles de Grafana se pueden embeber en widgets personalizados:

1. En Grafana, abre el panel
2. Compartir → Embeber
3. Copia el código iframe
4. Usa en el widget HTML personalizado de ReliaPulse

Sincronización de Rango de Tiempo

Usa parámetros URL para rangos de tiempo dinámicos:

&from=now-1h&to=now

Métricas Multi-Serie

Para consultas que retornan múltiples series:

1. Habilita Modo Multi-Serie en la consulta de métricas
2. Configura los tags de agrupación
3. Establece el método de agregación

Solución de Problemas

Conexión Fallida

• Verifica que la URL de Grafana incluya el protocolo (https://)
• Comprueba que la API key no haya expirado
• Asegura la conectividad de red

Errores de Consulta

• Prueba la consulta primero en Grafana
• Verifica la configuración del datasource
• Comprueba que el datasource sea accesible

Webhook No Recibido

• Verifica la configuración del punto de contacto
• Comprueba que la URL del webhook sea correcta
• Revisa los logs del webhook en ReliaPulse

Seguridad

• Usa HTTPS para todas las conexiones
• Rota las API keys periódicamente
• Usa cuentas de servicio en lugar de tokens de usuario
• Limita los permisos al rol de viewer

Relacionado

• Integración con Prometheus
• Resumen de Métricas