Configurer le contexte du module de collection d’événements MID WebService
Configurez le contexte du module de collection d’événements MID WebService pour fournir une méthode d’URL permettant d’envoyer par push les messages d’événements d’une source externe vers le Serveur MID.
Avant de commencer
Assurez-vous que le module d’extension Gestion des événements Connecteurs (sn_em_connector) est installé sur l’instance ServiceNow AI Platform .
Rôle requis : evt_mgmt_admin
Pourquoi et quand exécuter cette tâche
http://{MID_Server_IP} :{MID_Web_Server_Port}/api/mid/em/jsonv2. Cette URL offre de bonnes performances. Depuis une source externe, pour transmettre par push des messages d’événement qui ne sont pas au format jsonv2, le format de l’URL est : http://{MID_Server_IP} :{MID_Web_Server_Port}/api/mid/em/inbound_event ? Transform={Name_of_Transform_Script}, où la variable {Name_of_Transform_Script} est le nom complet du script et commence toujours par le texte : TransformEvents_.
- {MID_Server_IP} : 10.118.69.27
- {MID_Web_Server_Port} : 8097
- Nom du script de transformation : EventsToProcess
http://10.118.69.27:8097/api/mid/em/inbound_event/TransformEvents_EventsToProcess - L’URL au format
http://{MID_Server_IP} :{MID_Web_Server_Port}/api/mid/em/{transform_script_name}est également prise en charge. - Le format de date pour les événements est aaaa-M-j h :mm :ss.
Si vous recevez un événement dont la date est dans un format différent, vous devez utiliser un
{transform_script_name}adapté au format de date de l’événement à venir. Dans le cas contraire, l’événement n’est pas traité correctement.Par exemple, si un événement se produit le 27 juin 2019 à 11 h 25 avec une date répertoriée de 2019/06/27/ 11:25:00 a, utilisez un
{transform_script_name}avec un format de date de yyyy/MM/dd/ HH:mm:ss a pour correspondre au format de l’événement reçu.
Procédure
Exemple
Montrant l’utilisation de l’URL pour transformer les messages d’événements au format JSON v2
Supposons que les messages d’événements au format JSON v2 soient envoyés au .Serveur MID Lors de l’utilisation de l’URL jsonv2 , il n’est pas nécessaire d’utiliser un include de script.
| Champ | Valeur |
|---|---|
| MID_Server_IP | 10.218.64.27 |
| MID_Web_Server_Extension_Port | 8097 |
| Format du message d’événement | jsonv2 |
Remplacez les variables au format par défaut de l’URL http://<my-instance>.service-now.com/api/global/em/jsonv2par les valeurs de la table précédente :http://10.218.64.27:8097/api/global/em/jsonv2
Exemple d’affichage de l’URL pour transmettre des messages push hors du format jsonv2
Le format de l’URL pour transmettre par push les messages d’événement à partir d’une source externe qui ne sont pas au format jsonv2 est http://{MID_Server_IP} :{MID_Web_Server_Port}/api/mid/em/inbound_event/Transform={Name_of_Transform_Script} où la variable {Name_of_Transform_Script} est le nom complet du script et commence toujours par le texte suivant : TransformEvents_. Le nom du script doit être spécifié comme paramètre d’en-tête de transformation et doit toujours commencer par le préfixe TransformEvents_.
Pour cet exemple, supposons que le nom du script soit EventsToProcess, l’URL est donc :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
Exemple
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%\"
}
]
}'