Integrieren Sie Dynatrace mit der OAuth-Authentifizierung

  • Freigeben Version: Xanadu
  • Aktualisiert 17. Juni 2026
  • 3 Minuten Lesedauer

    • Integrieren Sie Dynatrace mit Ereignismanagement, indem Sie Dynatrace V1- oder V2-Token im Dynatrace -Monitor authentifizieren.

    Vorbereitungen

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

    Das Plugin „Ereignismanagement“ muss in der Now Platform-Instanz installiert sein.

    Vergewissern Sie sich, dass Konfigurationselemente für die von Dynatrace verwalteten Hosts in ServiceNow vorhanden sind. Diese CIs können physisch oder virtuell sein und entweder manuell erstellt oder mittels IP-Erkennung oder cloudbasierter Erkennung erkannt werden.

    Erforderliche Rolle: evt_mgmt_integration

    Warum und wann dieser Vorgang ausgeführt wird

    Die Integration vonDynatrace mit der OAuth-Authentifizierung ist ab dem Plattform-Release Washington DC oder höher verfügbar.

    Prozedur

    1. Konfiguration in der Instanz ServiceNow
      1. Erstellen Sie die Systemeigenschaft glide.oauth.inbound.client.credential.grant_type.enabled, um den Gewährungstyp für Client-Anmeldeinformationen für eingehende OAuth-Integrationen zu verwenden.
        • Typ: true|false
        • Wert: true
      2. Erstellen Sie einen OAuth-Entitätsendpunkt, damit Clients auf die Instanz zugreifen können.
        1. Navigieren zu Alle > System-OAuth > Applikationsregistrierung und wählen Sie Neuaus.
        2. Wählen Sie auf der Interceptor-Seite OAuth-API-Endpunkt für externe Clients erstellen aus, und füllen Sie das Formular aus.
        3. Um einen OAuth-Client-Datensatz zu erstellen, wählen Sie Absendenaus.
      3. Fügen Sie dem erstellten OAuth-Client-Datensatz den OAuth-Anwendungsanwender und den Standard-Gewährungstyp hinzu.
        1. Fügen Sie im Formular „OAuth-Entität“ die Felder OAuth-Anwendungsbenutzer und Standardgewährungstyp hinzu, um den Gewährungstyp „Client-Anmeldeinformationen“ für eingehende OAuth-Integrationen zu verwenden.
        2. Öffnen Sie den erstellten OAuth-Client-Datensatz.
        3. Wählen Sie im Seiten-Header das Symbol „ Weitere Optionen“ aus.
        4. Auswahlvorgang Konfigurieren > Formularlayout
        5. Fügen Sie auf der Seite „Formularlayout“ OAuth-Anwendungsbenutzer und Standardgewährungstyp aus der Liste der Felder hinzu.
        6. Speichern oder aktualisieren Sie das Formular.
        7. Wählen Sie im Feld OAuth-Anwendungsbenutzer den Benutzer aus.
          Der Anwender muss über die Rolle evt_mgmt_integration verfügen, die zum Erstellen der von Dynatracegesendeten Ereignisse verwendet wird.
          Hinweis:
          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.
        8. Legen Sie den Wert im Feld „ Standard-Gewährungstyp“ auf Client-Anmeldeinformationen fest.
        9. Legen Sie den Authentifizierungsbereich auf useraccount fest.
      4. Erstellen Sie einen REST-API-Authentifizierungsbereich für die RestAPI von Ereignis-Connectors.
        1. Navigieren zu Alle > System-Webservices > API-Authentifizierungsbereiche > REST-API-Authentifizierungsbereich.
        2. Geben Sie einen Namen an.
        3. Legen Sie „ Aktiv“ auf „wahr“ fest.
        4. Legen Sie den Authentifizierungsbereich als useraccount fest.
        5. Legen Sie die REST-API als Ereignis-Connectors fest.
        6. Wählen Sie Authentifizierungsbereich auf alle HTTP-Methoden in dieser API anwenden aus.
        7. Wählen Sie Authentifizierungsbereich auf alle Versionen in dieser API anwenden aus.
        8. Wählen Sie Authentifizierungsbereich auf alle Ressourcen in dieser API anwenden aus.
    2. Definieren Sie in der Konsole Dynatrace die Integrationseinstellungen.
      1. Navigieren zu Einstellungen > Integration > Problembenachrichtigungen > Benachrichtigungen einrichten.
      2. Geben Sie im Formular „Anwenderdefinierte Integration einrichten“ die Webhook-URL ein.

        https://<instance-name> .service-now.com/api/sn_em_connector/em/inbound_event?source=dynatrace

      3. Aktivieren Sie OAuth 2.0 für Authentifizierung verwenden.
      4. Führen Sie im Abschnitt mit den OAuth 2.0-Anmeldeinformationen die folgenden Schritte aus.
        1. Geben Sie die Zugriffs-Token-URL als https://an.<instance_name> .service-now.com/oauth_token.do
        2. Geben Sie den Wert für die Client-ID mit der Client-ID des in der Instanz ServiceNow erstellten OAuth-Entitätsclients an.
        3. Geben Sie für „Geheimer Clientschlüssel“ den geheimen Clientschlüssel des in der Instanz ServiceNow erstellten OAuth-Entitätsclients an.
        4. Wählen Sie Speichern.
      5. Fügen Sie im Abschnitt „Custom payload“ (Benutzerdefinierte Nutzlast) die folgende Nutzlaststruktur für die zu generierenden Ereignisse hinzu.
        { 
  "ImpactedEntities": {ImpactedEntities}, 
  "ImpactedEntity": "{ImpactedEntity}", 
  "PID": "{PID}", 
  "ProblemDetailsHTML": "{ProblemDetailsHTML}", 
  "ProblemDetailsJSONv2": "{ProblemDetailsJSONv2}",  
  "ProblemDetailsMarkdown": "{ProblemDetailsMarkdown}", 
  "ProblemDetailsText": "{ProblemDetailsText}", 
  "ProblemID": "{ProblemID}", 
  "ProblemImpact": "{ProblemImpact}", 
  "ProblemSeverity": "{ProblemSeverity}", 
  "ProblemTitle": "{ProblemTitle}", 
  "ProblemURL": "{ProblemURL}", 
  "State": "{State}", 
  "Tags": "{Tags}" 
}

    Ergebnisse

    Die Übertragung von Warnungen von Dynatrace -Agents in das Plugin Ereignismanagement „ beginnt. Das Plugin extrahiert Informationen aus der ursprünglichen Dynatrace-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 zu Alle Ereignisse, um die Ereignisse anzuzeigen.

    Hinweis:
    Standardmäßig ist die Hostbindung für Dynatrace Ereignisse für die Anbieter (AWS/Azure/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 Dynatrace – Allgemeines Ereignis aktivieren. Weitere Informationen zu Event-Regeln finden Sie unter Event-Regeln.