Aperçu du tableau de bord
Le tableau de bord FourA est l'endroit où vous gérez vos clés d'API et vos utilisateurs proxy, exécutez des requêtes de test, surveillez les performances, gérez la facturation et configurez votre compte. Cette page détaille l'écran principal Vue d'ensemble ainsi que les sections de la barre latérale.
Accéder au tableau de bord
Connectez-vous sur foura.ai/dashboard. Vous avez besoin d'un compte FourA : inscrivez-vous ici si vous n'en avez pas.
Deux produits, un ensemble unique de pages
Les pages Vue d'ensemble, Métriques et Activité s'ouvrent chacune avec un sélecteur de Produit proposant deux options :
| Produit | Ce qui est mesuré | Unité |
|---|---|---|
| API | Les requêtes envoyées à /api/single, /api/proxy, /api/browser et /api/auto |
Requêtes et crédits |
| Proxy | Les tunnels que vos propres outils ouvrent via proxy.foura.ai |
Tunnels et octets |
Un tunnel transporte tout ce que votre client y achemine, et le contenu circulant à l'intérieur d'un CONNECT constitue votre propre trafic chiffré. Ainsi, les vues Proxy comptabilisent les tunnels et les octets, mais jamais les requêtes ni les crédits. Consultez Port Proxy pour en savoir plus sur le produit lui-même.
Le sélecteur est toujours positionné sur l'un des deux produits, conserve votre choix d'une visite à l'autre et apparaît dans l'URL sous la forme #overview/proxy, #metrics/proxy ou #activity/proxy. En ouvrant l'un de ces liens, la page s'affiche directement sur le produit correspondant.
Ne confondez pas le produit Proxy avec la pastille d'endpoint Proxy Finder. Proxy Finder correspond à POST /api/proxy/, l'un des quatre endpoints de l'API. Le produit Proxy désigne le port proxy.
Page Vue d'ensemble, Produit API
La page d'accueil après connexion présente vos indicateurs clés pour la période sélectionnée. La page s'actualise automatiquement toutes les 60 secondes, et le bouton d'actualisation situé à côté du titre affiche le compte à rebours tout en permettant un rechargement immédiat.
Avant votre première requête
Tant que votre première requête n'a pas été reçue, la vue API présente des données d'exemple, signalées par un tag Exemple sur chaque panneau et graphique, sous une bannière Ceci est un exemple de données. comportant deux étapes : Créer une clé d'API, dont la nouvelle clé s'affiche avec une commande de test, et Ouvrir le Playground pour envoyer une requête. Sur téléphone ou tablette, ces étapes vous orientent vers le Playground, car un téléphone ne peut pas exécuter la commande. Votre première requête réelle remplace définitivement les données d'exemple.
La vue Proxy comporte sa propre bannière Aucun trafic pour le moment. avec les options Créer un utilisateur proxy et Ouvrir le Proxy, affichée jusqu'à ce que l'un de vos utilisateurs proxy achemine du trafic ou que votre première requête API réelle soit enregistrée. Fermer l'une des bannières masque les deux.
Cartes récapitulatives
Six panneaux en haut de l'écran :
| Panneau | Ce qu'il affiche |
|---|---|
| Concurrence | Requests exécutées en même temps actuellement, ainsi que la moyenne et le maximum pour la période |
| Requests | Total des appels, puis Single, Proxy, Browser et Auto, chacun avec sa part du total en dessous. Un appel Auto compte une fois, sous Auto. |
| Tentatives Auto | Toujours affichées, avec des zéros si Auto n'a rien exécuté pendant la période. Les requests Single, Proxy et Browser effectuées par Auto derrière vos appels Auto, avec les tentatives par appel Auto. Elles ne sont jamais comptabilisées comme requests ni dans le taux de réussite, et leurs crédits sont inclus dans ceux d'Auto. Elles sont en revanche prises en compte dans vos limites de rate limit et de concurrence pour Single, Proxy et Browser. |
| Crédits | Crédits facturés comme valeur principale, crédits consommés en dessous, pour le total et pour chaque produit, Auto compris |
| Octets | Données transférées : Entrant correspond à ce que vous avez envoyé, Sortant à ce qui a été renvoyé, et Premium à la part de ce trafic ayant transité par une sortie premium, que cette sortie ait délivré la page ou non. Premium est déjà compris dans les deux totaux et ne s'y ajoute jamais. |
| Temps de réponse | Moyenne, min et max sur la période |
Facturé et consommé correspondent à des chiffres distincts. Seule une request réussie est facturée, le montant facturé est donc ce que vous payez réellement. Le montant consommé inclut chaque issue, car une request échouée consomme tout de même un proxy ou un navigateur. Confondre les deux donne l'impression d'avoir deux comptes distincts selon la page consultée. Consultez Résultats des requests pour savoir quelles issues sont facturées.
Les panneaux Requests et Crédits affichent les quatre endpoints : Single, Proxy, Browser et Auto. La ligne de filtre Endpoints située au-dessus nomme Proxy sous le libellé Proxy Finder, ce qui désigne la même chose : POST /api/proxy/.
La somme de ces quatre éléments ne correspond pas toujours au total. Un petit nombre d'appels ne relève d'aucun d'entre eux : ils apparaissent dans le total, mais dans aucun endpoint.
Graphiques chronologiques
Sous les panneaux, six graphiques chronologiques tracent le volume de requests, la consommation de crédits, la répartition des issues, le temps de réponse, la bande passante et la concurrence. Chaque graphique comporte un bouton dans son en-tête permettant de basculer entre le tracé et le tableau sous-jacent.
Page Overview, produit Proxy
Passez Produit sur Proxy et cette même page s'affiche en métriques de tunnels. Quatre panneaux :
| Panneau | Ce qu'il affiche |
|---|---|
| Tunnels simultanés | Tunnels ouverts au même instant. Actuel couvre les dernières secondes et s'actualise toutes les cinq secondes ; Moy et Max couvrent la période. Votre forfait limite cette valeur pour l'ensemble de vos utilisateurs proxy combinés. |
| Tunnels | Réussis et Échoués, chacun avec sa part du total. Échoué regroupe toutes les autres issues, et la ligne Résultat précise lesquelles. |
| Trafic | Entrant correspond à ce que vos outils ont envoyé, Sortant à ce qui a été renvoyé, et Premium à la part qui a transité par le réseau premium, déjà comptabilisée dans les totaux au lieu d'y être ajoutée. |
| Temps d'établissement | Temps d'attente moyen, min et max avant la mise à disposition d'un tunnel, sur les tunnels réussis uniquement. Il s'agit du délai avant votre premier octet, et non de la vitesse du site situé derrière le tunnel. |
Cinq graphiques chronologiques se trouvent en dessous : Tunnel Timeline, Outcome Timeline, Setup Time Timeline, Traffic Timeline et Tunnels at Once Timeline. Chacun dispose du même sélecteur graphique ou tableau que les graphiques API.
Trois panneaux et leurs graphiques chronologiques s'estompent lorsqu'une pastille Outcome est activée, car la valeur n'existe pas pour ce résultat. Tunnels at Once s'estompe pour n'importe quel résultat, et son graphique affiche un badge Not filterable. Setup Time et Traffic s'estompent lors d'un résultat en échec, et leurs graphiques affichent un badge Success only, car un tunnel ayant échoué n'a jamais été transmis et n'a rien acheminé.
Période et détail
Period définit l'intervalle d'historique affiché. Huit pastilles plus l'option Custom :
| Pastille | Fenêtre |
|---|---|
| 30M | 30 dernières minutes |
| 3H | 3 dernières heures |
| 12H | 12 dernières heures |
| 24H | 24 dernières heures |
| 7D | 7 derniers jours |
| 30D | 30 derniers jours |
| 90D | 90 derniers jours |
| 1Y | 12 derniers mois |
Custom ouvre une boîte de dialogue avec quatre préréglages, This month, Last month, Last 6 months et All time, ainsi qu'une paire de dates From et To. Une plage de dates s'étend jusqu'à la fin du jour sélectionné, jamais au-delà de l'instant présent.
Detail correspond à la largeur de chaque barre : par minute, toutes les 5 minutes, toutes les 30 minutes, par heure, toutes les 6 heures, par jour, par semaine ou par mois. La valeur par défaut est Auto, qui choisit le pas le plus large permettant de conserver au moins quinze barres sur le graphique, afin qu'une année ressemble à une courbe lisible plutôt qu'à 365 traits serrés. L'option Auto affiche le pas retenu.
Period et Detail s'appliquent aux deux produits.
Les pas de détail remontant plus loin que la durée de rétention de FourA pour cette résolution sont grisés au lieu d'être masqués :
| Résolution | Historique disponible |
|---|---|
| Par requête | 7 jours |
| 5 minutes | 30 jours |
| Par heure | 12 mois |
| Par jour | Tout l'historique |
Si vous choisissez une période plus ancienne que ce qu'un niveau autorise, les options les plus fines sont grisées. Auto n'en sélectionne jamais aucune, garantissant qu'un graphique ne soit jamais vide en raison de l'agrégation des données.
Filtres
Les filtres se cumulent et se combinent, et Period ainsi que Detail fonctionnent à leurs côtés.
| Filtre | Produit | Rôle |
|---|---|---|
| Product | Les deux | API ou Proxy |
| Endpoints | API | Restreindre à un seul endpoint : Single, Proxy Finder, Browser ou Auto. Un appel Auto compte une fois, sous Auto ; les requêtes Single, Proxy et Browser effectuées en arrière-plan par sa cascade apparaissent par leur nom dans le panneau Auto attempts, jamais en tant que requêtes distinctes. |
| Outcome | Les deux | Isoler une catégorie. L'API propose les sept catégories ; le produit Proxy propose les cinq états finaux possibles d'un tunnel. |
| Owner | Les deux | Everything, Personal ou l'une de vos organisations. Apparaît uniquement si vous appartenez à au moins une organisation. |
| Key | API | Restreindre à une seule clé API |
| Proxy user | Proxy | Restreindre à un seul utilisateur proxy |
Le panneau Concurrency et son graphique côté API n'acceptent pas les filtres Endpoints ou Outcome. Les deux s'estompent si l'un de ces filtres est actif, et le graphique l'indique dans son en-tête.
Le filtre Owner
Le menu déroulant Owner répond à la question « à qui appartient le trafic affiché ». Il propose Everything, Personal, ainsi qu'une entrée par organisation à laquelle vous appartenez. Ce même filtre s'applique à Metrics, Activity, API Keys et Proxy selon votre choix, assurant la cohérence entre les pages.
Usage & Limits et Billing ne l'utilisent pas délibérément. Ces sections indiquent « ce qui vous est facturé », c'est-à-dire vos clés personnelles et vos utilisateurs proxy, en plus de ceux des organisations dont vous êtes propriétaire. Consultez Organizations.
Sections de la barre latérale
Onze pages et un lien Docs, répartis en quatre groupes : Dashboard, Tools, Access et Account.
Dashboard : Overview, Metrics, Activity
Les trois pages qui répondent à la question « que s'est-il passé ». Toutes les trois intègrent le sélecteur Product.
Overview est la page présentée ci-dessus, et constitue toujours le point d'entrée après connexion.
Metrics contient le panneau Usage : une répartition groupée par clé API, IP cliente ou domaine côté API, et par utilisateur proxy, cible, pays de sortie, IP cliente ou résultat côté Proxy, avec des cartes récapitulatives pour l'ensemble de la période au-dessus d'un tableau paginé. Consultez le guide des métriques.
Activity affiche le trafic de la dernière heure. Les données se chargent à l'ouverture de la page, et le bouton d'actualisation récupère les lignes les plus récentes. Côté API, chaque ligne représente une requête : méthode, domaine cible, statut, résultat, durée, volume transféré et crédits. Côté Proxy, chaque ligne représente un tunnel : utilisateur proxy, cible, sortie, résultat, configuration, durée, octets et IP cliente. Consultez le journal d'activité.
Tools : Playground, Extension, Docs
Testez des requêtes en direct avec votre véritable clé API sans écrire la moindre ligne de code. Choisissez Auto, Single, Proxy ou Browser, définissez une URL, ajustez les options et les délais d'expiration, puis cliquez sur Send. Enregistrez les configurations courantes sous forme de préréglages et rejouez l'une de vos 20 dernières exécutions depuis l'historique.
L'utilisation est décomptée du quota de la clé, exactement comme un appel en production. Consultez le guide du Playground.
Extension, signalée par la mention Beta, vous permet de télécharger l'extension Chrome FourA. Sa fenêtre contextuelle achemine le trafic de Chrome via l'un de vos utilisateurs proxy, et son onglet FourA dans DevTools convertit n'importe quelle requête émise par une page en un appel API prêt à l'emploi. Consultez Chrome Extension.
Docs ouvre cette documentation dans un nouvel onglet, ce qui conserve la page du tableau de bord sur laquelle vous vous trouvez.
Le bouton de thème en haut de la barre latérale alterne entre le paramètre de votre appareil, le mode clair et le mode sombre. Ce choix est synchronisé avec foura.ai et la documentation, de sorte qu'un thème sélectionné sur l'un d'eux s'applique également au tableau de bord.
Access : API Keys, Proxy
API Keys vous permet de créer, consulter et gérer les clés utilisées par vos applications pour interroger l'API. Les clés utilisent le préfixe pk_live_. Consultez Managing API Keys.
Proxy vous permet de créer des utilisateurs proxy et de copier une chaîne de connexion pour tout client acceptant une URL de proxy. Les tunnels et le trafic via le port sont décomptés de votre forfait, tout comme l'API. Consultez la documentation Proxy Users et la référence du Proxy Port.
Compte : Organisations, Utilisation et limites, Facturation, Paramètres
Organisations permet de partager des clés API et des utilisateurs proxy avec des collaborateurs sous la responsabilité d'un seul propriétaire. Ajoutez des membres par e-mail, définissez leur rôle et transférez l'organisation en cas de changement de responsable. La consommation liée aux identifiants d'une organisation est décomptée du forfait de son propriétaire. Consultez Organisations.
Utilisation et limites affiche votre forfait, votre consommation sur la période de facturation en cours et l'ensemble des limites applicables, avec une ventilation par clé, par endpoint et par utilisateur proxy. Consultez Utilisation et limites.
Facturation gère votre abonnement, l'achat de crédits ou de trafic supplémentaires, conserve vos moyens de paiement ainsi que vos factures, et affiche les crédits, le volume de trafic global et le trafic premium consommés sur la période par rapport à votre forfait. Consultez Facturation et abonnements.
Paramètres regroupe votre nom d'affichage, votre mot de passe, vos sessions actives et vos fournisseurs d'authentification connectés. La modification de l'adresse e-mail n'est pas disponible dans le tableau de bord : contactez le support.
Conseils
- Utilisez le Playground avant d'écrire du code. Si vous ne savez pas quel moteur convient pour un nouveau site, commencez avec Auto pour le laisser choisir.
- Comparez le montant facturé et les dépenses sur la carte Crédits. Un endpoint présentant un écart important échoue fréquemment, et le rapport de tentatives en précise la cause.
- Sur le produit Proxy, un bloc « Rate Limited » dans la chronologie des résultats indique que la limite de votre forfait est atteinte, et non un refus du site cible. La vue Résultats de Métriques indique laquelle.
- Protégez vos clés API et vos utilisateurs proxy. Désactivez immédiatement tout identifiant suspecté d'être compromis.
Étapes suivantes
- Authentification : création de clés API et détails de gestion
- Démarrage rapide : effectuez votre première requête depuis la CLI
- Calcul de votre forfait : crédits, trafic et plafonds applicables
- Utilisation et limites : suivez vos crédits et votre trafic selon votre forfait
- Endpoints de l'API : utilisez directement l'API