Integrieren DynatraceMit OAuth-Authentifizierung

Integrieren DynatraceMit EreignismanagementDurch Authentifizierung DynatraceV1- oder V2-Token in DynatraceÜberwachen.

Vorbereitungen

Stellen Sie sicher, dass EreignismanagementPlugin „Connectors“ (sn_em_Connector) ist auf installiert Now PlatformInstanz.

Die EreignismanagementPlugin muss auf installiert sein Now PlatformInstanz.

Überprüfen Sie Konfigurationselemente für die von verwalteten Hosts DynatraceVorhanden in ServiceNow. Diese CIs können physisch oder virtuell sein und entweder manuell erstellt oder mithilfe von IP-Discovery oder Cloud-Discovery erkannt werden.

Erforderliche Rolle: evt_mgmt_integration

Warum und wann dieser Vorgang ausgeführt wird

DynatraceDie Integration mit OAuth-Authentifizierung ist ab verfügbar Washington DCPlattform-Release oder höher.

Prozedur

1. Konfiguration auf ServiceNowInstanz.
   1. Erstellen glide.oauth.inbound.client.credential.grant_type.enabledSystemeigenschaft zur Verwendung des Gewährungstyps „Client-Anmeldeinformationen“ für eingehende OAuth-Integrationen.
      • 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 dann aus Neu .
      2. Wählen Sie auf der Seite „Interceptor“ die Option aus Erstellen Sie einen OAuth-API-Endpunkt für externe Clients Und füllen Sie dann das Formular aus.
      3. Wählen Sie aus, um einen OAuth-Client-Datensatz zu erstellen Übermitteln .
   3. Fügen Sie dem erstellten OAuth-Client-Datensatz den OAuth-Anwendungsanwender und den Standardgewährungstyp hinzu.
      1. Fügen Sie im Formular „OAuth-Entität“ hinzu OAuth-Anwendungsanwender Und Standardgewährungstyp Felder zur Verwendung des Gewährungstyps „Client-Anmeldeinformationen“ für eingehende OAuth-Integrationen.
      2. Öffnen Sie den erstellten OAuth-Client-Datensatz.
      3. Wählen Sie im Seitenheader die Option aus Mehr Optionssymbol.
      4. Auswählen Konfigurieren > Formularlayout
      5. Fügen Sie auf der Seite „Formularlayout“ hinzu OAuth-Anwendungsanwender und Standardgewährungstyp Aus der Liste der Felder.
      6. Speichern Oder Aktualisieren Das Formular.
      7. Für OAuth-Anwendungsanwender Wählen Sie den Anwender aus.
         Der Anwender muss über die Rolle „evt_mgmt_Integration“ verfügen, die zum Erstellen der von gesendeten Ereignisse verwendet wird Dynatrace.

         Hinweis:

         Um eine ordnungsgemäße Authentifizierung sicherzustellen, verwenden Sie den Anwender mit den geringsten Berechtigungen mit der Rolle „evt_mgmt_Integration“ und nicht einen Anwender mit hohen Berechtigungen.
      8. Festgelegt Standardgewährungstyp Feldwert bis Client-Anmeldeinformationen .
2. In DynatraceKonsole, definieren Sie die Integrationseinstellungen.
   1. Navigieren zu Einstellungen > Integration > Problembenachrichtigungen > Richten Sie Benachrichtigungen einan.
   2. Geben Sie im Formular „Anwenderdefinierte Integration einrichten“ die Webhook-URL ein.

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

   3. Aktivieren Verwenden Sie OAuth 2,0 für die Authentifizierung .
   4. Führen Sie im Abschnitt „OAuth 2.0-Anmeldeinformationen“ die folgenden Schritte aus.
      1. Geben Sie die Zugriffstoken-URL als an https://<instance_name>.service-now.com/oauth_token.do .
      2. Geben Sie den Wert für an Client-ID Mit der Client-ID des in erstellten OAuth-Entitätsclients ServiceNowInstanz.
      3. Geben Sie „geheimer Clientschlüssel“ mit dem geheimen Clientschlüssel des OAuth-Entitätsclients an, der in erstellt wurde ServiceNowInstanz.
      4. Wählen Sie Speichern.
   5. Fügen Sie im Abschnitt „Custom payload“ (Anwenderdefinierte 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

Warnungen beginnen, von zu fließen DynatraceService Desk-Mitarbeiter in EreignismanagementPlugin. Das Plugin extrahiert Informationen aus dem Original DynatraceWarnmeldung zum Ausfüllen der erforderlichen Ereignisfelder und zum Einfügen des Ereignisses in die Datenbank. In Ihrem Now PlatformInstanz, navigieren Sie zu allen Ereignissen, um die Ereignisse anzuzeigen.

Hinweis:

Standardmäßig ist die Hostbindung für aktiviert DynatraceEreignisse für ( AWS/ Azure/ GCP) Anbieter. Wenn alle Hosts in der Umgebung mit erkannt werden Cloud-DiscoveryWenn Anmeldeinformationen angegeben werden und erkannte Ressourcen in der cmdb_ci_vm_object-Liste enthalten sind, tritt die VM-Bindung möglicherweise nicht auf. Um dies zu beheben, müssen Sie aktivieren Dynatrace– Allgemeine Ereignisregel. Weitere Informationen zu Ereignisregeln finden Sie unter Ereignisregeln.