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

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

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

    Vorbereitungen

    Navigieren zu Export-Service protokollieren (LES) > MID-Server-Verbraucher > 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 ein paar Stunden dauern kann Protokollexportservice Anwendungsinstallation.

    Erforderliche Rolle: Administrator

    Prozedur

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

      Es wird empfohlen, dass Sie überprüfen, ob die Hermes Messaging-Service Wird mit 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. „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 Weitere Informationen finden Sie unter . 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 Protokollquellen aus, die exportiert werden sollen, und konfigurieren Sie ihre Filter.
      Führen Sie die folgenden Aufgaben aus, um den Protokollersteller zu konfigurieren.
      • Konfigurieren Sie Protokollquellen für den Export: 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 Log Export Service > 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, den Sie später benötigen, 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 Protokollexport-Service verwendet, sollte nur für diesen Zweck dediziert sein und darf 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 die 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 zur Validierung des MID-Servers, den Sie für LES dedizieren, finden Sie unter Validate the MID Server
    5. Protokoll-REST-Push-Ziel konfigurieren: Richten Sie den MID-Server ein, damit Protokolle an Ihr Protokoll-Analytics-System (z. B. Splunk) übertragen werden 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-Server-Eigenschaften 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.Keystore.password <password>
        Mid.les.kafka.ssl.key.password <password>
        Mid.les.kafka.ssl.Truststore.location <your_path>/<truststore>.p12
        Mid.les.kafka.ssl.Keystore.location <your_path>/<keystore>.p12
        Mid.les.kafka.ssl.Truststore.type PKCS12
        Mid.les.kafka.ssl.Keystore.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 speichern. 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 sie 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 Export-Service protokollieren (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 Sie nach neuen Anmeldeinformationen, oder erstellen Sie neue Anmeldeinformationen, um eine Verbindung mit Ihrem Endpunkt herzustellen. Beachten Sie beim Erstellen von Anmeldeinformationen für Ihren Endpunkt, dass für LES nur die folgenden Anmeldeinformationstypen gültig sind: Standardauthentifizierung, OAuth, API-Schlüssel
        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 Protokollexport-Service-Zwecke 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 Protokollexport-Service 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
        Wählen Sie Aus Aktualisieren Zum Speichern.
        Hinweis:
        Wir werden mit einem vorgefertigten Kontext geliefert. Erstellen Sie keine zweite. Dies kann unbeabsichtigte Konsequenzen haben.
      • Verbraucher konfigurieren: Erstellen Sie einen neuen Verbraucherdatensatz, der den Prozess darstellt, der Teil der MID-Servererweiterung des Protokollexportservice ist. Navigieren zu Export-Service protokollieren (LES) > Verbraucher Und erstellen Sie einen neuen Konfigurationsdatensatz, der das Hermes-Thema zum Abrufen von Protokollnachrichten und das Ziel angibt, 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
        4. Starten Sie Verbraucher
      • MID-Server-Integration verifizieren: Navigieren Sie zu   Export-Service protokollieren (LES) > Verbraucherstatus Und zeigen Sie die Felder Status und Statusdetails des definierten Datensatzes an. Die Informationen in diesen Feldern berichten über 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 Export-Service protokollieren (LES) > Verbraucher Wenn Sie einen neuen Verbraucherdatensatz erstellen möchten.  Wenn der Verbraucherstatus anzeigt, 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 auch die Debug-Protokollierung 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.