Conectar New Relic
Conecta una cuenta de New Relic para traer a Excubius sus hosts de infraestructura, sus servicios APM y sus monitores sintéticos, con sus métricas clave y sus issues abiertos. Esta guía muestra la configuración con privilegios mínimos del lado de New Relic, cómo agregar la fuente y cómo enviar los issues por webhook.
Antes de empezar
- Necesitas el rol Administrador de entidad en la entidad a la que pertenece la cuenta, por ejemplo Ciguapa Inc..
- En New Relic, puedes crear un usuario o un usuario de servicio, una clave de API y un flujo de trabajo en la cuenta.
- La función
sources.newrelicestá activada. Consulta Fuentes.
Lo que lee Excubius
New Relic se lee mediante NerdGraph, solo con consultas GraphQL, nunca con mutaciones.
| Fase | Qué | Intervalo predeterminado |
|---|---|---|
| Inventario | Búsqueda de entidades en la cuenta: hosts de infraestructura (Windows, Linux o macOS según su etiqueta de sistema operativo), aplicaciones APM y monitores sintéticos, opcionalmente acotada por una condición de búsqueda de entidades | 15 minutos |
| Métricas | Los resúmenes que devuelve la misma búsqueda, sin NRQL, así que consumen poca cuota. La CPU, la memoria y el disco de los hosts alimentan las comprobaciones de hosts Windows y Linux; APM y las pruebas sintéticas alimentan las comprobaciones de New Relic | 5 minutos |
| Alertas | Issues de AI en los estados CREATED y ACTIVATED de los últimos 30 días, una alerta por issue y entidad | 5 minutos en Sondeo; conciliación cada 15 minutos en Híbrido |
Preparar New Relic
- Crea un usuario, o usa un usuario de servicio, cuyo rol sea de solo lectura en la cuenta, por ejemplo el rol integrado All product read only.
- Con la sesión iniciada como ese usuario, abre API keys y crea una clave de tipo User. Copia la clave; empieza por
NRAK-. Las claves de licencia, de navegador y de ingesta no funcionan. - Anota el ID de cuenta y el centro de datos, US o EU.
Esta clave de usuario es todo lo que Excubius necesita para el sondeo. Una fuente en modo Solo webhook no necesita ni la clave ni el ID de cuenta.
Agregar la fuente
- Abre Configuración › Fuentes, selecciona Añadir una fuente y elige New Relic.
- En General, escribe un Nombre, como New Relic Ciguapa, y elige la Entidad.
- En Conexión, escribe el ID de cuenta, la Región y la Clave de API de usuario.
- En Qué leer, conserva Hosts, Servicios APM, Monitores sintéticos y Métricas clave, o desmarca lo que no quieras. Sin Métricas clave, las entidades llegan sin sus métricas.
- Si quieres, escribe un Filtro de entidades, una condición de búsqueda de entidades de New Relic como
tags.environment = 'production'. Úsalo cuando una cuenta abarca varios clientes. - En Modo de ingesta, deja Híbrido (recomendado).
- Si quieres, en Webhook, escribe un Secreto del webhook que New Relic enviará con cada webhook.
- Selecciona Crear la fuente y copia la URL del webhook. Solo se muestra una vez.
Enviar los issues por webhook
En el modo Híbrido o Solo webhook, configura New Relic para que envíe sus issues:
-
En New Relic, abre Alerts › Destinations y agrega un destino Webhook con la URL que mostró Excubius. Si configuraste un secreto del webhook, agrega el encabezado
Authorization: Bearer <secret>oX-Webhook-Secret: <secret>. -
Crea un flujo de trabajo (workflow) que filtre los issues que quieras en Excubius y notifique a ese destino con esta plantilla de carga útil:
La plantilla predeterminada de New Relic también funciona.
-
Notifica en activated y closed, para que las alertas también se cierren en Excubius.
Probar y sincronizar
- En la página de la fuente, selecciona Probar. Cada lectura aparece con su resultado: credenciales, cuenta, inventario y alertas.
- Selecciona Sincronizar ahora para traer el inventario, las métricas y las alertas sin esperar.
Los hosts aparecen como recursos, emparejados con los mismos servidores de otras fuentes. Los servicios APM aparecen como recursos Aplicación (APM) y los monitores como recursos Monitor sintético, con sus comprobaciones. Los issues abiertos aparecen en la Bandeja de alertas, con un enlace a New Relic.
Elegir el modo
| Modo | Obtienes |
|---|---|
| Híbrido | Los issues al instante por webhook; el inventario y las métricas por sondeo; una conciliación que cierra lo que se cerró en New Relic mientras se perdía un webhook |
| Sondeo | Todo por sondeo. Los issues aparecen dentro del intervalo de alertas, 5 minutos de forma predeterminada |
| Solo webhook | Solo los issues, sin inventario ni métricas, y sin ninguna clave guardada |