Dateneingaben konfigurieren (REST API)

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 1 Minute Lesedauer

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

    Vorbereitungen

    Wichtig:
    Health Log Analytics bietet keine Unterstützung für IPv6. Konfigurieren Sie den MID-Server auf IPv4, um mit der Anwendung zu arbeiten.
    • Ein MID Webserver mit aktivierter Protokollerfassungsfunktion muss konfiguriert sein.

      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 spezifischen MID Server aus, auf den die Protokolldaten abgerufen 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 REST-API-Dateneingabe-Konfigurationsfelder.
    5. Wählen Sie Absenden aus.

    Ergebnisse

    Health Log Analytics fügt den Dateneingabedatensatz in die Dateneingabentabelle ein. Die Dateneingabe startet das Streaming von Protokolldaten im JSON-Format an Ihre Instanz.
    Hinweis:
    Wenn die KI-Engine Health Log Analytics ausgefallen ist und das Daten-Streaming beendet wurde, wird oben auf der Konfigurationsseite der Dateneingabe eine Benachrichtigung angezeigt. Wenden Sie sich in diesem Fall an den Support von ServiceNow.

    Nächste Maßnahme

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