Aller au contenu principal
Version : 0.4 · actuelle

Connecter New Relic

Guide pratiqueRévisé le 11 octobre 2026
S'applique à :Excubius 0.4Rôles : Administrateur d'entité
PlansFree · Core · Pro · EnterpriseDéploiementAuto-hébergé

Connectez un compte New Relic pour faire entrer dans Excubius ses hôtes d'infrastructure, ses services APM et ses moniteurs synthétiques, avec leurs signaux clés et leurs incidents ouverts. Ce guide présente la configuration de moindre privilège côté New Relic, la façon d'ajouter la source et celle d'envoyer les incidents par webhook.

Avant de commencer​

  • Vous devez disposer du rôle Entity admin sur l'entité à laquelle appartient le compte, par exemple Combray SA.
  • Dans New Relic, vous pouvez créer un utilisateur ou un utilisateur de service, une clé d'API et un workflow sur le compte.
  • La fonctionnalité sources.newrelic est activée. Consultez Sources.

Ce qu'Excubius lit​

Excubius lit New Relic par NerdGraph, avec uniquement des requêtes GraphQL, jamais de mutations.

PhaseContenuIntervalle par défaut
InventaireRecherche d'entités dans le compte : hôtes d'infrastructure (Windows, Linux ou macOS d'après leur étiquette de système d'exploitation), applications APM et moniteurs synthétiques, éventuellement restreints par une condition de recherche d'entités15 minutes
MétriquesLes résumés que renvoie la même recherche, sans NRQL, de sorte qu'ils consomment peu de quota. Le processeur, la mémoire et le disque des hôtes alimentent les vérifications des hôtes Windows et Linux ; APM et les moniteurs synthétiques alimentent les vérifications New Relic5 minutes
AlertesIncidents (AI issues) à l'état CREATED et ACTIVATED des 30 derniers jours, une alerte par incident et par entité5 minutes en Polling ; rapprochement toutes les 15 minutes en Hybrid

Préparer New Relic​

  1. Créez un utilisateur, ou utilisez un utilisateur de service, dont le rôle est read only sur le compte, par exemple le rôle intégré All product read only.
  2. Après vous être connecté avec cet utilisateur, ouvrez API keys et créez une clé de type User. Copiez la clé ; elle commence par NRAK-. Les clés de licence, de navigateur et d'ingestion ne conviennent pas.
  3. Notez l'account ID (identifiant du compte) et le centre de données, US ou EU.

Cette clé utilisateur est tout ce dont Excubius a besoin pour interroger New Relic. Une source en mode Webhook only n'a besoin ni de la clé ni de l'ID du compte.

Ajouter la source​

  1. Ouvrez Settings › Sources, sélectionnez Add a source et choisissez New Relic.
  2. Sous General, saisissez un Name, tel que New Relic Combray, et choisissez l'Entity.
  3. Sous Connection, saisissez l'Account ID, la Region et la User API key.
  4. Sous What to read, conservez Hosts, APM services, Synthetic monitors et Golden metrics, ou désélectionnez ce que vous ne voulez pas. Sans Golden metrics, les entités arrivent sans leurs métriques.
  5. Si vous le souhaitez, saisissez un Entity filter, une condition de recherche d'entités New Relic telle que tags.environment = 'production'. Utilisez-le lorsqu'un même compte couvre plusieurs clients.
  6. Sous Ingest mode, conservez Hybrid (recommended).
  7. Si vous le souhaitez, sous Webhook, saisissez un Webhook secret que New Relic enverra avec chaque webhook.
  8. Sélectionnez Create source et copiez l'URL du webhook. Elle n'est affichée qu'une seule fois.

Envoyer les incidents par webhook​

En mode Hybrid ou Webhook only, configurez New Relic pour qu'il envoie ses incidents :

  1. Dans New Relic, ouvrez Alerts › Destinations et ajoutez une destination Webhook avec l'URL qu'Excubius a affichée. Si vous avez défini un secret de webhook, ajoutez l'en-tête Authorization: Bearer <secret> ou X-Webhook-Secret: <secret>.

  2. Créez un workflow qui filtre les incidents que vous voulez voir dans Excubius et qui notifie cette destination avec ce modèle de charge utile :

    {
    "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 }}
    }

    Le modèle par défaut de New Relic fonctionne aussi.

  3. Notifiez sur activated et closed, afin que les alertes se ferment aussi dans Excubius.

Tester et synchroniser​

  1. Sur la page de la source, sélectionnez Test. Chaque lecture est listée avec son résultat : informations d'identification, compte, inventaire et alertes.
  2. Sélectionnez Sync now pour importer immédiatement l'inventaire, les métriques et les alertes, sans attendre.

Les hôtes apparaissent comme des ressources, rapprochées des mêmes serveurs issus d'autres sources. Les services APM apparaissent comme des ressources Application (APM) et les moniteurs comme des ressources Synthetic monitor, avec leurs vérifications. Les incidents ouverts apparaissent dans l'Alert inbox, avec un lien vers New Relic.

Choisir le mode​

ModeCe que vous obtenez
HybridLes incidents immédiatement par webhook ; l'inventaire et les métriques par interrogation ; un rapprochement qui ferme ce qui a été fermé dans New Relic pendant qu'un webhook était perdu
PollingTout par interrogation. Les incidents apparaissent dans l'intervalle des alertes, 5 minutes par défaut
Webhook onlyUniquement les incidents, sans inventaire ni métriques, et sans clé stockée