Richten Sie eine REST-API-Integration für ein Health Log Analytics

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer

    • Richten Sie eine Integration für das Streaming von Protokolldaten an Ihren ein ServiceNow Instanz zur Verarbeitung von Health Log Analytics.

    Vorbereitungen

    • Überprüfen Sie, ob Health Log Analytics Die Anwendung wird in Ihrer Instanz installiert und bereitgestellt. Weitere Informationen finden Sie unter Installieren Health Log Analytics(HLA).
    • Überprüfen Sie, ob eine Serviceinstanz verfügbar ist.
    • Überprüfen Sie, ob Health Log Analytics KI-Engine ist aktiv und wird ausgeführt.
    • Überprüfen Sie, ob ein MID-Server Wird mit aktivierter Protokollerfassungsfunktion installiert und konfiguriert. Weitere Informationen finden Sie unter MID Server system requirements.

      MID-Server-Konfiguration 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.

      Wählen Sie im Formular „MID-Webserver-Kontext“ im Feld Ausführen für die Option Spezifischer MID Server und nicht die Clusteroption aus. In MID-Server Wählen Sie das spezifische aus MID-Server Zu dem die Protokolldaten abgerufen werden.

    • Wenn MID-Server Die IP-Adresse wird durch Netzwerkadressübersetzung (Network Address Translation, NAT), ein Lastenausgleichsmodul oder ein ähnliches Gerät bereitgestellt MID-Server Muss eine öffentliche IP-Adresse haben, um von externen Clients erreichbar zu sein, z. B. Filebeat Service Desk-Mitarbeiter, die sich außerhalb des Netzwerks befinden. Private IP-Adressen können nicht über das Internet weitergeleitet werden. Ohne eine öffentliche IP können diese externen Clients keine Verbindung mit herstellen MID-Server Auch wenn sie mit der Adresse konfiguriert sind. 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.
      Hinweis:
      Wenn MID-Server Und externe Clients befinden sich im selben Netzwerk, eine öffentliche IP ist nicht erforderlich, und Verbindungen können über die private IP-Adresse hergestellt werden.
    Hinweis:
    REST API-Integrationen unterstützen nur die UTF-8-Codierung für eingehende Daten.

    Erforderliche Rolle: evt_mgmt_admin

    Prozedur

    1. Navigieren zu Arbeitsbereiche > Service Operations-Arbeitsbereichan.
    2. Wählen Sie im linken Bereich das Symbol Integrations Launchpad: Symbol für Integrations-Launchpad.
    3. In Integrationen durchsuchen Registerkarte eingeben REST Im Suchfeld.
    4. Wählen Sie die REST API-Integrationskachel aus.
      Hinweis:
      Wenn Sie ein Integrationssetup starten, bevor Sie alle Voraussetzungen erfüllen, wird eine Meldung angezeigt. Sie können entweder das Setup abbrechen und zuerst die vorherigen Anforderungen abschließen oder im Entwurfsmodus fortfahren und sie später abschließen. Beachten Sie, dass Sie die Integration erst aktivieren können, wenn alle Voraussetzungen erfüllt sind.
    5. Auf der Geben Sie Details an Füllen Sie die Felder aus.
      Feldbeschreibungen finden Sie unter Konfigurationsfelder der REST-API-Integration.
    6. Wählen Sie Weiter.
    7. In Setup-Anweisung Kopieren Sie die angegebene URL in die Zwischenablage.

      Das Format der URL ist: http://(MID_SERVER_IP):(MID_WEB_SERVER_PORT)/ap1/mid/hla/raw , Wo /aps/MID/hla/RAW Ist der Endpunkt. HLA Wurde ersetzt (MID_SERVER_IP) Und (MID_WEB_SERVER_PORT) Mit den Werten, die Sie in konfiguriert haben Geben Sie Details an Formular.

    8. Wählen Sie Aus Entwurf speichern .
    9. Wählen Sie Aus Aktivieren Zum Aktivieren der Integration.
      Hinweis:
      Sie können eine konfigurierte Integration nur aktivieren, wenn Sie alle Integrationsvoraussetzungen erfüllt haben.
    10. Wahlweise: Wenn Sie die Integration im Entwurfsmodus installiert haben, aktivieren Sie sie später, indem Sie die folgenden Schritte ausführen:
      1. Schließen Sie die Integrationsvoraussetzungen ab.
      2. In Integrations Launchpad Installierte Integrationen Registerkarte, unter Warten auf Ihre Aktion , Suchen und wählen Sie die Integration aus.
      3. In Setup-Anweisung Bildschirm auswählen Aktivieren Zum Aktivieren der Integration.

    Ergebnisse

    Die Integration ist aktiviert und die Übersicht Bildschirm wird angezeigt. Die Kachel für die Integration ist in verfügbar Installierte Integrationen Registerkarte im Integrations Launchpad.

    Nächste Maßnahme

    Weisen Sie Ihren API-Client an, Protokollnachrichten an zu senden MID-Server.
    1. Konfigurieren Sie im API-Client eine Anforderung mit den folgenden Parametern:
      • HTTP-Methode: POST.
      • URL: Die URL, die Sie in kopiert haben Setup-Anweisung Bildschirm.
      • Authentifizierung: Die erforderlichen Anmeldeinformationen für die Authentifizierung. Beispiel: Standardauthentifizierung (Anwendername und Passwort).
        Hinweis:
        Die Authentifizierungsmethode muss mit der auf dem MID-Webserver konfigurierten Methode identisch sein.
      • Header: Legen Sie fest Inhaltstyp Header, der Ihrem Nutzlastformat entspricht.
        • Für JSON: Anwendung/JSON .
        • Für Rohtext: Text/nur .
      • Textkörper: Die Protokollnutzlast in JSON oder Rohtext.
    2. Senden Sie die Anforderung.

      Eine erfolgreiche Antwort gibt an, dass MID-Server Hat die Nutzlast erhalten. Wenn MID-Server Hat die Protokollnachrichten verarbeitet, die Dateneingabe streamt sie an Ihren ServiceNow Instanz, die das REST-Protokoll verwendet.