Audit d’API

Important :

Cette fonctionnalité est actuellement disponible en aperçu.

Cette fonctionnalité permet d’afficher le nombre d’appels effectués vers les points de terminaison GetAll - Jobs et QueueItems au cours des 30 derniers jours, et vous pouvez explorer un jour en particulier.

The graphs display a green bar if our 100 requests/minute/tenant rate limit is observed, and an orange bar if it is exceeded.

Each graph includes a View API button which directs you to the corresponding Swagger endpoint.

This requires the Audit - View permission.

Important :

• Le décompte commence après les 10 premiers appels d’API.
• Les données s’affichent après un délai maximal de 20 minutes.
• Certains appels internes peuvent être inclus dans les graphiques, mais ils ne sont pas soumis à la limite de débit. Si pouvez constatez que certains appels internes dépassent la limite, leur code de statut sera cependant signalé comme réussi.
• Les heures des graphiques sont exprimées au système horaire UTC.

Détails du pic

You can view spike details for each minute logged in the API audit panel.

Pour cela, sélectionnez le pic correspondant à la minute souhaitée. Un panneau latéral va s’ouvrir, lequel répertorie un maximum de 100 résultats avec le plus de demandes et comprend des informations telles que le processus, le dossier où réside le processus, le nom d’hôte, le nombre d’appels effectués vers ce point de terminaison au cours de la minute sélectionnée, le code de statut, ainsi que l’agent utilisateur.

Si l’appel d’API provient d’une source externe ou si nous ne disposons pas de suffisamment de détails concernant le processus, les colonnes correspondantes afficheront la mention N/A.

Voici les actions que vous pouvez effectuer dans le panneau latéral des détails du pic sélectionné :

• Cliquez sur le bouton Développer en haut à droite afin d’ouvrir le panneau dans une fenêtre en mode plein format.
• Cliquez sur l’icône en forme d’œil à côté du processus concerné afin d’afficher les détails de la tâche associée.
  Remarque :

  This option is not available if you do not have view permissions for the folder where the process is configured.

Important :

Le décompte des demandes commence à partir du moment précis où une demande est effectuée, à la seconde près. Cependant, par souci de simplicité, nos graphiques affichent des incréments par minute et non par seconde.

Vous pouvez ainsi avoir le scénario suivant :

• Vous effectuez 50 requêtes entre 13:10:30 et 13:10:59:99.
• Vous effectuez ensuite 60 autres requêtes entre 13:11:00 et 13:11:30.

Les barres du graphique correspondant à chaque minute seront vertes, mais les 10 requêtes supplémentaires seront en fait en débit limité.

Exporter des données d’audit d’API

You can export the last 7 days' worth of API audit data using the Export report button, which features two options: QueueItems and Jobs. The resulting report is named for the option you choose.

The exported report is automatically downloaded in the background, to your browser's default download location. It is also available on the My reports page, allowing you to download it at your own convenience, within 7 days of when it was generated.

Remarque :

• Si vous ne disposez pas d’autorisations de dossier, l’élément correspondant dans le rapport est indiqué par la mention NO_ACCESS.
• Si l’appel d’API provient d’une source externe ou si nous ne disposons pas de suffisamment de détails concernant le processus, les colonnes correspondantes afficheront la mention N/A.