Konfigurieren Sie REST API-Dateneingaben

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 1 Minute Lesedauer

    • Konfigurieren Sie eine REST API-Dateneingabe für das Streaming von Protokolldaten an Ihre ServiceNow-Instanz im JSON-Format.

    Vorbereitungen

    • 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

    Warum und wann dieser Vorgang ausgeführt wird

    Die Erweiterung verarbeitet Protokollnachrichten, die von einer externen Protokollquelle an den MID-Server gesendet werden. Der MID-Server verarbeitet die Nachrichten und übergibt sie dann an Ihre Instanz.

    Zum Streamen von Protokollnachrichten an den MID-Server muss die URL das Format http://{MID_SERVER_IP}:{MID_WEB_SERVER_PORT}/api/mid/hla/raw haben, wobei /api/mid/hla/raw der Endpunkt ist.

    Prozedur

    1. Navigieren zu Alle > Health Log Analytics > Dateneingabe > Dateneingaben.
    2. Wählen Sie auf der Seite „Data Inputs“ (Dateneingaben) die Option Neu aus.
    3. Wählen Sie die REST API-Dateneingabe aus.
    4. Füllen Sie die Felder des Formulars aus.
      Feldbeschreibungen finden Sie unter Konfigurationsfelder für die REST-API-Dateneingabe.
    5. Wählen Sie Absenden.

    Ergebnisse

    Der Konfigurationsprozess für die Dateneingabe ist abgeschlossen. Health Log Analytics fügt den Dateneingabedatensatz der Tabelle „Dateneingaben“ hinzu und hängt die Konfigurationsdatei an den Dateneingabedatensatz an. Die Dateneingabe beginnt mit dem Streaming von Protokolldaten im JSON-Format an Ihre Instanz ServiceNow.
    Hinweis:
    Wenn die KI-Engine Health Log Analytics ausgefallen ist und das Streaming von Daten beendet wurde, wird oben auf der Konfigurationsseite für die Dateneingabe eine Benachrichtigung angezeigt. Wenden Sie sich in diesem Fall an den Support ServiceNow.

    Nächste Maßnahme

    Stellen Sie sicher, dass die Dateneingabe aus Streaming-Daten besteht.