Event-Erfassung aus benutzerdefinierten Nutzlasten

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

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-Webservererweiterung konfigurieren.

Das Format der erforderlichen MID-Server-URL ist: http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event?Transform={Transform_script_name}. 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.

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.
2. Starten Sie den MID-WebService-Eventsammler.

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.

Tabelle : 1. Daten für das XML-Beispiel

Feld	Wert
MID_Server_IP	10.218.64.27
MID_Web_Server_Extension_Port	8097
transform_script_suffix_name	xmlSample

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-Webservererweiterung konfigurieren
• MID-WebService-Event-Sammlerkontext konfigurieren