Collecte d’événements à partir de charges utiles personnalisées

Le collecteur d'événements MID WebService vous permet de collecter des informations d'événement à partir de charges utiles personnalisées au format JSON, au format XML ou en texte brut.

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

Cela Serveur MID transforme les messages d’événements collectés et remplit les champs de la table d’événements (em_table) dans l’instance. La collecte des messages d’événements formatés est décrite dans cette procédure à l’aide de l’authentification de base. Pour en savoir plus sur les méthodes d’authentification prises en charge, reportez-vous à la section Configurer l’extension Serveur Web MID.

Le format de l’URL requise Serveur MID est : http://{MID_Server_IP} :{MID_Web_Server_Port}/api/mid/em/inbound_event ? Transform={Transform_script_name}. Le nom de l’include Serveur MID de script est composé en ajoutant un suffixe au préfixe de TransformEvents_ par défaut. Pour en savoir plus sur la collecte des messages d’événements JSON v2, reportez-vous à la section Configurer le contexte du module de collection d’événements MID WebService.

Remarque :

L’URL au format http://{MID_Server_IP} :{MID_Web_Server_Port}/api/mid/em/{transform_script_name}est également prise en charge.

Procédure

1. Configurez le collecteur d’événements MID WebService, reportez-vous à la section Configurer le contexte du module de collection d’événements MID WebService.
2. Démarrez le collecteur d'événements MID WebService.

Exemple

Conversion des messages d'événements au format XML à l'aide de l'URL de charge utile personnalisée

Supposons que les messages d’événements Serveur MID au format XML soient envoyés au . Utilisez cet exemple pour renvoyer un tableau d’objets d’événements à partir des messages d’événements collectés. Le nom de l’include Serveur MID de script est composé en ajoutant un suffixe au préfixe de TransformEvents_ par défaut. Pour les besoins de cet exemple, l’utilisateur a fourni l’include de script xmlSample. À l’aide de ces détails, le nom de l’include Serveur MID de script est TransformEvents_xmlSample. Transforme Serveur MID les messages d’événements collectés en les analysant à l’aide de l’include de script, puis en les transmettant à l’instance.

Tableau 1. Données pour l'exemple XML

Champ	Valeur
MID_Server_IP	10.218.64.27
MID_Web_Server_Extension_Port	8097
transform_script_suffix _name	xmlSample

Remplacez les variables de l’URL par les valeurs de la table ci-dessus : http://10.218.64.27:8097/api/mid/em/xmlSample

Remarque :

Lorsque vous copiez-collez le texte ci-dessous, les caractères masqués peuvent également être copiés, ce qui peut entraîner des résultats inattendus.

Exemple d'affichage des messages d'événements au format XML :

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

Tâches associées

• Configurer l’extension Serveur Web MID
• Configurer le contexte du module de collection d’événements MID WebService