Collecte et nettoyage des analyses REST et SOAP API

API Analytics utilise des tâches planifiées pour collecter et nettoyer les données d’analyse.

L’instance suit toutes les transactions de service Web pour les API figurant sur la liste d’inclusion et gère un historique quotidien, agrégé par ressource et par combinaison d’action HTTP. Les informations sur le demandeur sont agrégées par demandeur, ressource et combinaison d’action HTTP et suivies jusqu’à la limite quotidienne définie par la propriété com.glide.api.stats.daily_ limit.

Consultez le tableau suivant pour déterminer quelles demandes sont journalisées.

Tableau 1. Demandes consignées

Nom d'API	Exemple de ressource	Code de réponse	Description	Connecté
now/table	/api/now/table/incident	N’importe lequel sauf 401	Table et ressource valides	Oui
now/table	/api/now/table/invalidResource	400	Ressource valide, mais table non valide	Oui
now/table	/api/now/table/incident	403	L’utilisateur demandeur ne dispose pas de privilèges suffisants	Oui
now/table	/api/now/table/incident	401	L’utilisateur demandeur n’est pas authentifié	Non
myApp/myScriptedApi	myApp/myScriptedApi/myResource	N’importe lequel sauf 401	Ressource valide	Oui
myApp/invalidApiName	myApp/invalidApiName myApp/invalidApiName/myResource	400	API non valide, même avec une entrée de liste d’inclusion correspondante	Non

Le 2 de chaque mois, la tâche planifiée API Monthly Stats calcule le total mensuel pour chaque combinaison de ressource et d’action HTTP. Chaque jour, la tâche planifiée API Monthly Requestor Stats calcule le total mensuel pour chaque combinaison de ressource, de demandeur et d’action HTTP sur la base des scores quotidiens de plus de 2 jours.

Les statistiques quotidiennes sont conservées pendant 33 jours. Les totaux mensuels sont conservés pendant 13 mois. Les nettoyeurs de table pour les tables sys_api_stats, sys_api_stats_requestor et sys_api_stats_requestor_monthly suppriment les enregistrements d’analyse antérieurs à ces limites.

Dénomination des analyses d’API REST et SOAP

Le nom de l’API utilisé lors du suivi de l’analyse de l’API est déterminé par le type d’API décrit, tel qu’une API REST ou un service SOAP scripté.

Type d'API	Description
REST	L’espace de noms de l’API et la première partie de l’URI suivant l’espace de noms sont utilisés comme nom d’API. Par exemple, pour les points de terminaison de l’API de table api/now/table/incident et api/now/table/problem, l’espace de noms et l’ID sont now/table.
SOAP direct (la table n’étend pas la table Ligne du jeu d’importation)	Si la demande SOAP directe accède à une table, SOAP direct est utilisé comme nom d’API.
Importation SOAP (la table étend la table Ligne du jeu d’importation)	Import Set SOAP est utilisé comme nom d’API.
Services SOAP scriptés	La page de point de terminaison de demande SOAP est utilisée comme nom d’API, par exemple my_service.do.