---
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


---

# Ereignissammlung aus anwenderdefinierten Nutzlasten

# Ereignissammlung aus anwenderdefinierten Nutzlasten {#ariaid-title1}

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

Mit dem MID WebService-Ereignissammler können Sie Ereignisinformationen aus anwenderdefinierten Nutzlasten im JSON-, XML- oder Nur-Text-Format erfassen.

## 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

Die MID-ServerTransformiert die gesammelten Ereignisnachrichten und füllt die Ereignistabellenfelder (em_table) in der Instanz aus. Die Sammlung formatierter Ereignisnachrichten wird in diesem Verfahren mit Standardauthentifizierung beschrieben. Informationen zu unterstützten Authentifizierungsmethoden finden Sie unter [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.").

Das Format des erforderlichen MID-ServerURL 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 von MID-ServerDie Skripteinbindung wird erstellt, indem ein Suffix an den Standard angehängt wird `Transformationsereignisse_ `Präfix. Informationen zur Sammlung von JSON v2-Ereignisnachrichten finden Sie unter [Konfigurieren des MID-WebService-Ereignissammlerkontexts](https://servicenow-prod.fluidtopics.net/GouDKBmVnYSexjkq2OnZNw "Konfigurieren Sie den Kontext des MID-Webservice-Ereignissammlers, um eine URL-Methode zum Verschieben von Ereignisnachrichten aus einer externen Quelle an bereitzustellen MID-Server.").  
Hinweis:  
Die URL im Format `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/MID/em/{transform_script_Name} `Wird auch unterstützt.

## Prozedur

1. Konfigurieren Sie den MID-Webservice-Ereignissammler, siehe [Konfigurieren des MID-WebService-Ereignissammlerkontexts](https://servicenow-prod.fluidtopics.net/GouDKBmVnYSexjkq2OnZNw "Konfigurieren Sie den Kontext des MID-Webservice-Ereignissammlers, um eine URL-Methode zum Verschieben von Ereignisnachrichten aus einer externen Quelle an bereitzustellen MID-Server.").
2. Starten Sie den MID-WebService-Ereignissammler.
{#event-collection-custom-payloads__steps_w5d_clp_ky}

## Beispiel

Transformation von XML-formatierten Ereignisnachrichten mithilfe der anwenderdefinierten Nutzlast-URL

Angenommen, dass XML-formatierte Ereignisnachrichten an gesendet werden MID-Server. Verwenden Sie dieses Beispiel, um ein Array von Ereignisobjekten aus den gesammelten Ereignisnachrichten zurückzugeben. Der Name von MID-ServerDie Skripteinbindung wird erstellt, indem ein Suffix an den Standard angehängt wird `Transformationsereignisse_ `Präfix. Für die Zwecke dieses Beispiels hat der Anwender die xmlSample-Skripteinbindung angegeben. Unter Verwendung dieser Details der Name von MID-ServerSkripteinbindung ist `TransformEvents_xmlSample `. Die MID-ServerTransformiert die gesammelten Ereignisnachrichten, indem die Nachrichten mithilfe der Skripteinbindung analysiert und dann an die Instanz übertragen werden.
{#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 Ereignisnachrichten 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**   

* [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.")
* [Konfigurieren des MID-WebService-Ereignissammlerkontexts](https://servicenow-prod.fluidtopics.net/GouDKBmVnYSexjkq2OnZNw "Konfigurieren Sie den Kontext des MID-Webservice-Ereignissammlers, um eine URL-Methode zum Verschieben von Ereignisnachrichten aus einer externen Quelle an bereitzustellen MID-Server.")