--- sourceDocument: Référence de l’API Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Référence de l’API Xanadu ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # API de mesures push # API de mesures push {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture L'API Push Metrics fournit des points de terminaison qui vous permettent d'envoyer des données brutes Intelligence opérationnelle d'une source externe au Serveur MID. Cette API est basée sur des outils côté client qui envoient les données brutes de la source externe vers le Serveur MIDfichier . L'extension Mesures opérationnelles doit être configurée avec l'option Activer l'écouteur REST activée. Pour plus d'informations sur la configuration de , Serveur MIDreportez-vous [à la rubrique Prise en main d'Intelligence opérationnelle.](https://www.servicenow.com/docs/access?context=get-started-metrics&version=xanadu&pubname=xanadu-it-operations-management&ft:locale=en-US) Pour plus d'informations sur les exigences [d'authentification, voir Configurer l'extension du serveur Web MID](https://www.servicenow.com/docs/access?context=configure-mid-web-server-extension&version=xanadu&pubname=xanadu-it-operations-management&ft:locale=en-US). ## Mesures push : POST /mid/sa/metrics {#ariaid-title2} Envoie les données brutes Intelligence opérationnelle d'une source externe vers le Serveur MIDfichier . ### Format d'URL {#sa-POST-metrics__section_nbn_xsv_3mb} URL par défaut : /api/mid/sa/metrics ### Paramètres de demande pris en charge {#sa-POST-metrics__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 1. Paramètres de chemin d'accès] {#sa-POST-metrics__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 2. Paramètres de requête] {#sa-POST-metrics__entry__10} | Nom | Description | |-|-| | ci2metric_id | Liste des paires clé-valeur à utiliser pour identifier l'élément de configuration (CI). Il est anciennement connu sous le nom de ci_identifier. Le script continue d'accepter ci_identifier. Type de données : objet | | metric_type | Nom de la mesure. Type de données : chaîne | | nœud | Adresse IP, FQDN, nom du CI ou hôte. Dans l'exemple ci-dessous, le nom du serveur Linux sur lequel les disques sont installés. Type de données : chaîne | | resource_path | Chemin d'accès de la ressource pour laquelle les données de mesure sont collectées. Dans l'exemple ci-dessous, `C :\` est la ressource pour laquelle les données de mesure sont collectées. Type de données : chaîne | | source | Source de données surveillant le type de mesure. Type de données : chaîne | | horodatage | Horodatage Epoch de la mesure. Type de données : nombre Unité : Millisecondes | | valide | Valeur de la mesure. Type de données : nombre | [Tableau 3. Paramètres de corps de demande (XML ou JSON)] ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#sa-POST-metrics__entry__26}{#sa-POST-metrics__content_type-RESTAPI} | En-tête | Description | |-|-| | Content-Type | Format de données du corps de la demande. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json | [Tableau 4. En-têtes de demandes] {#sa-POST-metrics__entry__30} | En-tête | Description | |-|-| | Aucun | | [Tableau 5. En-têtes de réponses] ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#sa-POST-metrics__entry__34}{#sa-POST-metrics__entry-200-status-code}{#sa-POST-metrics__entry-401-status-code}{#sa-POST-metrics__entry-500-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. | | 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. | [Tableau 6. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#sa-POST-metrics__entry__42} | Nom | Description | |-|-| | Aucun | | [ ] ### Demande cURL Le corps de la demande doit être entouré de crochets, comme illustré dans cet exemple. curl -X POST "https://servicenow-instance/api/mid/sa/metrics" -H "Content-Type: application/json" -U "username":"password" -d "[{ "metric_type": "Disk C: % Free Space", "resource_path": "C:\\", "node": "lnux100", "value": 50, "timestamp": 1473183012000, "ci2metric_id": { "node": "lnux100" }, "source": "Splunk" }]"