Intégrer les événements de la plateforme New Relic

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 4 minutes de lecture

    • Intégrez New Relic avec Gestion des événements en ajoutant un webhook standard dans l’ancienne et la nouvelle console de New Relic.

    Avant de commencer

    Vérifiez que le module d’extension Gestion des événements Connecteurs (sn_em_connector) est installé sur l’instance Now Platform .

    Rôle requis : evt_mgmt_integration

    Pourquoi et quand exécuter cette tâche

    Configurez l'environnement Gestion des événements pour la collecte d'événements à partir de New Relic en authentifiant New Relic en tant que source de données. Définissez votre Now Platform instance en tant que point de terminaison REST à l’aide d’un webhook standard. Utilisez l’étape 1 de la procédure pour la nouvelle console. Utilisez l’étape 2 de la procédure pour l’ancienne console.

    À compter de la Xanadu version, la case Appliquer des règles de correspondance supplémentaires est désormais cochée pour les règles d’événements prêtes à l’emploi fournies avec le connecteur, que vous n’avez pas utilisées auparavant (c’est-à-dire ni activées, ni désactivées, ni modifiées). Auparavant, cette case à cocher était désactivée. Ce changement vous permet d’exécuter plus de règles d’événements ou d’automatisation en utilisant les mêmes conditions de filtre pour les événements.
    Remarque :
    Cette fonctionnalité s’applique uniquement aux règles d’événements actifs.

    Procédure

    1. Pour la nouvelle console :
      1. Créer une destination.
        1. Accédez à laAlertes et IA > Destinations.
        2. Dans la sectionAjouter des destinations, sélectionnez le type de canalWebhook.
        3. Dans le champNom du Webhook, entrez le nom du Webhook.
        4. Dans le champURL du point de terminaison, saisissez :https://<InstanceName>.service-now.com/api/sn_em_connector/em/inbound_event?source=newrelic
        5. Dans la sectionAuthentification de base, saisissez votre nom d’utilisateur et votre mot de passe.
          Remarque :
          Vérifiez que le rôle evt_mgmt_integration est affecté à l’utilisateur sélectionné. pour garantir une authentification appropriée, utilisez l'utilisateur le moins privilégié disposant du rôle evt_mgmt_integration, plutôt qu'un utilisateur possédant des privilèges élevés.
        6. SélectionnezEnregistrer la destination.
      2. Créez une politique.
        1. Accédez à laAlertes et IA > Conditions et politiques d’alerte.
        2. SélectionnezNouvelle politique d’alerteet définissez une politique.
        3. SélectionnezConfigurer les notifications.
        4. Dans la sectionAjouter un canal, sélectionnezWebhook, puis sélectionnez la destination que vous avez créée à la sous-étape précédente.
        5. Dans la sectionModèle de charge utile, collez la charge utile JSON suivante.
          { "account_id": {{nrAccountId}}, "account_name": {{json accumulations.tag.account.[0]}}, "closed_violations_count": {{closedIncidentsCount}}, "open_violations_count": {{openIncidentsCount}}, "condition_description": "{{escape accumulations.conditionDescription.[0]}}", "condition_family_id": {{accumulations.conditionFamilyId.[0]}}, "condition_name": "{{escape accumulations.conditionName.[0]}}", "current_state": {{json state}}, "details": {{json issueTitle}}, "duration": {{#if issueDurationMs}}{{issueDurationMs}}{{else}}0{{/if}}, "event_type": "INCIDENT", "incident_acknowledge_url": {{json issueAckUrl}}, "incident_id": {{json issueId}}, "incident_url": {{json issuePageUrl}}, "metadata": { {{#if locationStatusesObject}}"location_statuses": {{json locationStatusesObject}},{{/if}} {{#if accumulations.metadata_entity_type}}"entity.type": {{json accumulations.metadata_entity_type.[0]}},{{/if}} {{#if accumulations.metadata_entity_name}}"entity.name": {{json accumulations.metadata_entity_name.[0]}},{{/if}} "section": "metadata" }, "owner": {{json owner}}, "policy_name": {{json accumulations.policyName.[0]}}, "policy_url": {{json policyUrl}}, "runbook_url": {{json accumulations.runbookUrl.[0]}}, "severity": {{json priority}}, "targets": [ { "id": "{{labels.targetId.[0]}}", "name": "{{#if accumulations.targetName}}{{escape accumulations.targetName.[0]}}{{else if entitiesData.entities}}{{escape entitiesData.entities.[0].name}}{{else}}N/A{{/if}}", "link": "{{issuePageUrl}}", "product": "{{accumulations.conditionProduct.[0]}}", "type": "{{#if entitiesData.types.[0]}}{{entitiesData.types.[0]}}{{else}}N/A{{/if}}", "labels": { {{#each accumulations.rawTag}}"{{escape @key}}": {{#if this.[0]}}{{json this.[0]}}{{else}}"empty"{{/if}}{{#unless @last}},{{/unless}}{{/each}} } } ], "timestamp": {{updatedAt}}, "violation_callback_url": {{json issuePageUrl}}, "violation_chart_url": {{json violationChartUrl}} }
        6. SélectionnezEnvoyer une notification de testpour obtenir l’événement de test dans votre ServiceNow instance.
        7. SélectionnezEnregistrer le message.
        8. SélectionnezActiver le workflowpour activer le workflow.
      3. Créez les conditions d'alerte à appliquer à la politique :
        1. Accédez à laAlertes et IA > Conditions et politiques d’alerte.
        2. SélectionnezCréer une condition d’alerte, définissez les détails de l’alerte requis et ajoutez-les à la politique que vous avez créée à l’étape précédente.
        3. SélectionnezEnregistrer la condition.
    2. Pour l'ancienne console.
      1. Créez un canal de notification.
        1. Accédez à laAlertes et IA > Canaux de notification.
        2. Dans l’ongletDétails du canal, sélectionnez le type de canalWebhook.
        3. Dans la zonede texte URL de base, saisissez :https://<InstanceName>.service-now.com/api/sn_em_connector/em/inbound_event?source=newrelic
        4. Dans la section Authentification de base, saisissez le nom d'utilisateur et le mot de passe de l'utilisateur concerné.
          Remarque :
          Vérifiez que le rôle evt_mgmt_integration est affecté à l’utilisateur sélectionné. pour garantir une authentification appropriée, utilisez l'utilisateur le moins privilégié disposant du rôle evt_mgmt_integration, plutôt qu'un utilisateur possédant des privilèges élevés.
        5. Dans la sectionCharge utile personnalisée, sélectionnezAjouter une charge utile personnalisée, puis sélectionnez le type de charge utileJSON.
        6. Collez la charge utile JSON suivante dans lacharge utile personnalisée.
          { "account_id": "$ACCOUNT_ID", "account_name": "$ACCOUNT_NAME", "closed_violations_count_critical": "$CLOSED_VIOLATIONS_COUNT_CRITICAL", "closed_violations_count_warning": "$CLOSED_VIOLATIONS_COUNT_WARNING", "condition_description": "$DESCRIPTION", "condition_family_id": "$CONDITION_FAMILY_ID", "condition_name": "$CONDITION_NAME", "current_state": "$EVENT_STATE", "details": "$EVENT_DETAILS", "duration": "$DURATION", "event_type": "$EVENT_TYPE", "incident_acknowledge_url": "$INCIDENT_ACKNOWLEDGE_URL", "incident_id": "$INCIDENT_ID", "incident_url": "$INCIDENT_URL", "metadata": "$METADATA", "open_violations_count_critical": "$OPEN_VIOLATIONS_COUNT_CRITICAL", "open_violations_count_warning": "$OPEN_VIOLATIONS_COUNT_WARNING", "owner": "$EVENT_OWNER", "policy_name": "$POLICY_NAME", "policy_url": "$POLICY_URL", "runbook_url": "$RUNBOOK_URL", "severity": "$SEVERITY", "targets": "$TARGETS", "timestamp": "$TIMESTAMP", "violation_callback_url": "$VIOLATION_CALLBACK_URL", "violation_chart_url": "$VIOLATION_CHART_URL" }
      2. Créez une politique.
        1. Accédez à laAlertes et IA > Politiques.
        2. SélectionnezNouvelle politique d’alerteet définissez une politique.
        3. Dans la sectionCanaux de notification, sélectionnezAjouter, sélectionnezWebhook, puis sélectionnez le canal que vous avez créé à l’étape précédente.
      3. Créez les conditions d'alerte à appliquer à la politique :
        1. Accédez à laInfrastructure > Paramètres > Alertes.
        2. SélectionnezCréer une condition d’alerte, définissez les détails de l’alerte requis, ajoutez-les à la politique que vous avez créée à l’étape précédente.
        3. SélectionnezCréer.

    Résultats

    L'envoi des alertes de New Relic au module d'extension Event Management commence. Le module d'extension extrait les informations du message d'alerte New Relic d'origine pour renseigner les champs d'événement requis et insère l'événement dans la base de données. Dans votre Now Platform instance, naviguez versTous les événementspour consulter les événements.
    Remarque :
    Par défaut, la liaison d'hôtes est activée pour les événements New Relic pour tous les fournisseurs (Azure/AWS/GCP). Si tous les hôtes de l'environnement sont détectés via Découverte dans le cloud en fournissant des informations d'identification et que les ressources détectées se trouvent dans la liste cmdb_ci_vm_object, la liaison d'ordinateurs virtuels est impossible. Pour résoudre ce problème, vous devez activer la règleNew Relic - Événement général. Pour en savoir plus sur les règles d'événements, consultez la rubrique Règles d'événements.