Saltar al contenido principal
Versión: 0.4 · actual

Conectar New Relic

Guía paso a pasoRevisada el 11 de octubre de 2026
Se aplica a:Excubius 0.4Roles: Administrador de entidad
PlanesFree · Core · Pro · EnterpriseImplementaciónEn tus servidores

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.newrelic está activada. Consulta Fuentes.

Lo que lee Excubius​

New Relic se lee mediante NerdGraph, solo con consultas GraphQL, nunca con mutaciones.

FaseQuéIntervalo predeterminado
InventarioBú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 entidades15 minutos
MétricasLos 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 Relic5 minutos
AlertasIssues de AI en los estados CREATED y ACTIVATED de los últimos 30 días, una alerta por issue y entidad5 minutos en Sondeo; conciliación cada 15 minutos en Híbrido

Preparar New Relic​

  1. 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.
  2. 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.
  3. 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​

  1. Abre Configuración › Fuentes, selecciona Añadir una fuente y elige New Relic.
  2. En General, escribe un Nombre, como New Relic Ciguapa, y elige la Entidad.
  3. En Conexión, escribe el ID de cuenta, la Región y la Clave de API de usuario.
  4. 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.
  5. 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.
  6. En Modo de ingesta, deja Híbrido (recomendado).
  7. Si quieres, en Webhook, escribe un Secreto del webhook que New Relic enviará con cada webhook.
  8. 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:

  1. 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> o X-Webhook-Secret: <secret>.

  2. 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:

    {
    "issueId": {{ json issueId }},
    "state": {{ json state }},
    "priority": {{ json priority }},
    "title": {{ json annotations.title.[0] }},
    "issuePageUrl": {{ json issuePageUrl }},
    "triggerEvent": {{ json triggerEvent }},
    "createdAt": {{ createdAt }},
    "updatedAt": {{ updatedAt }},
    "conditionNames": {{ json accumulations.conditionName }},
    "policyNames": {{ json accumulations.policyName }},
    "entityGuids": {{ json entitiesData.ids }},
    "entityNames": {{ json entitiesData.names }}
    }

    La plantilla predeterminada de New Relic también funciona.

  3. Notifica en activated y closed, para que las alertas también se cierren en Excubius.

Probar y sincronizar​

  1. En la página de la fuente, selecciona Probar. Cada lectura aparece con su resultado: credenciales, cuenta, inventario y alertas.
  2. 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​

ModoObtienes
HíbridoLos 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
SondeoTodo por sondeo. Los issues aparecen dentro del intervalo de alertas, 5 minutos de forma predeterminada
Solo webhookSolo los issues, sin inventario ni métricas, y sin ninguna clave guardada