Métriques
La page Métriques (barre latérale > Métriques) vous offre une vue analytique plus approfondie de votre utilisation de l'API. Elle affiche la répartition globale de vos outcomes et segmente le trafic par clé API, IP client ou domaine cible.
Pour les cartes de résumé en temps réel et les graphiques chronologiques (concurrence, requests, octets, temps de réponse), utilisez la page Dashboard Overview.
Filtres
Deux contrôles sont situés au-dessus de la page : un sélecteur de clé API et un sélecteur d'intervalle.
Filtre par clé
Utilisez le menu déroulant Clé API pour limiter la page à une clé spécifique. Seules les clés situées dans votre périmètre d'accès apparaissent : clés personnelles, clés d'organisation que vous administrez ou clés partagées via des équipes.
Sélecteur d'intervalle
Utilisez les boutons d'intervalle pour contrôler la fenêtre temporelle :
| Bouton | Fenêtre |
|---|---|
| 1M | Dernière minute |
| 5M | Dernières 5 minutes |
| 30M | Dernières 30 minutes |
| 1H | Dernière heure |
| 6H | Dernières 6 heures |
| 1D | Dernières 24 heures |
Le graphique en anneau et le tableau s'adaptent tous deux à votre sélection.
Répartition des outcomes
Un graphique en anneau en haut affiche la répartition succès/erreur pour l'intervalle sélectionné. Survolez n'importe quelle section pour voir le nombre exact de requests et le pourcentage. Utilisez-le pour identifier rapidement si une baisse soudaine du taux de réussite correspond à une catégorie d'outcome spécifique.
Types d'outcomes
Chaque request API est classée dans un seul et unique outcome. Seul success est décompté de votre quota facturable.
| Outcome | Layer | Signification |
|---|---|---|
success |
n/a | La request a renvoyé une response valide. Sans règles validate, cela correspond à un HTTP 200. Si vous avez envoyé des règles validate, toute response acceptée par vos règles est considérée comme un succès, quel que soit le statut HTTP. |
application_error |
target | La cible a renvoyé un HTTP 200, mais le corps de la response contenait un champ d'erreur. |
application_fail |
target | La cible a renvoyé un statut non-2xx que vos règles validate n'ont pas accepté, ou n'a renvoyé aucune response. |
client_error |
caller | Votre request a été rejetée avant de quitter FourA : paramètres incorrects, valeur de proxy malformée, ou une URL résolvant vers une IP privée/réservée (protection SSRF). |
rate_limit |
FourA | La request a été rejetée par votre limite de RPM ou de concurrence. Voir Rate Limits. |
service_error |
FourA | Le backend a renvoyé un 5xx, ou a répondu avec un corps que nous n'avons pas pu analyser. |
service_fail |
FourA | Un échec réseau : timeout, connexion refusée, erreur DNS, client déconnecté. |
La colonne layer vous indique qui est responsable : target signifie le site que vous avez appelé, caller signifie que votre request était incorrecte, FourA signifie que nous n'avons pas pu la traiter.
Si vous utilisez validate.status.accept pour autoriser des codes non-200 spécifiques (par exemple [200, 403]), ces responses renvoient success au lieu de application_fail. La classification suit le verdict du moteur sur vos règles, et non le code HTTP brut.
Pour la taxonomie complète et son impact sur la facturation, voir Request Outcomes.
Tableau d'usage multi-vues
Sous le graphique en anneau, un tableau d'usage détaille votre trafic avec trois onglets de vue :
| Onglet | Groupe les données par |
|---|---|
| API Key | Chacune de vos clés API |
| Client IP | Adresses IP sources émettant des requests |
| Domain | Domaines cibles dans vos requests |
Chaque onglet prend en charge quatre filtres de portée (chips) sur la droite qui modifient les colonnes affichées :
| Portée | Ce qu'elle affiche |
|---|---|
| Bandwidth | Nombre de requests, octets entrants, octets sortants |
| Response Time | Nombre de requests, latence minimale, moyenne et maximale |
| Concurrency | Nombre de requests plus le nombre de requests simultanées (vue API Key uniquement) |
| Outcomes | Nombre de requests plus une répartition par outcome |
Voir aussi
- Dashboard Overview : Statistiques en temps réel et graphiques chronologiques
- Request Outcomes : Les sept valeurs d'outcome expliquées en détail
- API Errors : Comment les erreurs sont renvoyées sur le réseau