API de mesures push

L’API de mesures push fournit des points de terminaison qui vous permettent d’envoyer des données brutes Analyse des mesures d’une source externe vers le Serveur MID.

Cette API est basée sur des outils côté client qui poussent les données brutes de la source externe vers le Serveur MID. L’extension Analyse des mesures doit être configurée avec l’option Activer l’écouteur REST activée. Pour plus d’informations sur la configuration de , voir Mise en route de l’analyseServeur MID des mesures.

Pour en savoir plus sur les exigences en matière d’authentification, consultez Configurer l’extension Serveur MID Web.

Mesures push : POST /mid/sa/metrics

Envoie les données brutes Analyse des mesures d’une source externe vers le Serveur MID fichier .

Format d'URL

URL par défaut : /api/mid/sa/metrics

Paramètres de demande pris en charge

Tableau 1. Paramètres de chemin d'accès

Nom	Description
Aucun

Tableau 2. Paramètres de requête

Nom	Description
Aucun

Tableau 3. Paramètres de corps de demande (XML ou JSON)

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
unit	Type d’unité associé à la source du type de mesure. Table : Types de mesures du système de surveillance [sa_source_metric_type] Type de données : chaîne
valide	Valeur de la mesure. Type de données : nombre

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.

Tableau 4. En-têtes de demandes

En-tête	Description
Type de contenu	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 5. En-têtes de réponses

En-tête	Description
Aucun

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.

Tableau 6. Codes d'état

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.

Paramètres du corps de la réponse (JSON ou XML)

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"
}]"