REST-API -[]- Integrationenkonfigurieren

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

    • Konfigurieren Sie einen -Integration für das Streaming von Protokolldaten an Ihre Instanz ServiceNow im JSON-Format zur Verarbeitung durch Health Log Analytics.

    Vorbereitungen

    • Stellen Sie sicher, dass die Anwendung Health Log Analytics in Ihrer Instanz installiert und bereitgestellt ist. Weitere Informationen finden Sie unter Health Log Analytics installieren (HLA).
    • Stellen Sie sicher, dass eine Serviceinstanz verfügbar ist.
    • Stellen Sie sicher, dass die KI-Engine Health Log Analytics aktiv ist und ausgeführt wird.
    • Stellen Sie sicher, dass ein MID-Server mit aktivierter Protokollerfassungsfunktion installiert und konfiguriert ist.

      MID-Serverkonfiguration mit aktivierter Protokollerfassungsfunktion.

      Wichtig:
      Health Log Analytics bietet keine Unterstützung für IPv6. Konfigurieren Sie den MID-Server auf IPv4, um mit der Anwendung zu arbeiten.
    • Stellen Sie sicher, dass ein MID-Webserver für MID-Servereingerichtet ist.

      Weitere Informationen finden Sie unter MID-Webservererweiterung konfigurieren.

      Wählen Sie im Formular „MID-Webserver-Kontext“ im Feld Ausführen für die Option Spezifischer MID Server und nicht die Clusteroption aus. Wählen Sie im Feld MID-Server den MID-Server aus, an den die Protokolldaten übertragen werden.

    • Wenn die IP-Adresse des MID-Server über Network Address Translation (NAT), ein Lastenausgleichsmodul oder ein ähnliches Gerät verfügbar gemacht wird, muss er eine öffentliche IP-Adresse besitzen. Fügen Sie in den Eigenschaften des MID-Server eine Eigenschaft mit dem Namen mid.public_ip mit der öffentlichen IP-Adresse als Wert hinzu. Weitere Informationen finden Sie unter MID Server-Eigenschaften erstellen.

    Erforderliche Rolle: evt_mgmt_admin

    Prozedur

    1. Navigieren zu Arbeitsbereiche > Service Operations-Arbeitsbereich.
    2. Wählen Sie im linken Bereich das Integrations-Launchpad-Symbol ( Integrations-Launchpad-Symbol)
    3. Geben Sie auf der Registerkarte Integrationen durchsuchen im Suchfeld REST ein.
    4. Wählen Sie die Kachel REST-API-Integration.
      Hinweis:
      Wenn Sie den Integrationsprozess gestartet haben, ohne alle im Abschnitt Bevor Sie beginnen, zu erfüllen, wird eine Meldung angezeigt. Sie haben die Möglichkeit, die Integration abzubrechen und die fehlenden Anforderungen abzuschließen oder im Entwurfsmodus fortzufahren und sie später zu erfüllen. Beachten Sie, dass Sie eine konfigurierte Integration nur aktivieren können, wenn alle Voraussetzungen erfüllt sind. Gespeicherte Integrationen, die nicht aktiviert wurden, sind auf der Registerkarte Installierte Integrationen in Integrations Launchpadunter Warten auf Ihre Aktionverfügbar.
    5. Wählen Sie Details angeben aus.
    6. Füllen Sie die Felder des Formulars aus, und wählen Sie Weiteraus.
      Feldbeschreibungen finden Sie unter Konfigurationsfelder für die REST-API-Integration.
      Wenn Sie Weiterwählen, wird Ihre Konfiguration gespeichert, und die Registerkarte Setup-Anweisung wird angezeigt.
    7. Befolgen Sie die Anweisungen auf dem Bildschirm, um die Integration in Ihrem Überwachungstool zu installieren.
      1. Kopieren Sie die angegebene URL.

        Die URL hat das Format http://(MID_SERVER_IP):(MID_WEB_SERVER_PORT)/ap1/mid/hla/raw, wobei /aps/mid/hla/raw der Endpunkt ist.

      2. Fügen Sie die URL in die Konfiguration Ihrer Drittanbieterkonsole ein, in der Sie aufgefordert werden, die URL für das Streaming von Protokollen an MID-Servereinzugeben.
      Hinweis:
      Die Authentifizierungsmethode, die zum Übertragen von Protokollen an die angegebene URL verwendet wird, muss mit der auf dem ausgewählten MID-Webserver festgelegten Methode übereinstimmen.
    8. Wählen Sie Aktivieren aus, um die -Integrationzu aktivieren.
      Die -Integration wird aktiviert. Die Registerkarte Übersicht wird angezeigt.

    Ergebnisse

    Log Daten beginnen das Streaming von zu Ihrer Instanz ServiceNow. Die Kachel für die -Integration ist auf der Registerkarte Installierte Integrationen in Integrations Launchpadverfügbar.

    Benutzer mit der Rolle evt_mgmt_user können mit Ereignismanagement die Protokolle überwachen und die Warnungen anzeigen, die Health Log Analytics aus ihnen generiert.

    Nächste Maßnahme

    Überprüfen Sie den Status des Protokolldaten-Streamings und die Quellen von der Integration auf der Registerkarte Übersicht. Nutzen Sie die angezeigten Informationen, um zu verfeinern, wie HLA die Protokolldaten liest, indem Sie die Konfiguration Ihrer Integration anpassen. Weitere Informationen finden Sie unter Streamingstatus und Quellen von Protokolldaten von einern Integrationüberprüfen.
    Hinweis:
    Auf der Registerkarte Übersicht können Sie direkt zu den Seiten „Dateneingabezuordnung“, „Quelltypstrukturen“ und „Protokollquellen“ mit Kontext aus dieser Integration wechseln, indem Sie das Menüsymbol „Ansicht“ ( Menüsymbol „Ansicht“ ) auswählen und die entsprechende Option auswählen. Über das Menü können Sie auch direkt auf den Protokoll-Viewer zugreifen, der die Rohprotokolle anzeigt, die diese Integration erfasst.