MID-WebService-Event-Sammlerkontext konfigurieren

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer
  • Konfigurieren Sie den MID-WebService-Event-Sammlerkontext, damit eine URL-Methode Event-Nachrichten von einer externen Quelle an den MID-Server übertragen kann.

    Vorbereitungen

    Stellen Sie sicher, dass das Plugin Ereignismanagement „ Connectors“ (sn_em_connector) in der Instanz Now Platform installiert ist.

    Erforderliche Rolle: evt_mgmt_admin

    Warum und wann dieser Vorgang ausgeführt wird

    Das Standardformat der URL zum Versenden von Eventnachrichten aus einer externen Quelle an den MID-Server ist http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/jsonv2. Diese URL bietet eine gute Leistung.

    Aus einer externen Quelle lautet das URL-Format für Push-Event-Nachrichten, die nicht im jsonv2-Format vorliegen: http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event?Transform={Name_of_Transform_Script}, wobei die Variable {Name_of_Transform_Script} der vollständige Name des Skripts ist und immer mit dem Text: TransformEvents_ beginnt.

    Nehmen Sie beispielsweise die folgenden Werte an:
    • {MID_Server_IP}: 10.118.69.27
    • {MID_Web_Server_Port}: 8097
    • Name des Transformationsskripts: EventsToProcess
    Die zu verwendende URL lautet daher: http://10.118.69.27:8097/api/mid/em/inbound_event/TransformEvents_EventsToProcess
    Hinweis:
    • Die URL im Format http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/{transform_script_name} wird ebenfalls unterstützt.
    • Das Datumsformat für Events ist jjjj-Md h:mm:ss.

      Wenn Sie ein Event erhalten, dessen Datum in einem anderen Format vorliegt, müssen Sie ein {transform_script_name} verwenden, das für das Datumsformat des eingehenden Events geeignet ist. Andernfalls wird das Event nicht ordnungsgemäß verarbeitet.

      Beispiel: Wenn ein Event am 27. Juni 2019 um 11:25 Uhr mit dem aufgelisteten Datum 2019/06/27/ 11:25:00 a ankommt, verwenden Sie ein {transform_script_name} mit dem Datumsformat yyyy/MM/dd/ HH:mm:ss a, damit es dem Format des empfangenen Events entspricht.

    Prozedur

    1. Navigieren zu Alle > Ereignismanagement > Integrationen > MID-WebService-Event-Listener.
    2. Klicken Sie in der Liste MID WebService Event-Sammlerkontexte auf Neu.
    3. Füllen Sie die Felder des Formulars aus.
      Tabelle : 1. Formular für MID WebService-Event-Sammlerkontext
      Feld Beschreibung
      Name Ein eindeutiger Name für diesen Sammler zur einfachen Identifizierung.
      Kurzbeschreibung Geben Sie eine kurze, aussagekräftige Beschreibung dieses Sammlers ein.
      MID-Webservererweiterung Angeben und dann die MID-Webserver-Erweiterung starten. Die unterstützten Authentifizierungsmethoden werden im Feld Authentifizierungstyp der MID-Webserver-Erweiterung aufgeführt. Informationen zum Konfigurieren einer MID-Webserver-Erweiterung finden Sie unter MID-Webserver konfigurieren.
      Status Dieses Feld wird automatisch mit dem Status der MID-Webserver-Erweiterung ausgefüllt. Dieses Feld ist leer, bis die MID-Webserver-Erweiterung gestartet ist. Nach der Ausgabe eines Befehls an die MID-Webserver-Erweiterung wird einer der folgenden Werte angezeigt:
      • Gestartet: Der Sammler läuft.
      • Angehalten: Der Sammler läuft nicht.
      • Offline: Der MID-Server ist nicht erreichbar.
      • Fehler: Der Sammler ist mit einem Fehler fehlgeschlagen (die Fehlermeldung wird im Feld Fehlermeldungangezeigt).
      • Warnung: Eine Laufzeitausnahme ist aufgetreten.
      Ausführen auf Spezifischer MID Server oder spezifischer MID Server-Cluster, wie in der angegebenen MID-Webservererweiterung definiert.
      MID-Server Der spezifische MID Server oder spezifische MID Servercluster, wie in der angegebenen MID-Webserver-Erweiterung definiert.
      Ausführung auf Der Name des MID-Server, auf dem die MID-Webserver-Erweiterung ausgeführt wird.
    4. Klicken Sie mit der rechten Maustaste auf den Header des Formulars, und klicken Sie auf Speichern.
    5. Klicken Sie unter Zugehörige Links auf Starten, um den Sammler zu starten.
      Tabelle : 2. Befehle im Kontextformular Ereignismanagement
      Zugehöriger Link Beschreibung
      Starten Startet den Sammler, falls er nicht läuft. Diese Aktion überprüft, ob ein Webservice-API-Endpunkt mit der Ereignismanagement-Anwendung auf MID-Server ausgeführt wird.
      Stoppen Hält den laufenden Sammler auf dem konfigurierten MID-Server an. Wenn der Sammler nicht ausgeführt wird, wird keine Aktion ausgeführt.
      Neu starten Stoppt und startet den Sammler auf dem konfigurierten MID-Server.
      Parameter aktualisieren Sendet aktualisierte Parameter an den Sammler. Parameter werden auch aktualisiert, wenn die Kontexterweiterung Ereignismanagement MID-Server aktualisiert wird. Wenn Sie auf dieses Steuerelement klicken, während der Sammler nicht ausgeführt wird, wird keine Aktualisierung vorgenommen.

    Beispiel

    Zeigt die Verwendung der URL zum Umwandeln von JSON v2-formatierten Event-Nachrichten an

    Angenommen, Event-Nachrichten im JSON v2-Format werden an MID-Server gesendet. Bei Verwendung der jsonv2- URL ist keine Skripteinbindung erforderlich.

    Tabelle : 3. Daten für das JSON v2-Beispiel
    Feld Wert
    MID_Server_IP 10.218.64.27
    MID_Web_Server_Extension_Port 8097
    Event-Nachrichtenformat jsonv2

    Ersetzen Sie die Variablen im Standardformat der URL http://<my-instance>.service-now.com/api/global/em/jsonv2 mit Werten aus der vorherigen Tabelle: http://10.218.64.27:8097/api/global/em/jsonv2

    Beispiel für die URL für Push-Nachrichten, die nicht im jsonv2-Format vorliegen

    Das URL-Format für Push-Event-Nachrichten aus einer externen Quelle, die nicht im jsonv2-Format vorliegen, lautet: http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event?Transform={Name_of_Transform_Script}, wobei die Variable {Name_of_Transform_Script} der vollständige Name des Skripts ist und immer mit dem Text: TransformEvents_ beginnt. Der Skriptname muss als Header-Parameter Transform angegeben werden und muss immer mit dem Präfix TransformEvents_ beginnen.

    Nehmen Sie in diesem Beispiel an, dass der Skriptname EventsToProcess lautet. Die URL lautet daher:http://10.138.64.27:8097/api/mid/em/inbound_event/TransformEvents_EventsToProcess

    Beispiel für Event-Nachrichten im JSON v2-Format
    Hinweis:
    Beim Kopieren und Einfügen des folgenden Texts werden möglicherweise auch ausgeblendete Zeichen kopiert, was zu unerwarteten Ergebnissen führen kann.
    
    curl -v -H "Accept: application/json" -H "Content-Type: application/json" -X POST --data "{
        "records":
        [ {
             \"source\" : \"Simulated\",
            \"node\" : \"nameofnode\",
            \"type\" : \"High Virtual Memory\",
            \"resource\" : \"C:\",
            \"severity\" : \"5\",
            \"description\" : \"Virtual memory usage exceeds 98%\",
            \"ci_type\":\"cmdb_ci_app_server_tomcat\",
            \"additional_info\":\"{\\\"name\\\":\\\"My Airlines\\\"}\"
          },
          {
          \"source\" : \"Simulated\",
          \"node\" : \"01.myairlines.com\",
          \"type\" : \"High CPU Utilization\",
          \"resource\" : \"D:\",
          \"severity\" : \"5\",
          \"description\" : \"CPU on 01.my.com at 60%\"
          }
       ]
    }" -u UserName:Password http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/jsonv2