---
sourceDocument: Yokohama IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/it-operations-management

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Konfigurieren des MID-WebService-Ereignissammlerkontexts

# Konfigurieren des MID-WebService-Ereignissammlerkontexts {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 Minuten Lesedauer

Konfigurieren Sie den Kontext des MID-Webservice-Ereignissammlers, um eine URL-Methode zum Verschieben von Ereignisnachrichten aus einer externen Quelle an bereitzustellen MID-Server.

## Vorbereitungen

Stellen Sie sicher, dass EreignismanagementPlugin „Connectors" (sn_em_Connector) ist auf installiert Now PlatformInstanz.

Erforderliche Rolle: evt_mgmt_admin

## Warum und wann dieser Vorgang ausgeführt wird

Das Standardformat der URL zum Verschieben von Ereignisnachrichten aus einer externen Quelle an die MID-ServerIst `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/Mid/em/jsonv2 `. Diese URL bietet eine gute Leistung.

Aus einer externen Quelle lautet das Format der URL für Push-Ereignisnachrichten, 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 <var class="keyword varname">{Name_of_Transform_Script} </var>Variable ist der vollständige Name des Skripts und beginnt immer mit dem Text: <kbd class="ph userinput">Transformationsereignisse_ </kbd>.{#configure-em-context-extension__p_non-json-format}  
Nehmen Sie beispielsweise die folgenden Werte an:

* {MID_Server_IP}: 10.118.69.27
* {MID_Web_Server_Port}: 8097
* Name des Transformationsskripts: Ereignis-ToProcess

{#configure-em-context-extension__ul_asl_dyq_tfb}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 auch unterstützt.
* Das Datumsformat für Ereignisse ist jjjj-M-d h:mm:ss .

  Wenn Sie ein Ereignis erhalten, dessen Datum in einem anderen Format vorliegt, müssen Sie einen verwenden `{Transform_script_Name} `Das für das Datumsformat des eingehenden Ereignisses geeignet ist. Wenn Sie dies nicht tun, wird das Ereignis nicht korrekt verarbeitet.

  Beispiel: Wenn ein Ereignis am 27. Juni 2019 um 11:25 UHR mit einem aufgelisteten Datum von eintrifft 2019/06/27/ 11:25:00 a, Verwenden Sie ein `{Transform_script_Name} `Mit einem Datumsformat von yyyy/MM/dd/ HH:mm:ss aEntspricht dem Format des empfangenen Ereignisses.
  {#configure-em-context-extension__ph_date-format}
{#configure-em-context-extension__ul_wqh_3dw_b5b}

## Prozedur

1. Navigieren zu AlleEreignismanagementIntegrationenMID-WebService-Ereignis-Listeneran.
2. Klicken Sie in der Liste MID-Webservice-Ereignissammlerkontexte auf Neu .
3. Füllen Sie im Formular die Felder aus.  
   {#configure-em-context-extension__table_od5_flc_bx__entry__2}{#configure-em-context-extension__ph_entry-name}{#configure-em-context-extension__ph_entry-short-desc}{#configure-em-context-extension__ph_entry-extension}{#configure-em-context-extension__ph_entry-status}{#configure-em-context-extension__ph_entry-execute-on}{#configure-em-context-extension__ph_entry-mid-server}{#configure-em-context-extension__ph_entry-executing-on}

   | 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 | Geben Sie die MID-Webservererweiterung an, und starten Sie sie dann. Die unterstützten Authentifizierungsmethoden sind in aufgeführt Authentifizierungstyp Feld der MID-Webservererweiterung. Informationen zum Konfigurieren einer MID-Webservererweiterung finden Sie unter [Konfigurieren Sie den MID-Webserver](https://servicenow-prod.fluidtopics.net/xOsCzTl6S_iFh0Af_kH50Q "Die MID-WebserverIst ein MID-ServerErweiterung, mit der die Entwicklung von REST-APIs Ereignisse und Metriken an senden können MID-Server. Die Erweiterung wird von anderen genutzt MID-ServerErweiterungen, z. B. Metrikdaten, MID-Webservice-Ereignis-Listener und Agent Client Collectorwebsocket-Endpunkterweiterung."). |
   | Status | Dieses Feld wird automatisch mit dem Status der MID-Webservererweiterung ausgefüllt. Dieses Feld ist leer, bis die MID-Webservererweiterung gestartet wird. Nach Ausgabe eines Befehls an die MID-Webservererweiterung wird einer der folgenden Werte angezeigt: * Gestartet : Der Sammler wird ausgeführt. * Angehalten : Der Sammler wird nicht ausgeführt. * Offline : Die MID-ServerIst ausgefallen. * Fehler : Der Sammler ist mit einem Fehler fehlgeschlagen (die Fehlermeldung wird in angezeigt Fehlermeldung ). * Warnung : Eine Laufzeitausnahme ist aufgetreten. {#configure-em-context-extension__ul_entry-status} |
   | Ausführen auf | Bestimmter MID-Server Oder Spezifischer MID-Servercluster , Wie in der angegebenen MID-Webservererweiterung definiert. |
   | MID-Server | Die Bestimmter MID-Server Oder Spezifischer MID-Servercluster , Wie in der angegebenen MID-Webservererweiterung definiert. |
   | Ausführung auf | Der Name von MID-ServerAuf dem die MID-Webservererweiterung ausgeführt wird. |
   [Tabelle : 1. Kontextformular FÜR MID-Webservice-Ereignissammler]

   {#configure-em-context-extension__table_od5_flc_bx}
4. Klicken Sie mit der rechten Maustaste auf die Formularüberschrift, und klicken Sie auf Speichern . {#configure-em-context-extension__step_save}
{#configure-em-context-extension__step_save}
5. Unter Zugehörige Links , Klicken Sie auf Starten Zum Starten des Sammlers.  
   {#configure-em-context-extension__table_dhd_tjc_bx__entry__2}

   | Zugehöriger Link | Beschreibung |
   |-|-|
   | Starten | Wenn er nicht ausgeführt wird, starten Sie den Sammler. Mit dieser Aktion wird überprüft, ob ein Webservice-API-Endpunkt mit ist EreignismanagementAnwendung wird auf ausgeführt MID-Server. |
   | Stoppen | Stoppt den ausgeführten Sammler auf dem konfigurierten MID-Server. Wenn der Sammler nicht ausgeführt wird, wird keine Aktion ausgeführt. |
   | Neu starten | Stoppt und startet dann den Sammler auf dem konfigurierten MID-Server. |
   | Parameter aktualisieren | Sendet aktualisierte Parameter an den Sammler. Parameter werden auch aktualisiert, wenn Ereignismanagement MID-ServerKontexterweiterung wird aktualisiert. Wenn Sie auf dieses Steuerelement klicken, während der Sammler nicht ausgeführt wird, wird keine Aktualisierung vorgenommen. |
   [Tabelle : 2. Befehle in EreignismanagementKontextformular]

   {#configure-em-context-extension__table_dhd_tjc_bx} {#configure-em-context-extension__cmd_start}
{#configure-em-context-extension__steps_nd5_flc_bx}

## Beispiel

Die Verwendung der URL zum Transformieren von JSON v2-formatierten Ereignisnachrichten wird angezeigt

Angenommen, dass Ereignisnachrichten im JSON v2-Format an gesendet werden MID-Server. Bei Verwendung von `Jsonv2 `URL, es ist keine Skripteinbindung erforderlich.
{#configure-em-context-extension__table_qzh_fyt_cy__entry__2}

| Feld | Wert |
|-|-|
| MID_Server_IP | 10.218.64.27 |
| MID_Web_Server_Extension_Port | 8097 |
| Ereignisnachrichtenformat | jsonv2 |
[Tabelle : 3. Daten für das JSON v2-Beispiel]

{#configure-em-context-extension__table_qzh_fyt_cy}

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

Beispiel, das die URL zum Senden von Nachrichten nicht im Jsonv2-Format zeigt

Das Format der URL zum Verschieben von Ereignisnachrichten aus einer externen Quelle, die nicht im Jsonv2-Format vorliegen, ist `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/MID/em/inbound_event/Transformation={Name_of_Transform_Script} `Wobei die Variable {Name_of_Transform_Script} der vollständige Name des Skripts ist und immer mit dem Text beginnt: TransformEvents_. Der Skriptname muss als angegeben werden <kbd class="ph userinput">Transformieren </kbd>Header-Parameter und müssen immer mit dem Präfix beginnen <kbd class="ph userinput">Transformationsereignisse_ </kbd>.

Nehmen Sie für dieses 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 Ereignisnachrichten im JSON v2-Format  
Hinweis:  
Beim Kopieren und Einfügen des folgenden Texts können ausgeblendete Zeichen auch kopiert werden, 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

## Beispiel

Beispiel, das JSON v2-formatierte Ereignisnachrichten mit MID-Webserver-API-Schlüssel zeigt  
Hinweis:  
Beim Kopieren und Einfügen des folgenden Texts können ausgeblendete Zeichen auch kopiert werden, was zu unerwarteten Ergebnissen führen kann.


    curl --location -g --request POST 'http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/jsonv2' \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: key <mid_webserver_api_key>' \
    --data-raw '{
       "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%\"
          }
       ]
    }'

**Zugehörige Tasks**   

* [Konfigurieren Sie MID-WebserverErweiterung](https://servicenow-prod.fluidtopics.net/xOsCzTl6S_iFh0Af_kH50Q "Die MID-WebserverIst ein MID-ServerErweiterung, mit der die Entwicklung von REST-APIs Ereignisse und Metriken an senden können MID-Server. Die Erweiterung wird von anderen genutzt MID-ServerErweiterungen, z. B. Metrikdaten, MID-Webservice-Ereignis-Listener und Agent Client Collectorwebsocket-Endpunkterweiterung.")
* [Ereignissammlung aus Microsoft Azure Monitor](https://servicenow-prod.fluidtopics.net/cmG45Hz6Au2~ABVw8wcm~A "Mit dem MID-Webserver-Ereignissammler können Sie JSON-formatierte Ereignisnachrichten erfassen, die von gesendet werden Microsoft AzurePortal.")
* [Ereignissammlung von Google Cloud Platform](https://servicenow-prod.fluidtopics.net/6wpYIGNSJlB3axYf1jp1pw "Mit dem MID-Webservice-Ereignissammler können Sie JSON-formatierte Ereignisnachrichten erfassen, die von gesendet werden Google Cloud Platform (GCP).")  
**Zugehörige Informationen**   

* Ereignissammlung aus BMC TrueSight