Journaux et inspection des requêtes
Sur cette page 8 sections
- Ce qui est disponible et où
- Inspecteur de requêtes pour les tunnels HTTP
- Ouvrir l'inspecteur
- La liste des requêtes
- Détails de la requête et de la réponse
- Rejouer une requête
- Désactiver et activer la journalisation des requêtes
- Journal des connexions des autres tunnels
- Télécharger le journal en CSV
- Journal d'activité
- Santé du tunnel
- Quand un tunnel s'arrête
- Dépannage
- Pages associées
Voyez ce qui se passe sur un tunnel : inspectez et rejouez les requêtes HTTP qu'il reçoit, listez les connexions établies vers lui, lisez le journal des démarrages, arrêts et modifications de paramètres, et vérifiez sa santé au fil de la journée. Cette page indique aussi où regarder lorsqu'un tunnel s'est arrêté.
Ce qui est disponible et où #
Tout cela se trouve sous forme de lignes dans le panneau de paramètres du tunnel : ouvrez la page du type de tunnel sous Mes tunnels et sélectionnez Paramètres dans la ligne du tunnel.
| Ligne | Ce qu'elle ouvre | Types de tunnel |
|---|---|---|
| Journal des requêtes | L'inspecteur de requêtes, avec les requêtes et réponses enregistrées. | HTTP, Passerelle MCP |
| Journal des requêtes | Le journal des connexions : qui s'est connecté, quand et vers où. | TCP - UDP, TLS, Serveur de fichiers, Serveur proxy |
| Journal d'activité | Démarrages, arrêts et modifications de paramètres du tunnel. | Tous les types de tunnel |
| Santé du tunnel | Les résultats des contrôles de santé réguliers. | Tous les types de tunnel sauf Serveur de fichiers |
| Trafic de bande passante | Les données qui ont transité par le tunnel. Voir Limites et expiration. | Tous les types de tunnel |
Un Proxy rotatif conserve ses journaux de requêtes par client : utilisez le bouton Journaux des requêtes d'un client. Voir Proxy rotatif.
Inspecteur de requêtes pour les tunnels HTTP #
L'inspecteur affiche les requêtes HTTP qui atteignent un tunnel HTTP ou Passerelle MCP, avec leurs en-têtes et leurs corps, ainsi que les réponses données par votre service. Servez-vous-en pour déboguer des webhooks et des appels d'API sans ajouter de journalisation à votre propre code. Les requêtes ne sont enregistrées qu'après activation de la journalisation, comme décrit ci-dessous.
L'enregistrement n'est pas une copie octet pour octet. Un corps est conservé jusqu'à 16 Ko, et uniquement pour les formats texte tels que JSON, XML, HTML, texte brut et données de formulaire encodées en URL. Les valeurs des en-têtes sensibles, comme Authorization, Cookie et X-Api-Key, sont enregistrées sous la forme [MASKED].
Ouvrir l'inspecteur #
- Dans les paramètres du tunnel, sélectionnez Journal des requêtes › Afficher, ou
- dans la liste des tunnels, sélectionnez le bouton dont l'info-bulle est Voir les journaux de requêtes et réponses. Ce bouton vous demande de démarrer d'abord le tunnel s'il est arrêté. Pour les tunnels dont la colonne Serveur affiche Locale ou VPN, il est désactivé, avec l'info-bulle « Non disponible pour Client Relay ».
La page Inspecteur s'ouvre dans un nouvel onglet.
La liste des requêtes #
La carte Requêtes HTTP liste les requêtes, les plus récentes en premier, et en charge davantage au fil du défilement. Tant que le badge affiche En direct, la liste est actualisée toutes les 3 secondes.
| Colonne | Ce qu'elle affiche |
|---|---|
| Méthode | La méthode HTTP, comme GET ou POST. |
| Endpoint | Le chemin qui a été demandé. |
| Pays, IP | L'origine de la requête. |
| Date et heure | Le moment où elle est arrivée, selon l'heure de votre navigateur. |
| Statut | Le code d'état HTTP avec lequel votre service a répondu. |
| Durée | Le temps qu'a pris la réponse, en secondes. |
Sans filtre, la liste couvre les dernières 24 heures. Filtrer par date propose Aujourd'hui, Hier, 7 derniers jours et Période personnalisée, et couvre aujourd'hui et les six jours précédents. Un filtre de date met la liste en direct en pause ; sélectionnez Passer en direct pour y revenir. Les journaux d'inspection sont conservés jusqu'à 7 jours.
Détails de la requête et de la réponse #
Sélectionnez une requête pour ouvrir ses détails.
| Élément | Onglet | Ce qu'elle affiche |
|---|---|---|
| Requête | Résumé | ID de la requête, IP de la requête, méthode, hôte, chemin, URL complète, horodatage, longueur de l'URL et nombre d'en-têtes. |
| Requête | En-têtes | Chaque en-tête de la requête avec sa valeur. |
| Requête | Corps | Le corps de la requête. Le JSON est mis en forme pour la lecture. Copier le copie. |
| Requête | Infos IP | Fuseau horaire, continent, pays, ville, code postal, région et coordonnées de l'adresse IP du visiteur. |
| Réponse | Résumé | ID de la réponse, statut, temps de réponse et nombre d'en-têtes. |
| Réponse | En-têtes, Corps | Ce que votre service a renvoyé. |
Rejouer une requête #
Rejouer vous évite de déclencher à nouveau le même webhook chez l'expéditeur.
- Rejouer renvoie la requête sélectionnée à partir de son enregistrement. La page affiche « Requête rejouée avec succès. » dès que le rejeu a été demandé ; elle n'attend pas le résultat.
- Modifier ouvre Modifier la requête, où vous pouvez changer la méthode (GET, POST, PUT, DELETE ou PATCH), le Chemin, les en-têtes (Ajouter un en-tête) et le Corps avant de sélectionner Rejouer.
L'application Localtonet de l'appareil du tunnel envoie la requête rejouée ; elle doit donc être connectée.
Désactiver et activer la journalisation des requêtes #
Les requêtes ne sont capturées que lorsque la journalisation est activée, et un tunnel démarre avec la journalisation désactivée. Tant qu'elle est désactivée, la page affiche « La journalisation des requêtes est désactivée - les nouvelles requêtes ne seront pas capturées. » avec le bouton Activer la journalisation. Désactiver la journalisation arrête à nouveau la capture des nouvelles requêtes. Désactivez la journalisation pour un tunnel qui transporte des données que vous ne voulez pas stocker, comme des mots de passe ou des données personnelles dans les corps de requête. La modification est inscrite dans le Journal d'activité sous la forme « Paramètre du webhook HTTP modifié. »
Journal des connexions des autres tunnels #
Sur les tunnels TCP - UDP, TLS, Serveur de fichiers et Serveur proxy, Journal des requêtes › Afficher ouvre la boîte de dialogue Journal des requêtes. Elle liste les connexions établies vers le tunnel, les plus récentes en premier, 30 par page.
| Colonne | Ce qu'elle affiche |
|---|---|
| IP du visiteur | L'adresse qui s'est connectée au tunnel. |
| IP du client | L'adresse du client enregistrée pour la connexion. |
| Destination | Là où est allée la connexion. Pour un tunnel proxy, il s'agit de l'hôte et du port visités. |
| Date | Le moment où cela s'est produit, dans le fuseau horaire de votre compte. |
Ce journal ne contient que des métadonnées de connexion. Il ne contient pas ce qui a été envoyé par la connexion.
Télécharger le journal en CSV #
Sous Télécharger en CSV, choisissez une période allant jusqu'à 30 jours et sélectionnez Télécharger. Le nom du fichier commence par RequestLogs-, suivi de l'identifiant interne du tunnel, et se termine par .csv. Il comporte les colonnes Date et heure, IP de la requête, IP du client, Destination, Jeton et Protocole. Pour une période plus longue, téléchargez plusieurs périodes l'une après l'autre. Les téléchargements sont limités à un par minute ; attendez donc une minute entre deux.
Journal d'activité #
Journal d'activité › Afficher liste ce qui est arrivé au tunnel lui-même, du plus récent au plus ancien. Chaque entrée comporte la date et l'heure dans le fuseau horaire de votre compte, le canal d'où provient l'action, et une phrase qui indique ce qui a changé.
| Canal | L'action provient de |
|---|---|
| Web | Le tableau de bord. |
| API | L'API. |
| CLI | La ligne de commande. |
| Système | Localtonet lui-même, par exemple lorsqu'une limite a été atteinte. |
Entrées typiques :
- Tunnel démarré.
- Tunnel arrêté.
- Port local modifié de "3000" à "8080".
- Restriction IP ajoutée : "203.0.113.10"
- Limite de bande passante modifiée : "10.00 GB"
- Date d'expiration désactivée.
Un mot de passe nouveau ou modifié n'est pas écrit dans le journal. Il apparaît sous la forme « Mot de passe défini. » ou « Mot de passe modifié. »
Santé du tunnel #
Santé du tunnel › Afficher ouvre la boîte de dialogue Contrôles de santé. Localtonet vérifie le tunnel toutes les 10 minutes. Chaque carré représente un contrôle, par heure de la journée, pour le jour en cours.
| Valeur | Signification |
|---|---|
| Sain | Le tunnel était connecté lors de ce contrôle. |
| Défaillant | Le tunnel n'était pas connecté lors de ce contrôle. |
| Inconnu | Il n'y a aucun résultat pour cette heure ni pour une heure antérieure. |
| Aucune donnée | L'heure n'est pas encore arrivée aujourd'hui. |
| Disponibilité | La part des contrôles sains parmi les contrôles sains et défaillants. |
Lorsque la boîte de dialogue n'a aucun carré à afficher, elle indique « Aucun contrôle enregistré pour l'instant. Les résultats apparaîtront ici une fois que le tunnel aura fonctionné un moment. »
Quand un tunnel s'arrête #
Ouvrez d'abord le Journal d'activité du tunnel. La plus récente entrée « arrêté » donne la raison.
| Entrée du journal d'activité | Ce qui s'est passé | Que faire |
|---|---|---|
| « Tunnel arrêté. » | Quelqu'un l'a arrêté. Le canal indique d'où provient l'action, par exemple Web pour le tableau de bord ou API. | Sélectionnez Démarrer. |
| « Tunnel arrêté, car la limite de bande passante du tunnel a été atteinte. » | La Limite de bande passante propre au tunnel a été atteinte. | Augmentez la limite ou réinitialisez la consommation. Voir Limites et expiration. |
| « Tunnel arrêté, car sa date d'expiration a été atteinte. » | La Date d'expiration du tunnel est dépassée. | Définissez une date ultérieure ou désactivez-la. Voir Limites et expiration. |
| « Tunnel arrêté, car la limite d'utilisation gratuite a été atteinte. » | La limite de session de l'Offre gratuite a été atteinte. | Sélectionnez Démarrer pour commencer une autre session, ou ajoutez du solde. Voir Offres et solde. |
| « Tunnel arrêté, car la limite de bande passante totale a été dépassée. » | La bande passante du compte est épuisée. | Voir Offres et solde. |
| « Tunnel arrêté, car il était inactif et sans connexion. » | Localtonet a arrêté un tunnel qui était démarré mais pas connecté. | Gardez l'application Localtonet connectée et sélectionnez Démarrer lorsque vous avez de nouveau besoin du tunnel. |
Si le journal n'indique aucun arrêt mais que l'adresse ne répond pas, consultez la colonne Connexion de la liste des tunnels. OFF signifie que le tunnel n'est pas connecté : démarrez l'application Localtonet sur l'appareil. Lorsque vous sélectionnez Démarrer alors que l'application est hors ligne, le tableau de bord ouvre une boîte de dialogue intitulée « NAME est hors ligne » avec le texte « En attente de la connexion de l'application… ». Le tunnel démarre de lui-même dès que l'application se connecte ; Démarrer quand même active le tunnel tout de suite, et il passe en ligne lorsque l'application se connecte.
Soyez averti lorsqu'un tunnel tombe. La page Webhooks du tableau de bord peut envoyer une requête POST JSON à votre URL lorsqu'un tunnel se connecte ou se déconnecte. Voir Webhooks.
Dépannage #
« Veuillez d'abord démarrer votre tunnel. »
Le bouton d'inspecteur de la liste des tunnels ne s'ouvre que pour un tunnel en cours d'exécution. Démarrez le tunnel, ou ouvrez l'inspecteur avec Journal des requêtes › Afficher dans les paramètres du tunnel.
L'inspecteur reste vide
Vérifiez trois points : la bannière « La journalisation des requêtes est désactivée » n'est pas affichée ; aucun filtre de date n'est actif (sélectionnez Passer en direct) ; et la requête atteint bien l'adresse du tunnel, et non une autre adresse de votre service.
« Aucune requête enregistrée pour l'instant. » ou « Données introuvables ! »
Le journal des connexions n'a aucune entrée pour le tunnel, ou aucune dans la période choisie pour le CSV. Choisissez une autre période.
« Aucun journal trouvé pour ce tunnel. »
Le Journal d'activité n'a pas encore d'entrées. Il se remplit au fur et à mesure que le tunnel est démarré, arrêté et modifié.