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.

Les graphiques affichent une barre verte lorsque notre limite de débit de 100 demandes/minute/locataire est respectée, et une barre orange lorsque celle-ci est dépassée.

Chaque graphique comprend un bouton Afficher l’API qui vous redirige vers le point de terminaison Swagger correspondant.

Vous devez pour cela disposer de l’autorisation Audit - Consultation.

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

Vous pouvez afficher les détails des pics pour chaque minute enregistrée dans le panneau Audit d’API.

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 : cette option n’est pas disponible si vous ne disposez pas des autorisations de consultation pour le dossier dans lequel le processus a été configuré.

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

Vous pouvez exporter les données d’audit d’API des 7 derniers jours à l’aide du bouton Exporter le rapport, qui présente deux options : ÉlémentsFileAttente et Tâches. Le rapport obtenu est nommé pour l’option que vous choisissez.

Le rapport exporté est automatiquement téléchargé en arrière-plan vers l’emplacement de téléchargement par défaut de votre navigateur. Il est également disponible sur la page Mes rapports, ce qui vous permet de le télécharger à votre guise dans les 7 jours suivant sa génération.

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.