# Métriques

> URL: https://foura.ai/fr/docs/dashboard/metrics
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

La page Métriques (barre latérale > Métriques) vous offre une vue analytique plus approfondie de votre utilisation. Elle contient un panneau, Utilisation, qui divise votre trafic en groupes et affiche les totaux pour l'ensemble de la période au-dessus d'une page de lignes.

Pour les cartes de résumé et les graphiques chronologiques, utilisez la page [Vue d'ensemble du tableau de bord](https://foura.ai/docs/dashboard/overview).

## Produit

La page s'ouvre sur un sélecteur **Produit** : **API** pour les requêtes que vous envoyez aux endpoints API, **Proxy** pour les tunnels que vos propres outils ouvrent via `proxy.foura.ai`. Chaque produit possède son propre panneau Utilisation avec ses propres vues, portées et colonnes, car un tunnel ne possède aucun décompte de requêtes et aucun crédit. Le choix est mémorisé et accessible par lien direct via `#metrics/proxy`.

## Filtres

Au-dessus du panneau : Produit, Endpoints (API uniquement), Propriétaire, puis Clé (API) ou Utilisateur proxy (Proxy), puis Période. Propriétaire et Période sont les mêmes contrôles que sur la Vue d'ensemble et partagent leur état, de sorte que le passage d'une page à l'autre ne modifie jamais ce que vous consultez.

### Filtre Propriétaire

**Tout**, **Personnel** ou l'une de vos organisations. Il n'apparaît que lorsque vous appartenez à au moins une organisation. La sélection d'un propriétaire reconstruit également les menus déroulants Clé et Utilisateur proxy, évitant ainsi qu'un identifiant du propriétaire précédent ne persiste après le changement et ne renvoie silencieusement aucun résultat.

Lorsque le propriétaire sélectionné n'a aucune clé API, y compris les clés arrêtées, la ligne située sous la période indique **Vous n'avez pas encore de clés API ici. Créez-en une pour voir son utilisation.** Les panneaux affichent alors des zéros car il n'y a rien à compter. Consultez [Gestion des clés API](https://foura.ai/docs/dashboard/api-keys).

### Filtres Clé et Utilisateur proxy

Restreignez la page à un seul identifiant. Seuls les identifiants auxquels vous avez accès s'affichent : les vôtres, ainsi que ceux des organisations auxquelles vous appartenez.

### Période

Huit options, 30M, 3H, 12H, 24H, 7D, 30D, 90D et 1Y, plus **Personnalisé** pour un mois calendaire, les 6 derniers mois, tout l'historique ou une plage de dates exacte.

### Endpoints

Sur le produit API, choisissez Unique, Sélecteur de proxy, Navigateur ou Auto pour restreindre les cartes et le tableau à un seul endpoint. Un appel Auto est comptabilisé une fois, sous Auto. La portée Concurrence n'est pas disponible lorsqu'un endpoint est sélectionné.

## Le panneau Utilisation

Le panneau répond à deux questions à la fois. Les **cartes au-dessus du tableau** décrivent l'ensemble de la période : le nombre de groupes qu'elle contient et les totaux pour l'ensemble d'entre eux. **Le tableau ci-dessous** représente une page de ces groupes, triée selon la colonne que vous choisissez.

Les deux éléments ne concernent jamais des trafics différents : les cartes appliquent la même période et les mêmes filtres que les lignes. Le nombre de groupes est affiché en entier plutôt qu'arrondi, car un nombre exact répond à la question "combien de domaines avons-nous atteints ce mois-ci", contrairement à une valeur arrondie.

Modifier la vue, la portée ou la période réinitialise la liste à la première page. La page 4 des domaines ne correspond pas à la page 4 des adresses IP clientes.

Cliquez sur un en-tête de colonne pour trier. Dans les vues Domaine et Client IP du produit d'API, le tri s'applique à l'ensemble de la liste avant sa pagination, la première ligne correspond donc réellement à la valeur la plus élevée, et le tableau revient à la première page. La vue Clé d'API regroupe toutes les clés dans une seule liste et la trie sur place. Le tri revient à l'ordre par défaut du périmètre lorsque vous changez de vue ou de périmètre, ou rechargez la page : le plus de requêtes en premier, ou sous Routes le plus de tentatives de navigateur par Auto. Faites Ctrl ou Cmd clic sur un en-tête pour réinitialiser. L'en-tête de la première colonne contient également une zone de filtrage (**Filtrer les clés d'API...**, **Filtrer les adresses IP...** ou **Filtrer les domaines...**) qui restreint les lignes par nom. Dans les vues Client IP et Domaine, la recherche s'effectue uniquement sur la page active, un groupe situé sur une autre page n'apparaîtra donc pas. Échap l'efface.

## Utilisation, Produit d'API

Trois vues :

| Vue | Regroupe les données par |
|-----|----------------|
| Clé d'API | Chaque clé à laquelle vous avez accès |
| Client IP | Adresses sources émettant les requêtes |
| Domaine | Domaines cibles de vos requêtes |

Les sélecteurs de périmètre modifient les colonnes et les cartes :

| Périmètre | Ce qu'il affiche |
|-------|---------------|
| Bande passante | Nombre de requêtes, octets entrants, octets sortants et part premium de ces octets (trafic acheminé via une sortie premium, inclus dans les totaux plutôt qu'ajouté) |
| Temps de réponse | Nombre de requêtes, latence minimale, moyenne, maximale |
| Concurrence | Nombre de requêtes ainsi que le nombre de requêtes simultanées (vue Clé d'API uniquement) |
| Résultats | Nombre de requêtes ainsi qu'une ventilation par résultat, avec le graphique en anneau des résultats |
| Budget | Nombre de requêtes, crédits facturés et crédits dépensés. Pour afficher un endpoint spécifique, sélectionnez-le dans la ligne Endpoints |
| Routes | Nombre de requêtes, vos requêtes par route, ce que Auto a exécuté derrière ses appels, et l'étape ayant répondu à chaque appel Auto (voir ci-dessous) |

Le périmètre Budget sépare les crédits facturés des crédits dépensés. Les **Crédits facturés** comptabilisent uniquement les requêtes avec le résultat `success` : c'est ce que votre forfait couvre. Les **Crédits dépensés** correspondent aux crédits que l'API indique à chaque requête (voir [Response Headers](https://foura.ai/docs/api/response-headers)), requêtes échouées incluses, et ils ne sont jamais facturés.

Les cartes Budget affichent les **Crédits facturés** avec **sur N dépensés** en dessous, et **Par requête**, la moyenne des crédits facturés par requête. Le tableau comporte une colonne **Crédits facturés** et une colonne **Crédits dépensés**, et vous pouvez trier selon l'une ou l'autre.

### Périmètre Routes

Routes ventile les requêtes de chaque clé, adresse IP cliente ou domaine par route et montre ce que Auto a exécuté pour ses appels. Ses colonnes sont réparties en trois groupes, chacun surmonté d'une légende :

| Groupe | Colonnes | Ce qu'elles comptent |
|-------|---------|-----------------|
| Requests par route | Single, Proxy Finder, Browser, Auto | Vos requests, selon la route vers laquelle vous les avez envoyées. Ensemble, elles constituent Requests. Un appel Auto compte une fois, sous Auto. Sous chaque nombre: sa part de Requests. |
| Tentatives Auto | Single, Proxy Finder, Browser | Les requests exécutées par Auto sur chaque moteur derrière ses appels, tentatives échouées comprises. Sous chaque nombre: tentatives par appel Auto. |
| Auto traité par | Saved session, Plain request, Proxy Finder, Browser, Failed | L'étape qui a traité chaque appel Auto. Ensemble, elles constituent Auto. Sous chaque nombre: sa part d'Auto. |

Saved session correspond à une session qu'Auto possédait déjà pour l'hôte. Browser inclut les appels où un browser a d'abord ouvert la page et dont le rejeu de la session a permis la livraison. Failed inclut les appels refusés avant qu'Auto ne s'exécute.

Pour identifier où Auto utilise un vrai browser, consultez la colonne Browser sous **Tentatives Auto**. Un browser ouvre généralement une page une seule fois, puis Auto réutilise cette session avec des requests plus légères, de sorte que cette colonne est souvent bien supérieure à Browser sous **Auto traité par**. Routes s'ouvre trié selon cette colonne, ainsi les domaines qui ont le plus besoin d'un browser apparaissent en premier; les groupes sans tentative browser suivent, classés par nombre de requests.

Les cartes situées au-dessus du tableau affichent les tentatives Auto sur la période avec le ratio de tentatives par appel Auto, ainsi que chaque browser ouvert, directement ou par Auto.

Les tentatives Auto ne sont jamais comptabilisées dans Requests ni dans le taux de succès. Elles sont en revanche décomptées des limites de rate limit et de concurrence Single, Proxy Finder et Browser de votre forfait, comme indiqué sur la carte des tentatives Auto de la vue Overview. Lorsqu'un endpoint est sélectionné dans la ligne Endpoints, Routes affiche uniquement cette route: Browser liste alors les requests browser que vous avez envoyées vous-même, et celles exécutées par Auto restent sous Auto.

### Graphique en anneau des résultats

Sous la portée **Résultats**, un graphique en anneau apparaît dans le panneau et détaille la répartition des succès et des erreurs pour la période sélectionnée. Survolez chaque segment pour obtenir le nombre exact de requests et le pourcentage correspondant. Il s'affiche uniquement sous cette portée, car une vue globale de la fenêtre au-dessus d'un tableau répondant à une autre question créerait une confusion.

## Utilisation, produit Proxy

Cinq vues:

| Vue | Regroupe les données par |
|-----|----------------|
| Utilisateur proxy | Chaque utilisateur proxy auquel vous avez accès |
| Cible | L'hôte atteint par chaque tunnel |
| Pays de sortie | Le pays d'où le tunnel est parti |
| IP client | L'adresse d'où provient la connexion |
| Résultat | Le résultat et sa raison |

Quatre portées:

| Portée | Colonnes |
|-------|---------|
| Trafic | Tunnels, Bytes In, Bytes Out, Premium |
| Configuration | Tunnels, Setup Min, Setup Avg, Setup Max, Duration Avg, Duration Max |
| Résultats | Tunnels plus une colonne par résultat, avec le graphique en anneau des résultats |
| Budget | Tunnels, Standard, Premium, Total |

Setup est le temps d'attente avant la mise à disposition d'un tunnel. Duration est la durée pendant laquelle il est ensuite resté ouvert. Premium correspond à la part du trafic ayant transité par le réseau premium, comptabilisée dans le total et jamais ajoutée en supplément.

Aucun scope ne comporte de colonne de crédits ni de décompte de requêtes. Ce qui transite au sein d'un `CONNECT` correspond à votre propre trafic chiffré, donc le port compte les tunnels et les octets, rien d'autre.

## Types de résultats

Chaque requête API est classée selon un résultat unique. Seul `success` est facturé.

| Résultat | Couche | Signification |
|---------|-------|---------|
| `success` | n/a | La requête a renvoyé une réponse valide. Sans règles `validate`, cela correspond à un code HTTP 200. Avec des règles `validate`, toute réponse acceptée par vos règles, quel que soit le statut. Une page de vérification ou de refus reconnue par FourA n'est jamais un succès. |
| `application_error` | target | La cible a renvoyé un code HTTP 200, mais le corps contenait un champ d'erreur, ou le corps était une page de vérification ou de refus reconnue par FourA. |
| `application_fail` | target | La cible a renvoyé un code autre que 2xx non accepté par vos règles `validate`, ou aucune réponse du tout. |
| `client_error` | caller | Votre requête a été rejetée avant de quitter FourA : paramètres incorrects, valeur de proxy malformée ou URL résolue vers une adresse privée ou réservée. |
| `rate_limit` | FourA | La requête a été rejetée par votre limite de RPM ou de simultanéité. Consultez [Limites de débit](https://foura.ai/docs/api/rate-limits). |
| `service_error` | FourA | Le moteur a répondu par une erreur de serveur ou par un corps impossible à analyser. |
| `service_fail` | FourA | Une défaillance réseau : délai dépassé, connexion refusée, erreur DNS, déconnexion du client. |

La colonne de couche indique la partie responsable. `target` correspond au site appelé, `caller` signifie que votre requête était incorrecte, `FourA` signifie que nous n'avons pas pu la traiter.

Si vous utilisez `validate.status.accept` pour autoriser des codes autres que 200 spécifiques (par exemple `[200, 403]`), ceux-ci sont renvoyés en tant que `success` au lieu de `application_fail`. La classification suit le verdict du moteur sur vos règles, et non le code HTTP brut.

Un tunnel via le port proxy est classé selon le même vocabulaire, à l'exception des deux résultats `target` : la réponse d'un tunnel correspond à votre propre trafic chiffré, FourA ne voit donc jamais si le site sous-jacent a répondu favorablement. Pour la taxonomie complète et son association avec la facturation, consultez [Résultats des requêtes](https://foura.ai/docs/api/outcomes).

## Ressources associées

- [Aperçu du tableau de bord](https://foura.ai/docs/dashboard/overview) : Cartes de synthèse, graphiques temporels, Période et Détail (Détail est présent sur Aperçu uniquement)
- [Résultats des requêtes](https://foura.ai/docs/api/outcomes) : Les valeurs de résultat expliquées en détail, pour les requêtes et les tunnels
- [En-têtes de réponse](https://foura.ai/docs/api/response-headers) : D'où proviennent les crédits
- [Port proxy](https://foura.ai/docs/api/proxy-port) : Le produit couvert par les vues Proxy
- [Organisations](https://foura.ai/docs/dashboard/teams-and-orgs) : Ce que couvre le filtre Propriétaire
- [Erreurs d'API](https://foura.ai/docs/api/errors) : Comment les erreurs sont transmises sur le réseau
