---
sourceDocument: Gestion des opérations IT Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/it-operations-management

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Gestion des opérations IT Xanadu

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Transmission d'événements à l'instance à l'aide de l'API de service Web

# Transmission d'événements à l'instance à l'aide de l'API de service Web {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture

Vous pouvez utiliser une interface de service Web, prise en charge par ServiceNow, qui fonctionne sur l'objet JSON comme format d'entrée et de sortie de données.

## Avant de commencer

Rôle requis : evt_mgmt_integration

## Pourquoi et quand exécuter cette tâche

Pour insérer des enregistrements dans la table d'événements \[em_event\] avec un seul appel, utilisez cette API de service Web :

`https://<nominstance>.service-now.com/api/global/em/jsonv2`  
Remarque :  
les règles métier de la table d'événements ne sont pas invoquées lors de l'utilisation de cette URL.

N'ajoutez pas de champs supplémentaires à un événement en ajoutant un champ personnalisé à la table d'événements \[em_event\]. Toutefois, des champs supplémentaires doivent être inclus dans le champ Informations supplémentaires \[additional_info\] de l'événement. Pour en savoir plus sur la façon d'inclure des champs supplémentaires dans les événements, consultez la rubrique [Personnaliser les champs d'alertes](https://servicenow-prod.fluidtopics.net/yPhTMA0cSVfpSACUKULkzw "Vous pouvez renseigner les champs d'alertes personnalisés avec les données contenues dans le champ Informations supplémentaires de l'événement.").

L'URL au format : `http://<instancename>.service-now.com/em_event.do?JSONv2&sysparm_action=insertMultiple` est également prise en charge si vous souhaitez activer les règles métier. La première URL offre cependant des performances supérieures.  
Pour utiliser l'URL qui se termine par `=insertMultiple`, ajoutez les propriétés suivantes, avec leurs valeurs respectives, au MID Server :

* "mid.probe.event.queue.compress" - valeur : faux
* "mid.probe.event.bulk_size" - valeur : 100
* "mid.probe.event.endpoint.url" - valeur : em_event.do?JSONv2%26sysparm_action=insertMultiple
{#send-events-via-web-service__ul_trh_npb_rbb}

## Procédure

1. Envoyez la demande avec les en-têtes suivants :  
   {#send-events-via-web-service__table_mwb_yfk_lx__entry__3}

   | Paramètre | Type | Description |
   |-|-|-|
   | Accepter | Chaîne | Type acceptable pour ce message. La valeur par défaut est <kbd class="ph userinput">application/json</kbd>. |
   | Content-Type | Chaîne | Type de contenu pour ce message. La valeur par défaut est <kbd class="ph userinput">application/json</kbd>. |
   | POST | Chaîne | La demande est de type POST, avec un ou plusieurs enregistrements de fin. |
   [ ]

   {#send-events-via-web-service__table_mwb_yfk_lx}
2. Il est possible d'envoyer un ou plusieurs événements au format JSON comme charge utile de l'appel de service Web.  
   Les champs d'événement qui doivent être renseignés sont les suivants :{#send-events-via-web-service__table_eqx_mgk_lx__entry__2}

   | Variable | Description |
   |-|-|
   | Source | Nom du type de source d'événement. Par exemple, SCOM ou SolarWinds. |
   | Instance source (event_class) | Instance spécifique du source. Par exemple, <kbd class="ph userinput">SCOM 2012 sur 10.20.30.40</kbd> |
   | nœud | Le champ node doit contenir un identificateur pour l'hôte (serveur/commutateur/routeur/etc.) pour lequel l'événement a été déclenché. La valeur du champ node peut être l'un des identificateurs suivants de l'hôte : * Nom * Nom de domaine complet * Adresse IP * Adresse MAC {#send-events-via-web-service__ul_c1n_jhk_lx}Si elle existe dans la CMDB, cette valeur est également utilisée pour lier l'événement au CI ServiceNow correspondant. |
   | resource | Si l'événement fait référence à un appareil, notamment un lecteur, un processeur ou une carte réseau, ou à une application ou à un service en cours d'exécution sur un hôte, le nom de l'appareil ou de l'application doit être renseigné dans ce champ. Par exemple, <kbd class="ph userinput">Lecteur&nbsp;C:\</kbd> ou <kbd class="ph userinput">Carte réseau 001</kbd> ou <kbd class="ph userinput">Application Web Trade</kbd>. |
   | em_event.metric_name | Nom de la mesure ayant déclenché l'alerte. Par exemple, <kbd class="ph userinput">mémoire utilisée</kbd> ou <kbd class="ph userinput">utilisation totale du processeur</kbd>. |
   | type | Type d'événement. Ce type peut être similaire au champ metric_name, mais est utilisé pour le regroupement général des types d'événements. |
   | message_key | Cette valeur est utilisée pour la déduplication des événements. Par exemple, il peut exister deux événements pour le même CI, où un événement possède un processeur à 50 % et l'événement suivant possède un processeur à 99 %. Lorsque les deux événements doivent être mappés sur la même alerte ServiceNow, ils doivent disposer de la même clé de message. Vous pouvez laisser ce champ vide, auquel cas la valeur par défaut du champ est <kbd class="ph userinput">source+node+type+resource+metric_name</kbd>. Le champ message_key ne doit être renseigné que lorsqu'il existe un meilleur identificateur que la valeur par défaut. |
   | severity | Gravité de l'événement. Valeurs ServiceNow pour la plage de gravité comprise entre 1 -- Critique et 5 -- OK, avec une gravité de 0 -- Effacer. Les valeurs de gravité d'origine doivent être envoyées dans le cadre d'informations supplémentaires. |
   | additional_info | Ce champ au format clé/valeur JSON est destiné à contenir toutes les informations susceptibles d'être utilisées par l'utilisateur. Il ne correspond pas à un champ d'événement ServiceNow prédéfini. Par exemple, les ID d'objets dans la source d'événement, la priorité de l'événement (si elle n'est pas identique à la gravité), les informations sur le groupe d'affectation, etc. Les valeurs du champ Informations supplémentaires d'un événement qui ne sont pas au format clé/valeur JSON sont normalisées au format clé/valeur JSON lorsque l'événement est traité. |
   | time_of_event | Heure à laquelle l'événement s'est produit sur l'origine de l'événement. Le format est le suivant : aaaa-MM-jj HH:mm:ss L'heure spécifiée doit être conforme au format GMT. |
   | resolution_state | Facultatif : pour indiquer qu'un événement a été résolu ou n'a plus lieu, certains moniteurs d'événements utilisent la gravité \<\< effacer \>\>, tandis que d'autres une valeur \<\< fermer \>\>. Ce champ est utilisé pour les moniteurs qui utilisent cette dernière valeur. Les valeurs valides sont <kbd class="ph userinput">Nouveau</kbd> et <kbd class="ph userinput">Fermeture</kbd>. |
   [ ]

   {#send-events-via-web-service__table_eqx_mgk_lx}
3. Pour créer plusieurs enregistrements avec un seul appel, déclenchez le service Web d'événement à l'aide de l'URL suivante, où la variable \<nominstance\> est remplacée par le nom de l'instance requise :  
   `https://<nominstance>.service-now.com/api/global/em/jsonv2`  
   Exemple montrant la charge utile pour deux événements envoyés dans un seul appel de service Web :

       { "records":	
        [
         {
          "source":"SCOM",
          "event_class":"SCOM 2012 on scom.server.com",
          "resource":"D:",
          "node":"name.of.node.com",
          "metric_name":"Percentage Logical Disk Free Space",
          "type":"Disk space",
          "severity":"4",
          "description":"The disk D: on computer V-W2K8-abc.abc.com is running out of disk space. The value that exceeded the threshold is 38% free space.",
          "additional_info": '{"scom-severity":"Medium","metric-value":"38","os_type":"Windows.Server.2008"}'
          },
         {
          "source":"SCOM",
          "event_class":"SCOM 2012 on scom.server.com",
          "resource":"MSSQL-database-name",
          "node":"other.node.com",
          "metric_name":"DB Allocated Size (MB)",
          "type":"Database Storage",
          "severity":"3",
          "description":"High number of active connections for MSSQL-database-name running on name.of.node.com. Active connections exceed 5000.",
          "additional_info": '{"scom-severity":"Medium","metric-value":"38","os_type":"Windows.Server.2008"}'
         }
        ]
       }

4. Pour créer un enregistrement avec un seul appel, déclenchez le service Web d'événement à l'aide de l'URL suivante, où la variable \<nominstance\> est remplacée par le nom de l'instance requise :  
   `http://<nominstance>.service-now.com/api/global/em/jsonv2`  
   Exemple montrant la charge utile d'un événement envoyé dans un seul appel de service Web :

       { "records":	
        [
         {
          "source":"SCOM",
          "event_class":"SCOM 2007 on scom.server.com",
          "resource":"C:",
          "node":"name.of.node.com",
          "metric_name":"Percentage Logical Disk Free Space",
          "type":"Disk space",
          "severity":"4",
          "description":"The disk C: on computer V-W2K8-dfg.dfg.com is running out of disk space. The value that exceeded the threshold is 41% free space.",
          "additional_info": '{"scom-severity":"Medium","metric-value":"38","os_type":"Windows.Server.2008"}'
         }     
        ]
       }

{#send-events-via-web-service__steps_ebq_23d_zq}
**Concepts associés**   

* [Transmission d'événements à l'API de service Web à l'aide Serveur MID](https://servicenow-prod.fluidtopics.net/Ro9jzzumKIqDk2kx0AdeFA "Configurez le collecteur d'événements MID WebService pour fournir une méthode d'URL pour transmettre par push les messages d'événement au Serveur MID.")