Aperçu de la requête
Aperçu de la requête de vérification API
Qu'est-ce que l'aperçu de la requête ?
L'aperçu de la requête envoie une fois la requête de votre vérification, depuis un emplacement cloud de votre choix, et montre ce qui est revenu avant l'enregistrement de la vérification. Dans le formulaire de nouvelle vérification, saisissez l'URL et cliquez sur Prévisualiser la requête. C'est une requête unique : elle montre comment se comporte un appel, pas comment l'API tient sous charge. Les vérifications multi-étapes ne peuvent pas être prévisualisées dans le formulaire ; ouvrez plutôt la page de résultats après la première exécution.
Simuler depuis plusieurs emplacements
Choisissez l'emplacement dans la liste déroulante à côté du bouton d'aperçu. Il y en a 26 au choix, et la liste démarre sur le premier emplacement sélectionné pour la vérification. Si vous prévisualisez depuis un emplacement différent de celui d'où la vérification s'exécutera, le formulaire vous le signale, pour qu'un aperçu rapide depuis une région ne soit pas confondu avec ce que mesurera une vérification dans une autre. Pour comparer des régions, prévisualisez à nouveau la même requête depuis un autre emplacement.
Décomposition du temps de réponse
L'onglet Métriques montre la décomposition du temps de réponse, une barre par phase avec son temps en millisecondes, pour voir où se situe le retard. Les phases sont :
- Attente : Le temps passé à attendre la réponse initiale du serveur après l'envoi de la requête.
- DNS : Le temps nécessaire pour résoudre le nom de domaine en une adresse IP.
- TCP : Le temps nécessaire pour établir une connexion TCP entre le client et le serveur.
- TLS : Le temps nécessaire pour établir une connexion TLS sécurisée, le cas échéant.
- Requête : Le temps nécessaire pour envoyer la requête HTTP au serveur.
- Premier octet : Le temps nécessaire au serveur pour envoyer le premier octet de la réponse.
- Téléchargement : Le temps nécessaire pour télécharger l'intégralité de la réponse du serveur.
Ces métriques fournissent une vue complète des différentes étapes de la requête, vous permettant d'identifier les domaines spécifiques qui pourraient nécessiter une optimisation.
Consultation des détails de la requête et de la réponse
L'onglet Corps affiche le corps de la réponse (un corps long est replié ; cliquez sur Développer pour en voir plus). L'onglet En-têtes liste :
- En-têtes de la réponse : tous les en-têtes retournés par le serveur.
- En-têtes de la requête : tous les en-têtes envoyés avec la requête.
Ces en-têtes peuvent être facilement copiés dans le presse-papiers en cliquant sur l'icône de copie à côté de la valeur de l'en-tête, ce qui facilite le partage ou l'analyse approfondie des informations.
Cas d'utilisation pratiques
- Analyse de la latence : Déterminez si et où la latence affecte les performances de votre API.
- Débogage : Identifiez les problèmes aux différentes étapes du cycle de vie de la requête (résolution DNS, connexion TCP, négociation TLS, etc.).
- Comparaison régionale : prévisualisez la même requête depuis deux emplacements et comparez la latence.
- Validation des en-têtes : Vérifiez que les bons en-têtes sont envoyés et reçus.
Quand l'aperçu vous convient, ajoutez des assertions et enregistrez la vérification.