Events der New Relic-Plattform integrieren

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 4 Minuten Lesedauer

    • Integrieren Sie New Relic in Ereignismanagement, indem Sie in der alten und neuen New Relic-Konsole einen Standard-Webhook hinzufügen.

    Vorbereitungen

    Vergewissern Sie sich, dass das Plugin Ereignismanagement „ Connectors (sn_em_connector)“ in der Instanz Now Platform installiert ist.

    Erforderliche Rolle: evt_mgmt_integration

    Warum und wann dieser Vorgang ausgeführt wird

    Konfigurieren Sie die Ereignismanagement-Umgebung für die Erfassung von Events aus New Relic, indem Sie New Relic als Datenquelle authentifizieren. Legen Sie Ihre Instanz Now Platform mit einem Standard-Webhook als REST-Endpunkt fest. Führen Sie Verfahrensschritt 1 für die neue Konsole aus. Führen Sie Verfahrensschritt 2 für die alte Konsole aus.

    Ab Release Xanadu verfügen die mit dem Connector bereitgestellten OOTB-Ereignisregeln (Out-Of-The-Box), die Sie zuvor nicht verwendet haben (d. h. weder aktiviert, deaktiviert noch geändert), jetzt über die Option Zusätzliche Zuordnung anwenden Checkbox für Regeln auf „wahr“ gesetzt. Zuvor war dieses Kontrollkästchen deaktiviert. Mit diesem Change können Sie mehr Ereignisregeln oder Automatisierung mit denselben Filterbedingungen für die Ereignisse ausführen.
    Hinweis:
    Diese Funktion gilt nur für aktive Ereignisregeln.

    Prozedur

    1. Für die neue Konsole:
      1. Erstellen Sie ein Ziel.
        1. Navigieren zuWarnungen und KI > Ziele.
        2. Wählen Sie im AbschnittZiele hinzufügenden KanaltypWebhookaus.
        3. Geben Sie im FeldWebhook-Nameden Webhook-Namen ein.
        4. Geben Sie im FeldEndpunkt-URL Folgendesein:https://<InstanceName> .service-now.com/api/sn_em_connector/em/inbound_event?source=newrelic
        5. Geben Sie im AbschnittBasisauthentifizierungIhren Anwendernamen und Ihr Passwort ein.
          Hinweis:
          Stellen Sie sicher, dass dem ausgewählten Anwender die Rolle evt_mgmt_integration zugewiesen ist. Um eine ordnungsgemäße Authentifizierung sicherzustellen, verwenden Sie den Benutzer mit den geringsten Berechtigungen mit der Rolle evt_mgmt_integration anstelle eines Benutzers mit hohen Berechtigungen.
        6. Wählen SieZiel speichern.
      2. Erstellen Sie eine Richtlinie.
        1. Navigieren zuWarnungen und KI > Warnungsbedingungen und -richtlinien.
        2. Wählen Siedie Richtlinie Neue Warnungaus, und definieren Sie eine Richtlinie.
        3. Wählen SieBenachrichtigungen einrichten.
        4. Wählen Sie im Abschnitt„Kanal hinzufügen“die Option Webhookaus, und wählen Sie dann das Ziel aus, das Sie im vorherigen Unterschritt erstellt haben.
        5. Fügen Sie im AbschnittNutzlastvorlagedie folgende JSON-Nutzlast ein.
          { "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. Wählen SieTestbenachrichtigung senden aus,um das Testereignis in Ihrer Instanz ServiceNow abzurufen.
        7. Wählen SieNachricht speichernaus.
        8. Wählen SieWorkflow aktivierenaus, um den Workflow zu aktivieren.
      3. Erstellen Sie Warnungsbedingungen, die auf die Richtlinie angewendet werden sollen:
        1. Navigieren zuWarnungen und KI > Warnungsbedingungen und -richtlinien.
        2. Wählen SieWarnungsbedingung erstellen aus, definieren Sie die erforderlichen Warnungsdetails, und fügen Sie sie der Richtlinie hinzu, die Sie im vorherigen Schritt erstellt haben.
        3. Wählen SieBedingung speichernaus.
    2. Für die alte Konsole:
      1. Erstellen Sie einen Benachrichtigungskanal.
        1. Navigieren zuWarnungen und KI > Benachrichtigungskanäle.
        2. Wählen Sie auf der RegisterkarteKanaldetailsden KanaltypWebhookaus.
        3. Geben Sie im TextfeldBasis-URLFolgendes ein:https://<InstanceName> .service-now.com/api/sn_em_connector/em/inbound_event?source=newrelic
        4. Geben Sie im Abschnitt „Basisauth.“ Benutzername und Passwort des entsprechenden Benutzers ein.
          Hinweis:
          Stellen Sie sicher, dass dem ausgewählten Anwender die Rolle evt_mgmt_integration zugewiesen ist. Um eine ordnungsgemäße Authentifizierung sicherzustellen, verwenden Sie den Benutzer mit den geringsten Berechtigungen mit der Rolle evt_mgmt_integration anstelle eines Benutzers mit hohen Berechtigungen.
        5. Wählen Sie im AbschnittCustom Payload (Anwenderdefinierte Nutzlast)Anwenderdefinierte Nutzlast hinzufügenund anschließend den NutzlasttypJSONaus.
        6. Fügen Sie die folgende JSON-Payload inCustom Payload (Anwenderdefinierte Payload)ein.
          { "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. Erstellen Sie eine Richtlinie.
        1. Navigieren zuWarnungen und KI > Richtlinien.
        2. Wählen Siedie Richtlinie Neue Warnungaus, und definieren Sie eine Richtlinie.
        3. Wählen Sie im Abschnitt„Benachrichtigungskanäle“Hinzufügen, wählen SieWebhookaus, und wählen Sie dann den Kanal aus, den Sie im vorherigen Schritt erstellt haben.
      3. Erstellen Sie Warnungsbedingungen, die auf die Richtlinie angewendet werden sollen:
        1. Navigieren zuInfrastruktur > Einstellungen > Warnungen.
        2. Wählen SieWarnungsbedingung erstellen aus, definieren Sie die erforderlichen Warnungsdetails, und fügen Sie sie der Richtlinie hinzu, die Sie im vorherigen Schritt erstellt haben.
        3. Wählen SieErstellenaus.

    Ergebnisse

    Die Übertragung von Warnungen aus der New Relic-Konsole in das Plugin Event Management beginnt. Das Plugin extrahiert die Informationen aus der ursprünglichen New Relic-Warnmeldung, um die erforderlichen Event-Felder zu füllen, und fügt das Event in die Datenbank ein. Navigieren Sie in Ihrer Instanz Now Platform zuAlle Ereignisse, um die Ereignisse anzuzeigen.
    Hinweis:
    Standardmäßig ist die Hostbindung für New Relic-Events für alle Provider (Azure /AWS/GCP) aktiviert. Wenn alle Hosts in der Umgebung mit Cloud-Discovery durch die Bereitstellung von Anmeldeinformationen erkannt werden und sich erkannte Ressourcen in der Liste cmdb_ci_vm_object befinden, tritt die VM-Bindung möglicherweise nicht auf. Um dieses Problem zu beheben, müssen Sie die Ereignisregel„New Relic – Allgemein“aktivieren. Weitere Informationen zu Event-Regeln finden Sie unter Event-Regeln.