Dateneingaben konfigurieren (REST API)

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 1 Minute Lesedauer
  • Konfigurieren Sie eine REST API-Dateneingabe für das Streaming von Protokolldaten an Ihre ServiceNow-Instanz im JSON-Format.Die Konfiguration der Dateneingabe ist ein wichtiger Schritt beim Einrichten der Anwendung Health Log Analytics (HLA).

    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.
    • Stellen Sie sicher, dass ein MID-Server mit aktivierter Protokollerfassungsfunktion installiert und konfiguriert ist.

      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, in 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 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.

    Nächste Maßnahme

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