Integración con New Relic

Conecta ReliaPulse a New Relic para monitorear el rendimiento de tu aplicación y métricas de infraestructura usando consultas NRQL.

Requisitos Previos

Cuenta de New Relic con acceso API
User API Key (no License Key)
Account ID

Configuración

Crear Integración

Ve a Dashboard → Configuración → Integraciones
Haz clic en Agregar Integración
Selecciona New Relic
Completa la configuración:

Campo	Descripción	Ejemplo
Nombre	Nombre descriptivo	`New Relic Producción`
API Key	User API Key	`NRAK-xxx...`
Account ID	Tu ID de cuenta NR	`1234567`
Región	Datacenter US o EU	`US`

Obtener tu API Key

Inicia sesión en New Relic
Ve a API Keys (desde el menú de usuario)
Crea o copia una clave de Usuario
La clave comienza con NRAK-

Encontrar tu Account ID

En New Relic, haz clic en tu nombre en la esquina inferior izquierda
Selecciona Administración → Gestión de Acceso
Tu Account ID se muestra ahí

Creación de Consultas de Métricas

Conceptos Básicos de NRQL

New Relic Query Language (NRQL) es similar a SQL:

SELECT average(duration) FROM Transaction WHERE appName = 'MiApp' SINCE 5 minutes ago

Consultas Comunes

Tiempo de Respuesta:

SELECT average(duration) FROM Transaction SINCE 5 minutes ago

Tasa de Errores:

SELECT percentage(count(*), WHERE error IS true) FROM Transaction SINCE 5 minutes ago

Throughput:

SELECT rate(count(*), 1 minute) FROM Transaction SINCE 5 minutes ago

Puntuación Apdex:

SELECT apdex(duration, 0.5) FROM Transaction SINCE 5 minutes ago

Métricas de Infraestructura

Uso de CPU:

SELECT average(cpuPercent) FROM SystemSample SINCE 5 minutes ago

Uso de Memoria:

SELECT average(memoryUsedPercent) FROM SystemSample SINCE 5 minutes ago

Uso de Disco:

SELECT average(diskUsedPercent) FROM StorageSample SINCE 5 minutes ago

Configuración de Consulta

Campo	Descripción
Nombre	Nombre visible de la métrica
Consulta	Expresión NRQL
Intervalo de Polling	Frecuencia de consulta (30s - 1h)
Unidad	Unidad de visualización (%, ms, req/s, etc.)
Umbral de Advertencia	Valor para disparar advertencia
Umbral Crítico	Valor para disparar alerta crítica

Métricas Multi-Serie

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

SELECT average(duration) FROM Transaction FACET appName SINCE 5 minutes ago

Configura:

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

Configuración de Umbrales

Operadores de Umbral

Operador	Descripción
Mayor Que	Alerta cuando valor > umbral
Menor Que	Alerta cuando valor < umbral
Igual A	Alerta cuando valor = umbral
Diferente De	Alerta cuando valor ≠ umbral

Ejemplos de Umbrales

Tiempo de Respuesta (mayor es peor):

Advertencia: 500 (>500ms)
Crítico: 1000 (>1s)
Operador: Mayor Que

Puntuación Apdex (menor es peor):

Advertencia: 0.85 (<0.85)
Crítico: 0.7 (<0.7)
Operador: Menor Que

Consejos de NRQL

Rangos de Tiempo

-- Tiempo relativo
SINCE 5 minutes ago
SINCE 1 hour ago
SINCE 1 day ago
 
-- Tiempo absoluto (evitar para polling)
SINCE '2026-01-01 00:00:00'

Filtrado

-- Condición única
WHERE appName = 'MiApp'
 
-- Múltiples condiciones
WHERE appName = 'MiApp' AND host LIKE 'prod%'
 
-- Excluir valores
WHERE error IS NOT true

Agregación

-- Promedio
SELECT average(duration) FROM Transaction
 
-- Percentiles
SELECT percentile(duration, 95) FROM Transaction
 
-- Conteo
SELECT count(*) FROM Transaction
 
-- Tasa por minuto
SELECT rate(count(*), 1 minute) FROM Transaction

Faceting (Agrupar Por)

-- Agrupar por atributo único
SELECT average(duration) FROM Transaction FACET appName
 
-- Agrupar por múltiples atributos
SELECT average(duration) FROM Transaction FACET appName, host

Solución de Problemas

Autenticación Fallida

Verifica que la API key sea una clave de Usuario (comienza con NRAK-)
Comprueba que la clave no haya expirado
Asegura que la clave tenga los permisos apropiados

Sin Datos Retornados

Prueba la consulta primero en el Query Builder de New Relic
Verifica que la cláusula SINCE cubra tiempo con datos
Comprueba que el tipo de evento exista (Transaction, SystemSample, etc.)

Cuenta No Encontrada

Verifica que el Account ID sea correcto
Comprueba la configuración de región (US vs EU)
Asegura que la API key tenga acceso a la cuenta

Timeout de Consulta

Simplifica la consulta (reduce el rango de tiempo)
Agrega cláusulas WHERE más específicas
Evita operaciones costosas en grandes conjuntos de datos

Seguridad

Usa User API keys, no License keys
Crea claves dedicadas para la integración de ReliaPulse
Rota las API keys periódicamente
Limita los permisos de la clave a solo lectura donde sea posible

Relacionado

Grafana Pingdom