Konfigurieren Sie den Kontext des MID-Webservice-Ereignissammlers
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 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
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 {Name_of_Transform_Script} Variable ist der vollständige Name des Skripts und beginnt immer mit dem Text: Transformationsereignisse_ .
- {MID_Server_IP}: 10.118.69.27
- {MID_Web_Server_Port}: 8097
- Name des Transformationsskripts: Ereignis-ToProcess
http://10.118.69.27:8097/api/mid/em/inbound_event/TransformEvents_EventsToProcess - 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.
Prozedur
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.
| Feld | Wert |
|---|---|
| MID_Server_IP | 10.218.64.27 |
| MID_Web_Server_Extension_Port | 8097 |
| Ereignisnachrichtenformat | jsonv2 |
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 Transformieren Header-Parameter und müssen immer mit dem Präfix beginnen Transformationsereignisse_ .
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
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
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%\"
}
]
}'