---
sourceDocument: IT Operations Management Zürich
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/zurich/it-operations-management

 Release :

    - zurich

ft:locale :

    - de-DE

ft:publication_title :

    - IT Operations Management Zürich

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Event-Erfassung aus benutzerdefinierten Nutzlasten

# Event-Erfassung aus benutzerdefinierten Nutzlasten {#ariaid-title1}

* Freigeben Version: Zurich
* 
* Aktualisiert 31. Juli 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Mit dem MID WebService-Eventsammler können Sie Event-Informationen aus benutzerdefinierten Nutzlasten im JSON-, XML- oder Nur-Text-Format erfassen.

## Vorbereitungen

Stellen Sie sicher, dass Ereignismanagement Plugin „Connectors" (sn_em_Connector) ist auf installiert ServiceNow AI Platform Instanz.

Erforderliche Rolle: evt_mgmt_admin

## Warum und wann dieser Vorgang ausgeführt wird

Der MID-Server transformiert die erfassten Event-Nachrichten und füllt die Event-Tabellenfelder (em_table) in der Instanz aus. Das folgende Verfahren beschreibt die Erfassung von JSON-formatierten Event-Nachrichten mit Standardauthentifizierung. Weitere Informationen zu unterstützten Authentifizierungsmethoden finden Sie unter [MID-Webserver erweiterung konfigurieren](https://www.servicenow.com/docs/eEyxSwQq7VLX13eZyRFvIw "Der MID-Webserver ist eine MID-Server erweiterung, die die Entwicklung von REST APIs zum Senden von Events und Metriken an den MID-Server ermöglicht. Die Erweiterung wird von anderen MID-Server-Erweiterungen genutzt, z. B. Metrikdaten, MID-WebService-Event-Listener und der Agent Client Collector-Websocket-Endpunkterweiterung.").

Das Format der erforderlichen MID-Server-URL ist: <kbd class="ph userinput">http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event?Transform={Transform_script_name}</kbd>. Der Name der MID-Server-Skripteinbindung setzt sich aus dem Anfügen eines Suffixes an das Standardpräfix `TransformEvents_` zusammen. Informationen zur Erfassung von JSON v2-Event-Nachrichten finden Sie unter [MID-WebService-Event-Sammlerkontext konfigurieren](https://www.servicenow.com/docs/sQ3TbpCBTV0zSsp7ad0K0w "Konfigurieren Sie den MID-WebService-Event-Sammlerkontext, damit eine URL-Methode Event-Nachrichten von einer externen Quelle an den MID-Server übertragen kann.").  
Hinweis:  
Die URL im Format `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/{transform_script_name}` wird ebenfalls unterstützt.

## Prozedur

1. Konfigurieren Sie den MID-WebService-Eventsammler, siehe [MID-WebService-Event-Sammlerkontext konfigurieren](https://www.servicenow.com/docs/sQ3TbpCBTV0zSsp7ad0K0w "Konfigurieren Sie den MID-WebService-Event-Sammlerkontext, damit eine URL-Methode Event-Nachrichten von einer externen Quelle an den MID-Server übertragen kann.").
2. Starten Sie den MID-WebService-Eventsammler.
{#event-collection-custom-payloads__steps_w5d_clp_ky}

## Beispiel

Transformation von XML-formatierten Event-Nachrichten mithilfe der benutzerdefinierten Nutzlast-URL

Angenommen, Event-Nachrichten im XML-Format werden an MID-Server gesendet. Verwenden Sie dieses Beispiel, um ein Array von Event-Objekten aus den erfassten Event-Nachrichten zurückzugeben. Der Name der MID-Server-Skripteinbindung setzt sich aus dem Anfügen eines Suffixes an das Standardpräfix `TransformEvents_` zusammen. Für die Zwecke dieses Beispiels hat der Benutzer die xmlSample-Skripteinbindung angegeben. Anhand dieser Details lautet der Name der MID-Server-Skripteinbindung `TransformEvents_xmlSample`. Der MID-Server wandelt die erfassten Event-Nachrichten um, indem er die Nachrichten mit der Skripteinbindung analysiert und dann an die Instanz übermittelt.
{#event-collection-custom-payloads__table_bqc_llp_ky__entry__2}

| Feld | Wert |
|-|-|
| MID_Server_IP | 10.218.64.27 |
| MID_Web_Server_Extension_Port | 8097 |
| transform_script_suffix_name | xmlSample |
[Tabelle : 1. Daten für das XML-Beispiel]

{#event-collection-custom-payloads__table_bqc_llp_ky}

Ersetzen Sie die Variablen in der URL durch die Werte aus der obigen Tabelle: `http://10.218.64.27:8097/api/mid/em/xmlSample`  
Hinweis:  
Beim Kopieren und Einfügen des folgenden Texts werden möglicherweise auch ausgeblendete Zeichen kopiert, was zu unerwarteten Ergebnissen führen kann.

Beispiel für Event-Nachrichten im XML-Format:

    <records>
        <event>
        <source>My Source</source>
        <node>host1</node>
        <type>type1</type>
        <severity>3</severity>
        <description>Virtual memory usage exceeds 98%</description>
        </event>
        <event>
        <source>My Source</source>
        <node>host2</node>
        <type>type2</type>
        <severity>2</severity>
        <description>Virtual memory usage exceeds 90%</description>
        </event>
        </records>

**Zugehörige Tasks**   

* [MID-Webserver erweiterung konfigurieren](https://www.servicenow.com/docs/eEyxSwQq7VLX13eZyRFvIw "Der MID-Webserver ist eine MID-Server erweiterung, die die Entwicklung von REST APIs zum Senden von Events und Metriken an den MID-Server ermöglicht. Die Erweiterung wird von anderen MID-Server-Erweiterungen genutzt, z. B. Metrikdaten, MID-WebService-Event-Listener und der Agent Client Collector-Websocket-Endpunkterweiterung.")
* [MID-WebService-Event-Sammlerkontext konfigurieren](https://www.servicenow.com/docs/sQ3TbpCBTV0zSsp7ad0K0w "Konfigurieren Sie den MID-WebService-Event-Sammlerkontext, damit eine URL-Methode Event-Nachrichten von einer externen Quelle an den MID-Server übertragen kann.")