Métriques
La page Metrics (barre latérale > Metrics) vous donne une vue analytique plus approfondie de votre utilisation de l'API. Elle montre votre distribution globale des résultats et répartit le trafic par clé d'API, IP client ou domaine cible.
Pour des cartes de résumé en temps réel et des graphiques chronologiques (Concurrency, Requests, Bytes, Response Time, Budget), utilisez la page Dashboard Overview.
Filtres
Deux contrôles se trouvent au-dessus de la page : un sélecteur de clé d'API et un sélecteur d'intervalle.
Filtre de Clé
Utilisez la liste déroulante API Key pour restreindre la page à une clé spécifique. Seules les clés de votre périmètre d'accès apparaissent : les clés personnelles, les clés d'organisation que vous administrez ou les clés partagées par des équipes.
Sélecteur d'Intervalle
Utilisez les boutons d'intervalle pour contrôler la fenêtre de temps :
| Bouton | Fenêtre |
|---|---|
| 1M | La dernière minute |
| 5M | Les 5 dernières minutes |
| 30M | Les 30 dernières minutes |
| 1H | La dernière heure |
| 6H | Les 6 dernières heures |
| 1D | Les dernières 24 heures |
Le graphique en anneau et le tableau suivent ce que vous choisissez.
Distribution des Résultats
Un graphique en anneau en haut montre la répartition succès/erreur pour l'intervalle sélectionné. Survolez n'importe quelle tranche pour voir le nombre exact de requêtes et le pourcentage. Utilisez-le pour repérer rapidement si une baisse soudaine du taux de réussite correspond à une catégorie de résultat spécifique.
Types de Résultats
Chaque requête API est classée dans un seul résultat. Seul success compte pour votre quota facturable.
| Résultat | Couche | Signification |
|---|---|---|
success |
n/a | La requête a fourni une réponse valide. Sans règles validate, cela signifie HTTP 200. Si vous avez envoyé des règles validate, toute réponse acceptée par vos règles compte comme un succès, quel que soit le statut HTTP. |
application_error |
cible | La cible a retourné HTTP 200, mais le corps de la réponse contenait un champ d'erreur. |
application_fail |
cible | La cible a retourné un statut non-2xx que vos règles validate n'ont pas accepté, ou aucune réponse du tout. |
client_error |
appelant | Votre requête a été rejetée avant de quitter FourA : mauvais paramètres, valeur proxy malformée, ou une URL qui se résout en une IP privée/réservée (protection SSRF). |
rate_limit |
FourA | La requête a été rejetée par votre RPM ou limite de concurrence. Voir Rate Limits. |
service_error |
FourA | Le backend a retourné 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 couche vous indique qui est responsable : target signifie le site que vous avez appelé, caller signifie que votre requête était mauvaise, 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 réponses reviennent comme success au lieu de application_fail. La classification suit le verdict du moteur sur vos règles, pas le code HTTP brut.
Pour la taxonomie complète et comment elle correspond à la facturation, voir Request Outcomes.
Tableau d'Utilisation Multi-Vues
Sous le graphique en anneau, un tableau d'utilisation détaille votre trafic avec trois onglets d'affichage :
| Onglet | Regroupe les données par |
|---|---|
| API Key | Chacune de vos clés API |
| Client IP | Adresses IP sources effectuant des requests |
| Domaine | Domaines cibles dans vos requests |
Chaque onglet prend en charge des puces de portée à droite qui modifient les colonnes affichées :
| Portée | Ce qu'elle affiche |
|---|---|
| Bande passante | Nombre de requests, octets entrants, octets sortants |
| Temps de réponse | Nombre de requests, latence minimale, moyenne et maximale |
| Concurrence | Nombre de requests plus le nombre de requests simultanées (vue API Key uniquement) |
| Résultats | Nombre de requests plus une répartition par résultat |
| Budget | Nombre de requests et crédits dépensés, répartis par produit (Single, Proxy, Browser) |
La portée Budget lit la métrique credits écrite par l'API à chaque request (voir Response Headers). Les sommes correspondent aux dépenses brutes mesurées, la facturation ne comptabilise que le résultat success sur votre forfait.
Cliquez sur un en-tête de colonne pour trier par cette colonne. L'état du tri persiste par tableau à travers les chargements de page. Appuyez sur Ctrl ou Cmd en cliquant sur un en-tête pour réinitialiser.
Articles connexes
- Dashboard Overview: Statistiques en temps réel et graphiques chronologiques
- Request Outcomes: Les sept valeurs de résultat expliquées en détail
- Response Headers: D'où proviennent les crédits
- API Errors: Comment les erreurs reviennent sur le réseau