Geführtes Setup für MID-Server-Verbraucher

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 8 Minuten Lesedauer

    • Implementieren Sie die folgenden Schritte für ein vollständiges geführtes Setup für MID-Server-Verbraucher.

    Vorbereitungen

    Navigieren zu Protokollexportservice (LES) > MID-Serververbraucher > Geführtes Setupan. Wählen Sie die Art des Setups aus, das Sie konfigurieren möchten, und wählen Sie sie aus Fahren Sie Fort .
    Hinweis:
    Während des Protokollexportservice Anwendungsinstallation, ServiceNow Stellt den zugrunde liegenden bereit Hermes Messaging-Service Infrastruktur. Beachten Sie, dass dieser Prozess ab dem Zeitpunkt, zu dem Sie den anfordern, bis zu einige Stunden dauern kann Protokollexportservice Anwendungsinstallation.

    Erforderliche Rolle: Administrator

    Prozedur

    1. Überprüfen Hermes Messaging-Service Diagnose.

      Es wird empfohlen, dass Sie überprüfen, ob Hermes Messaging-Service Wird mit gestartet und ausgeführt Hermes Diagnosetool, das während dieses Schritts auf dem Bildschirm angezeigt wird. Wenn auf dieser Seite der Fehler „Seite nicht gefunden“ angezeigt wird, Hermes Ist nicht installiert, und wenden Sie sich an Ihren Systemadministrator.

      • Setup-Informationen: Die folgenden Bootstrap-Informationen werden verwendet, um eine Verbindung zum Hermes-Messaging-Service herzustellen. Der „Produzenten-Bootstrap“ ist die Verbindung, die zum Senden von Nachrichten an Hermes verwendet wird, und „Verbraucher-Bootstrap 1 und 2“ werden verwendet, um Nachrichten von Hermes abzurufen.
        • Produzenten-Bootstrap
        • Verbraucher-Bootstrap 1
        • Verbraucher-Bootstrap 2
      • Instanz-PKI: Die Komponente „Public Key Infrastructure“ (PKI) der Instanz ermöglicht es einer ServiceNow-Instanz, als Aussteller in einer X.509-Vertrauenshierarchie zu fungieren.
      • Bootstrap-Konnektivität: Auswählen Test Ausführen Um zu bestätigen, dass der externe Client eine Verbindung zu den definierten Instanzports (Hersteller und Verbraucher) herstellen kann.
      • Instanzkonnektivität: Wählen Sie Aus Test Ausführen Um zu bestätigen, dass die Instanz Nachrichten senden und empfangen kann.
      • Themen anzeigen: Wählen Sie das aufgelistete Thema aus, um den Zeitstempel der letzten bekannten Nachricht abzurufen.
      Hinweis:
      Sie können auf zugreifen Hermes Diagnosen in Zukunft zur Behebung potenzieller Verbindungsprobleme, indem Sie zu diesem Schritt des geführten Setups zurückkehren oder zu navigieren Alle > Hermes Messaging-Service > Diagnosenan.
    2. Generieren Sie Zertifikate für eine sichere Verbindung mit dem Hermes-Messaging-Service, und rufen Sie Protokollereignisse daraus ab.

      Richten Sie eine sichere Verbindung zum Hermes-Messaging-Service ein. Siehe Richten Sie eine sichere Verbindung zum Hermes-Messaging-Service für LES ein Für weitere Informationen. Sie benötigen diese Zertifikate für die Authentifizierung und Autorisierung im Client, der die Protokolle von Hermes abruft.

      Hinweis:
      Für diesen Schritt sind die Rollen „administrator“ oder „Hermes_admin“ erforderlich.
    3. Protokollersteller konfigurieren: Wählen Sie zu exportierende Protokollquellen aus, und konfigurieren Sie ihre Filter.
      Führen Sie die folgenden Aufgaben aus, um den Protokollhersteller zu konfigurieren.
      • Konfigurieren Sie die zu exportierenden Protokollquellen: Erstellen Sie einen Quelldatensatz für jede der Protokollquellen, die Sie exportieren möchten.
        Hinweis:
        Zum Abschließen dieses Schritts sind die Rollen „administrator“ oder „sn_logstoAnalytics.admin“ erforderlich

        Um eine neue Quelle zu erstellen, navigieren Sie zu Protokollexportservice > Quellen

        1. Wählen Sie Aus Neu In der oberen rechten Ecke
        2. Wählen Sie einen Quelltyp aus
        3. Tabelle auswählen
        4. Wählen Sie eine Protokollebene aus, die zur Steuerung der Protokollierungsausgabe verwendet werden kann
        5. Wählen Sie ein Thema aus, in das diese Protokollquelle exportiert wird, oder erstellen Sie es. Wenn Sie ein neues Thema erstellen, füllen Sie die folgenden Felder aus:
          • Name : Name des Themas, das Sie erstellen
          • Anwendungs-ID : Eingabetaste sn_logstoAnalytics
          • Namespace : Geben Sie Den Standard-Namespace Ein
          • Partition : Das Partitionsfeld eines Themas in Hermes bezieht sich auf die Partitionen, in die die Daten des Themas unterteilt sind. Es spielt eine Schlüsselrolle bei Skalierbarkeit und Parallelität.
        6. Wählen Sie ein aus Filtertyp Bedingung zum selektiven Weiterleiten von Protokollen.
          Hinweis:
          Die Filtertypoptionen unterscheiden sich je nach ausgewähltem Quelltyp.
        7. Wählen Sie Aktualisieren
        Bei erfolgreicher Erstellung wird der Name des Hermes-Themas angezeigt, in das diese Protokollquelle exportiert wird. Notieren Sie sich den Themennamen. Sie benötigen ihn später, wenn Sie Ihr Protokoll-Verbrauchersystem konfigurieren.

        Das Feld aktiv steuert, ob diese Protokollquelle exportiert wird oder nicht. Wenn Fehler angezeigt werden, kehren Sie zur Aufgabe „Hermes-Diagnose überprüfen“ zurück, und überprüfen Sie den Hermes-Status.

      • Protokollersteller validieren: Sobald Sie eine Quelle erstellt haben, aus der Protokolle erstellt werden sollen, können Sie Live-Protokolldatensätze im Thema mit anzeigen Hermes-Messaging-Service > Hermes-Themeninspektoran.
        1. Wählen Sie Externe Themen Aus
        2. Wählen Sie Themen Auflisten
        3. Zeile mit Ihrem Thema aus dem vorherigen Schritt auswählen (in Quellen aufgeführt)
        4. Passen Sie das Startdatum der Nachricht bei Bedarf an
        5. Wählen Sie Aus Anzeigen Dient zum Anzeigen einer Protokollnachricht, die in das Thema exportiert wurde
    4. MID-Server installieren: Sie müssen einen dedizierten MID-Server installieren und konfigurieren, auf dem Vancouver oder höher ausgeführt wird.
      Führen Sie die folgenden Aufgaben aus, um den MID-Server zu installieren.
      • Dedizierten MID-Server installieren: Der MID-Server, den der Protokollexportservice verwendet, sollte nur für diesen Zweck dediziert sein und sollte nicht erwartet werden, dass er andere Prozesse ausführt. Dies ist wichtig, um die rechtzeitige Bereitstellung exportierter Protokollnachrichten an Ihren REST-Endpunkt sicherzustellen. Sie können den neuen MID-Server entweder mit installieren Use MID Server guided setup Oder durch manuelle Installation. Befolgen Sie für die manuelle Installation die Configure MID Server network connectivity Dokumentation zuerst und dann Installing the MID Server Dokumentation danach.
      • MID-Server validieren: Sie müssen den MID-Server nach der Installation manuell validieren, damit er Automatisierungsaufgaben ausführen kann. Informationen zum Validieren des MID-Servers, den Sie für LES bereitstellen, finden Sie unter Validate the MID Server
    5. Protokoll-REST-Push-Ziel konfigurieren: Richten Sie den MID-Server ein, um Protokolle an Ihr Protokoll-Analytics-System (z. B. Splunk) übertragen zu können.
      Führen Sie die folgenden Aufgaben aus, um das Protokoll-REST-Push-Ziel zu konfigurieren.
      • MID-Eigenschaften hinzufügen: Sie müssen MID-Servereigenschaften hinzufügen, damit eine Verbindung zu Hermes hergestellt werden kann. Navigieren Sie zu MID-Server > Eigenschaften Und legen Sie die entsprechenden Werte für jede der unten aufgeführten Eigenschaften fest.
        Name Wert
        Mid.les.kafka.ssl.Truststore.password <password>
        Mid.les.kafka.ssl.Schlüsselspeicher.Passwort <password>
        Mid.les.kafka.ssl.key.password <password>
        Mid.les.kafka.ssl.Truststore.location <your_path>/<truststore>.p12
        Mid.les.kafka.ssl.Schlüsselspeicher.location <your_path>/<keystore>.p12
        Mid.les.kafka.ssl.Truststore.type PKCS12
        Mid.les.kafka.ssl.Schlüsselspeicher.type PKCS12
        mid.les.kafka.client.id <instance_name>
        mid.les.kafka.group.id snc.<instance_name>.group1
        mid.les.kafka.bootstrap.servers <instance_name>.servicenow.com:4100,<instance_name>.servicenow.com:4101,<instance_name>.servicenow.com:4102,<instance_name>.servicenow.com:4103
        mid.les.kafka.set2.bootstrap.servers <instance_name>.servicenow.com:4200,<instance_name>.servicenow.com:4201,<instance_name>.servicenow.com:4202,<instance_name>.servicenow.com:4203
        Befolgen Sie diese Hinweise, um einige der oben genannten Werte zu erhalten
        • <password> ist das Passwort, das Sie für den Schlüsselspeicher und den Truststore festgelegt haben
        • <your_path> ist der Dateipfad zu dem Verzeichnis, in dem Sie die heruntergeladenen Schlüsselspeicher- und Truststore-Dateien aufbewahren. Die Zertifikate müssen sich auf dem Server befinden, auf dem Sie MID ausführen
        • <instance_name> ist der Name Ihrer ServiceNow-Instanz. Wenn Sie sich nicht sicher sind, finden Sie es in der Tabelle „sys_properties“
        • Sie können die Werte für mid.les.kafka.bootstrap.servers und mid.les.kafka.set2.bootstrap.servers auf der Seite „Hermes-Diagnose“ abrufen. Navigieren zu Hermes-Messaging-Service > Diagnosen Und kopieren Sie die Zeichenfolgen unter Verbraucher-Bootstrap 1 bzw. Verbraucher-Bootstrap 2.
      • Ziel konfigurieren: Erstellen Sie einen neuen Zielkonfigurationsdatensatz, der den REST-Endpunkt definiert, an den diese Erweiterung Protokolle weiterleitet.
        Hinweis:
        Zum Abschließen dieses Schritts sind die Rollen „administrator“ oder „sn_logstoAnalytics.admin“ erforderlich.
        1. Navigieren zu Protokollexportservice (LES) > Zielkonfigurationen 
        2. Erstellen Sie einen neuen Konfigurationsdatensatz
        3. Geben Sie die URL für den gewünschten Endpunkt für die exportierten Protokollquellen an
        4. Suchen oder erstellen Sie neue Anmeldeinformationen, um eine Verbindung mit Ihrem Endpunkt herzustellen. Beachten Sie beim Erstellen von Anmeldeinformationen für Ihren Endpunkt, dass nur die folgenden Anmeldeinformationstypen für LES gültig sind: Standardauthentifizierung und OAuth
        5. Suchen oder erstellen Sie ein neues Transformationsskript. Wir werden mit dem vorgeschriebenen Skript geliefert, SplunkTransform Für Splunk
    6. PROTOKOLLVERBRAUCHER konfigurieren: Führen Sie diese Aufgaben aus, um Ihre MID-Servererweiterung für Protokollexportservices zu konfigurieren.
      • LES-Verbraucherkontext konfigurieren: In diesem Schritt aktualisieren Sie den LES-Verbraucher-Datensatz so, dass er auf dem dedizierten MID-Server ausgeführt wird, den Sie gerade für den Protokollexportservice installiert haben. Navigieren zu MID-Server > Erweiterungen > LES-Verbraucherkontext Und aktualisieren Sie den LES-Verbraucher-Datensatz, indem Sie die folgenden Felder festlegen:
        • Wählen Sie unter „LES Consumer“ aus, um den MID-Server-Kontextdatensatz zu öffnen
        • Wählen Sie einen bestimmten MID-Server für das Feld „Ausführen auf“ aus
        • Geben Sie den Namen des MID ein, den Sie im vorherigen Schritt für das Feld „MID-Server“ validiert haben
        Hinweis:
        • Jeder Verbraucher ist so konzipiert, dass Daten aus einem einzelnen Hermes-Thema mithilfe seines eigenen Verbraucherkontexts verarbeitet werden.
        • Jeder Verbraucherkontext wird auf einem dedizierten MID-Server ausgeführt, um eine optimale Leistung sicherzustellen.
        • Wir empfehlen, für jeden Verbraucherkontext, den Sie erstellen, einen separaten MID-Server zu konfigurieren.
      • Verbraucher konfigurieren: Erstellen Sie einen neuen Verbraucherdatensatz, der den Prozess darstellt, der Teil der MID-Servererweiterung des Protokollexportservice ist. Navigieren zu Protokollexportservice (LES) > Verbraucher Und erstellen Sie einen neuen Konfigurationsdatensatz, der das Hermes-Thema angibt, von dem Protokollnachrichten abgerufen werden sollen, und das Ziel, an das sie weitergeleitet werden sollen. Wenn Sie auswählen Verbraucher Modul, zeigt Informationen zum Verbrauchernamen und zur Zielkonfiguration an.
        1. Erstellen Sie einen neuen Verbraucherdatensatz
        2. Wählen Sie ein Quellthema aus der Dropdown-Liste aus
        3. Wählen Sie die Zielkonfiguration aus
      • MID-Verbindung testen: Überprüfen Sie die Konnektivität aus der MID-Serverumgebung zum Hermes-Cluster, bevor Sie den Verbraucher starten.

        Erforderliche Rollen: administrator oder sn_logstoAnalytics.admin

        Navigieren zu Protokollexportservice (LES) > Verbraucher Und testen Sie die Verbindung:
        1. Öffnen Sie den vorhandenen Verbraucherdatensatz.
        2. Klicken Sie auf Testen Sie die MID-Verbindung UI-Aktion
          1. Dies validiert die Konnektivität zwischen der MID-Serverumgebung und dem Hermes-Cluster
          2. Das Statusfeld ändert sich in „Kafka-Netzwerkkonnektivität wird überprüft“.
        3. Warten Sie, bis der Test abgeschlossen ist, und aktualisieren Sie dann die Seite
        4. Überprüfen Sie die Felder „Status“ und „Statusdetails“
        5. Wenn erfolgreich: Netzwerkkonnektivität wurde bestätigt. Aktualisieren Sie die Seite, und überprüfen Sie, ob die Felder „Status“ und „Statusdetails“ den Erfolg widerspiegeln.

          Starten Sie den Verbraucher.

        6. Wenn nicht erfolgreich: Bitte anhalten, bevor Sie fortfahren. Überprüfen Sie die Protokolle DES MID-Server-Agenten, um die Ursache zu verstehen. Zu überprüfende allgemeine Bereiche:
          1. MID-Servereigenschaften sind korrekt konfiguriert
          2. Netzwerkkonnektivität ist zwischen dem MID-Server und dem Hermes-Cluster verfügbar
        Hinweis:
        Der Test DER MID-Verbindung muss erfolgreich sein, bevor der Verbraucher gestartet wird.
      • MID-Serverintegration verifizieren: Navigieren Sie zu   Protokollexportservice (LES) > Verbraucherstatus Und zeigen Sie die Felder Status und Statusdetails des definierten Datensatzes an. Die Informationen in diesen Feldern melden den aktuellen Status des auf dem MID-Server ausgeführten Prozesses, einschließlich aller Fehler, die beim Weiterleiten von Nachrichten an den REST-Endpunkt aufgetreten sind. Dies ist nur eine Statusansichtsseite. Navigieren zu Protokollexportservice (LES) > Verbraucher Wenn Sie einen neuen Verbraucherdatensatz erstellen möchten.  Wenn der Verbraucherstatus angibt, dass der Prozess gestartet wurde, sollten Sie Ihren Endpunkt überprüfen können, um die Protokolle anzuzeigen, die an ihn weitergeleitet wurden.  Darüber hinaus können Sie die Protokolle auf dem MID-Server anzeigen, um zu sehen, ob zusätzliche Details zu eventuell aufgetretenen Fehlern vorhanden sind. Sie können die Debugging-Protokollierung auch auf dem MID-Server aktivieren, um bei Bedarf zusätzliche Informationen zu erhalten.
        Hinweis:
        Wenn Sie Änderungen an einem der Verbraucherdatensätze vornehmen, wird dies auf der Seite „Verbraucherstatusansicht“ angezeigt. Wenn Sie in der Liste „Verbraucherstatus“ einen Verbraucherdatensatznamen auswählen, wird das Verbraucherformular für den ausgewählten Datensatz geöffnet. Sie können dann die Name- und Zielkonfiguration des ausgewählten Datensatzes aktualisieren.