Métricas

Conecta sistemas externos de monitoreo para mostrar métricas en tiempo real.

Vista General

ReliaPulse se integra con proveedores externos de métricas para:

• Mostrar métricas en tiempo real en páginas de estado
• Crear componentes tipo METRIC
• Establecer umbrales para actualizaciones automáticas de estado
• Calcular métricas derivadas de múltiples fuentes

Integraciones Soportadas

Configurar Integraciones

Crear una Integración

1. Navega a Configuración > Integraciones
2. Haz clic en "Añadir Integración"
3. Selecciona el proveedor
4. Configura autenticación
5. Prueba la conexión
6. Guarda

Datadog

Prometheus

New Relic

Consultas de Métricas

Crear una Consulta

1. Ve a la configuración de integración
2. Haz clic en "Añadir Consulta de Métricas"
3. Configura:

Sintaxis de Consultas

Datadog:

avg:system.cpu.user{*}
avg:aws.rds.dbload{*}
sum:http.requests{service:api}.as_count()

Prometheus:

avg(node_cpu_seconds_total{mode="idle"})
histogram_quantile(0.95, http_request_duration_seconds_bucket)
rate(http_requests_total[5m])

New Relic (NRQL):

SELECT average(cpuPercent) FROM SystemSample
SELECT count(*) FROM Transaction WHERE appName = 'MyApp'

Umbrales

Establece umbrales de advertencia y crítico:

Cuando los valores exceden umbrales:

• El estado cambia para reflejar severidad
• Notificaciones disparadas (si están configuradas)

Métricas Multi-Serie

Rastrea métricas divididas por tags (ej., por host, por región):

Habilitar Multi-Serie

1. Edita la consulta de métricas
2. Habilita "Modo Multi-Serie"
3. Configura:

Descubrimiento de Series

1. Guarda la consulta con multi-serie habilitado
2. Haz clic en "Descubrir Series"
3. El sistema consulta y crea entradas de series

Gestionar Series

Navega a la lista de series para:

• Ver todas las series descubiertas
• Establecer nombres de visualización personalizados
• Habilitar/deshabilitar series individuales
• Ver gráficos por serie

Componentes METRIC

Crea componentes que muestran valores de métricas:

Crear un Componente METRIC

1. Navega a Componentes
2. Haz clic en "Añadir Componente"
3. Selecciona Tipo: METRIC
4. Elige:
   • Vincular a consulta existente, o
   • Crear nueva consulta inline
5. Configura umbrales
6. Guarda

Vincular Consultas Existentes

1. Habilita "Vincular a Existente"
2. Selecciona la integración
3. Elige la consulta
4. Opcionalmente selecciona una serie específica

Métricas Calculadas

Combina múltiples métricas con fórmulas:

Crear una Métrica Calculada

1. Navega a Configuración > Métricas Calculadas
2. Haz clic en "Añadir Métrica Calculada"
3. Configura:

Fuentes de Variables

Ejemplo de Fórmula

Calcular porcentaje de uso de conexiones DB:

(current_connections / max_connections) * 100

Variables:

• current_connections → MetricsQuery (Datadog)
• max_connections → Constante (400)

Operaciones Soportadas

Valores Extraídos

Obtén valores específicos de respuestas ENDPOINT:

Configurar Extracción

1. Edita un componente ENDPOINT
2. Ve a "Valores Extraídos"
3. Haz clic en "Añadir Extracción"
4. Configura:

Ejemplo

Para una respuesta:

{
  "status": "healthy",
  "metrics": {
    "connections": 42,
    "latency_ms": 15.3
  }
}

Extracciones:

• $.metrics.connections → 42
• $.metrics.latency_ms → 15.3

Mostrar Métricas

En Páginas de Estado

Añade widgets de métricas:

1. Edita la página de estado
2. Añade widget "Gráfico de Métricas"
3. Selecciona métrica a mostrar
4. Configura tipo de gráfico y rango de tiempo

Tipos de Gráfico

Rangos de Tiempo

• Última hora
• Últimas 24 horas
• Últimos 7 días
• Últimos 30 días

Acceso API

Listar Consultas

curl http://localhost:3000/api/v1/integrations/{id}/metrics \
  -H "Authorization: Bearer sk_live_xxx"

Crear Consulta

curl -X POST http://localhost:3000/api/v1/integrations/{id}/metrics \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Uso de CPU",
    "query": "avg:system.cpu.user{*}",
    "pollingInterval": 60,
    "warningThreshold": 70,
    "criticalThreshold": 90
  }'

Obtener Puntos de Datos

curl "http://localhost:3000/api/v1/integrations/{id}/metrics/{queryId}/data?from=2026-01-01&to=2026-01-22" \
  -H "Authorization: Bearer sk_live_xxx"

Solución de Problemas

No Se Muestran Datos

1. Verifica credenciales de integración
2. Verifica sintaxis de consulta
3. Asegura que polling está habilitado
4. Verifica que el worker está corriendo

Datos Retrasados

1. Aumenta intervalo de polling
2. Verifica latencia del proveedor de métricas
3. Verifica configuración de rango de tiempo

Umbrales No Se Disparan

1. Verifica valores de umbral
2. Verifica unidades de métrica
3. Asegura que notificaciones están configuradas

Mejores Prácticas

Diseño de Consultas

• Usa nombres significativos
• Documenta consultas complejas
• Agrega apropiadamente
• Considera cardinalidad

Intervalos de Polling

• 60 segundos para la mayoría de métricas
• 15-30 segundos para métricas críticas
• 5+ minutos para métricas históricas

Umbrales

• Establece basado en datos históricos
• Deja margen antes de crítico
• Revisa y ajusta regularmente

Documentación Relacionada

• Integraciones - Guías detalladas de configuración
• Componentes - Tipo METRIC
• Páginas de Estado - Widgets de métricas