Konfigurieren Sie eine REST-API-Dateneingabe in Health Log Analytics Manuell

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

    • Richten Sie eine REST-API-Dateneingabe für das Streaming von Protokolldaten an Ihren ein ServiceNow Instanz.

    Vorbereitungen

    • Ü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.

    Erforderliche Rolle: evt_mgmt_admin

    Prozedur

    1. Navigieren zu Alle > Health Log Analytics > Dateneingabe > Dateneingabenan.
    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 im Formular die Felder aus.
      Feldbeschreibungen finden Sie unter Konfigurationsfelder für REST-API-Dateneingabe.
    5. Wählen Sie Speichern.
      • Health Log Analytics Fügt den Dateneingabedatensatz zu hinzu Dateneingaben Tabelle.
      • Das System generiert automatisch die REST API-Dateneingabe-URL zum Senden von Protokollen an die MID-Server. Die generierte URL hat dieses Format: http://(MID_SERVER_IP):(MID_WEB_SERVER_PORT)/ap1/mid/hla/raw . HLA Ersetzt (MID_SERVER_IP) Und (MID_WEB_SERVER_PORT) Mit den von Ihnen konfigurierten Werten.
    6. Kopieren Sie die generierte URL.
    7. 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 im vorherigen Schritt kopiert haben.
        • 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.