Recueillir les informations nécessaires pour dépanner les problèmes relatifs aux sites

Apprendre à recueillir des données pour diagnostiquer les problèmes et faciliter le dépannage avec le support Cloudflare.  Pour la plupart des dépannages, Cloudflare recommande fortement de commencer par générer un fichier HAR.

Cet article a déjà été publié sous le titre Comment générer un fichier HAR ?

• Présentation
• Générer un fichier HAR
• Identifier le centre de données Cloudflare qui traite votre requête
• Dépanner les requêtes avec cURL
• Mettre Cloudflare temporairement en pause
• Effectuer une traceroute
• Ajoutez l’en-tête CF-RAY à vos journaux
• Ressources associées

---

Présentation

Pour diagnostiquer un problème, il est important de recueillir autant d'informations que possible et de fournir des détails sur ce problème au support Cloudflare. Cet article vous explique comment recueillir les informations de dépannage demandées habituellement par le support Cloudflare.

Le support Cloudflare ne peut pas modifier la configuration à la place des clients pour des raisons de sécurité et de responsabilité.

---

Générer un fichier HAR

Une archive HTTP (HAR) enregistre toutes les requêtes du navigateur web, y compris les en-têtes de requête et de réponse, le contenu principal et le temps de chargement de page.

Un fichier HAR peut contenir des informations confidentielles telles que des mots de passe, des coordonnées de paiement et des clés privées. Effacez manuellement les informations sensibles d’un fichier HAR via un éditeur de texte avant de l'envoyer au support Cloudflare.

Pour le moment, seuls Chrome et Firefox peuvent accéder par défaut à la fonction HAR. D'autres navigateurs nécessitent une extension de navigateur ou ne permettent pas de générer un fichier HAR. Lors de l'installation d'une extension de navigateur, suivez les instructions du fournisseur de l'extension.

Dans Chrome

1. Dans une page du navigateur, effectuez un clic droit n'importe où et sélectionnez Inspecter l'élément.

2. Les outils de développement apparaissent en bas ou à gauche du navigateur. Cliquez sur l’onglet Network.

3. Cochez Preserve log.

4. Cliquez sur record.

 

5. Accédez à l'URL qui provoque les problèmes. Une fois le problème rencontré, cliquez avec le bouton droit de la souris sur l’un des éléments dans l’onglet Network et sélectionnez Save all as HAR with Content.

 

 6. Joignez le fichier HAR à votre ticket de support.

Dans Firefox

1. Accédez au menu de l’application, sélectionnez Tools > Web Developer > Network ou appuyez sur Ctrl+Shift+I (Windows/Linux) ou Cmd+Option+I (OS X).

2. Accédez à l'URL qui provoque les problèmes.

3. Après avoir dupliqué le problème, effectuez un clic droit et choisissez Save All As HAR.

Dans Microsoft Edge

Internet Explorer ne permet pas de créer des fichiers HAR, mais une fonctionnalité similaire est décrite dansMicrosoft Developer Network.

1. Accédez aux outils de développement (utilisez la touche F12) et sélectionnez l’onglet Network.

2. Accédez à l'URL qui provoque les problèmes.

3. Après avoir dupliqué le problème, cliquez sur Export as HAR puis sur Enregistrer sous....

Dans Safari

1. Dans Safari, vérifiez qu'un menu Develop apparaît en haut de la fenêtre du navigateur. Si ce n’est pas le cas, accédez à Safari > Préférences > Avancées et sélectionnez « Afficher le menu Développement dans la barre de menus ».

2. Accédez à Développement > Afficher l’inspecteur web.

L’inspecteur web ne sera pas disponible tant que vous n'ouvrirez pas une page autre que la page d’accueil de Safari.

3. Accédez à l'URL qui provoque les problèmes.

4. En maintenant la touche Ctrl enfoncée, cliquez sur une ressource dans l’inspecteur web et cliquez sur Export HAR.

---

Identifier le centre de données Cloudflare qui traite votre requête

Vous trouverez une carte de nos datacenters sur la page de statut Cloudflare, triés par continent. Le code à trois lettres dans le nom du datacenter est le code IATA de l’aéroport international majeur le plus proche. Déterminez quel centre de données Cloudflare traite les requêtes de votre navigateur en visitant :

  http://www.exemple.com/cdn-cgi/trace 

Remplacez www.exemple.com par votre nom de domaine et d'hôte.  Notez le champ colo de la sortie

---

Dépannez les requêtes avec cURL

cURL est un outil de commande en ligne pour envoyer des requêtes HTTP/HTTPS, il est utile pour dépanner :

• La performance HTTP/HTTPS
• Les réponses d’erreur HTTP
• Les en-têtes HTTP
• Les API
• La comparaison des réponses serveur/proxy
• Les certificats SSL

cURL n'est pas installé par défaut dans Windows et nécessite un assistant installation..

Exécutez la commande suivante pour envoyer une requête HTTP GET standard à votre site web (remplacez www.exemple.com par votre nom de domaine et nom d'hôte) :

curl -svo /dev/null http://www.exemple.com/

Cet exemple de commande cURL renvoie une sortie détaillant la réponse HTTP et les en-têtes de requête mais supprime la sortie du corps de la page. La sortie de cURL confirme la réponse HTTP et indique si Cloudflare proxyse actuellement du trafic pour le site. La présence de l'en-tête CF-RAY dans la réponse confirme que la requête a été proxysée par Cloudflare

CF-RAY : 5097b5640cad8c56-LAX

Consultez les options de la commande cURL pour connaître les fonctionnalités supplémentaires.

Développez les sections ci-dessous pour obtenir des conseils sur le dépannage des erreurs HTTP, les performances, la mise en cache et les certificats SSL/TLS :

Erreurs HTTP

Lors du dépannage des erreurs HTTP dans les réponses de Cloudflare, vérifiez si votre origine a provoqué les erreurs en envoyant des requêtes directement à votre serveur web d'origine. Pour dépanner les erreurs HTTP, exécutez un cURL directement sur l’adresse IP de votre serveur web d'origine (en contournant le proxy Cloudflare) :

curl -svo /dev/null --header "Host: exemple.com" http://203.0.113.34/

Si vous avez plusieurs serveurs web d'origine, testez chacun d'entre eux pour voir s'il n'y a pas de différences de réponse. Si vous constatez ce problème lorsque vous vous connectez directement à votre serveur web d'origine, contactez votre fournisseur d’hébergement pour obtenir de l'aide.

Par exemple, si vous constatez une erreur HTTP 520 dans le trafic proxysé à travers Cloudflare, exécutez un cURL vers le serveur web d'origine pour déterminer si des réponses vides sont envoyées :

curl -svo /dev/null --resolve www.exemple.com:80:203.0.113.34 http://www.exemple.com/* www.exemple.com:80:203.0.113.34 vers cache DNS ajouté* Le nom d'hôte www.exemple.com a été trouvé dans le cache DNS* Essai avec 203.0.113.34...* Connecté à www.exemple.com (127.0.0.1) port 80 (#0)> GET / HTTP/1.1> Hôte : www.exemple.com> User-Agent: curl/7.43.0> Accepter : */*>* Réponse vide du serveur

Lorsque vous testez HTTPS, utilisez l’indicateur --insecure pour ignorer la validation du certificat SSL présenté par votre serveur web d'origine, sauf si vous avez un certificat valide installé par une vraie Autorité de certification.

Performance

cURL mesure la latence ou la dégradation de la performance pour les requêtes HTTP/HTTPS via les options -w ou --write-out de cURL. L'exemple cURL ci-dessous mesure plusieurs vecteurs de performance dans la transaction de requête tels que la durée du handshake TLS, la recherche DNS, les redirections, les transferts, etc. :

curl -svo /dev/null https://example.com/ -w "\nContent Type: %{content_type} \\nHTTP Code: %{http_code} \\nHTTP Connect:%{http_connect} \\nNumber Connects: %{num_connects} \\nNumber Redirects: %{num_redirects} \\nRedirect URL: %{redirect_url} \\nSize Download: %{size_download} \\nSize Upload: %{size_upload} \\nSSL Verify: %{ssl_verify_result} \\nTime Handshake: %{time_appconnect} \\nTime Connect: %{time_connect} \\nName Lookup Time: %{time_namelookup} \\nTime Pretransfer: %{time_pretransfer} \\nTime Redirect: %{time_redirect} \\nTime Start Transfer: %{time_starttransfer} \\nTime Total: %{time_total} \\nEffective URL: %{url_effective}\n" 2>&1

Vous trouverez une explication sur cette sortie de synchronisation sur le blog de Cloudflare.

Comme le montre l'exemple précédent, il est possible d'obtenir des résultats plus précis en ajoutant une nouvelle ligne avec \n avant chaque variable. Sinon, toutes les mesures sont présentées ensemble sur une seule ligne.

Mise en cache

cURL permet de visualiser les en-têtes de réponse HTTP qui influencent la mise en cache. Examinez en particulier plusieurs en-têtes HTTP lors du dépannage de la mise en cache Cloudflare :

• CF-Cache-Status
• Cache-control/Pragma
• Expires
• Last-Modified
• S-Maxage

Vous trouverez plus de détails sur le comportement de mise en cache de Cloudflare dans le centre d'aide de Cloudflare.

Certificats SSL/TLS

Examen des certificats avec cURL

La commande cURL suivante montre le certificat SSL desservi par Cloudflare lors d'une requête HTTPS (remplacez www.exemple.com par votre nom de domaine et votre nom d’hôte) :

curl -svo /dev/null https://www.exemple.com/ 2>&1 | egrep -v "^{.*$|^}.*$|^\* http.*$"

2>&1 | egrep -v "^{.*$|^}.*$|^\* http.*$" nettoie et analyse les informations de handshake et de certificat TLS.

Vérifiez le certificat d'origine (en supposant qu'il soit installé), remplacez 203.0.113.34 par l'adresse IP réelle de votre serveur web d'origine et remplacez www.exemple.com par votre nom de domaine et votre nom d’hôte :

curl -svo /dev/null --header "Host: www.exemple.com" http://203.0.113.34/ 2>&1 | egrep -v "^{.*$|^}.*$|^\* http.*$"

Test des versions TLS

En cas de dépannage de la prise en charge du navigateur ou de vérification des versions TLS prises en charge, cURL vous permet de tester une version TLS spécifique en ajoutant une des options suivantes à votre cURL :

• --tlsv1.0
• --tlsv1.1
• --tlsv1.2
• --tlsv1.3

---

Mettre Cloudflare temporairement en pause

Mettez Cloudflare en pause pour envoyer du trafic directement à votre serveur web d'origine au lieu du proxy inverse de Cloudflare. Aucun service Cloudflare tel que SSL ou WAF n'est activé pour les domaines en pause.  Au lieu de mettre en pause Cloudflare dans son intégralité, vous pouvez passer en nuage gris les enregistrements recevant du trafic dans votre application DNS Cloudflare.

Lors du dépannage des problèmes de mise en cache, une alternative à la mise en pause de Cloudflare est le mode de développement qui contourne uniquement le cache de Cloudflare.

Pour mettre Cloudflare temporairement en pause :

1. Accédez à l’onglet Présentation du tableau de bord de Cloudflare.
2. Cliquez sur Pause Cloudflare on Site en bas à droite de la page dans Advanced Actions.

La mise en pause de Cloudflare prend cinq minutes ou moins. Elle est préférable à un changement de serveur de noms en dehors de Cloudflare car un changement de serveur de noms peut en traîner des retards de propagation de plusieurs heures.

---

Exécuter une commande traceroute

Traceroute est un outil de diagnostic des réseaux qui permet de mesurer la latence de transmission des paquets à travers un réseau. La majorité des systèmes d’exploitation prennent en charge la commande traceroute. Si vous avez des problèmes de connectivité avec votre site web proxy Cloudflare et que vous demandez de l'aide au support Cloudflare, veillez à inclure la sortie d’une commande traceroute.

Des délais (timeouts) sont possibles pour les résultats de ping car Cloudflare limite les requêtes ping.

Consultez les instructions pour exécuter une traceroute sur différents systèmes d’exploitation. Remplacez www.exemple.com par votre nom de domaine et nom d'hôte dans les exemples ci-dessous :

Lancer traceroute sous Windows

1. Ouvrez le menu Démarrer.
2. Cliquez sur Exécuter.
3. Pour ouvrir l’interface de ligne de commande, tapez cmd puis cliquez sur OK.
4. Dans l’invite de commande, tapez :
   Pour IPv4 -
   

   > tracert www.exemple.com

   Pour IPv6 -
   

   > tracert -6 www.exemple.com

5. Appuyez sur Entrée.
6. Vous pouvez copier les résultats pour les enregistrer dans un fichier ou les coller dans un autre programme.

Lancer traceroute sous Linux

1. Ouvrez une fenêtre de terminal.
2. Dans l’invite de commande, tapez :
   Pour IPv4 -
   

   > traceroute www.exemple.com

   Pour IPv6 -
   

   > traceroute -6 www.example.com

3. Vous pouvez copier les résultats pour les enregistrer dans un fichier ou les coller dans un autre programme.

Exécuter traceroute sous Mac OS

1. Ouvrez l’application Utilitaire de réseau.
2. Cliquez sur l’onglet Traceroute
3. Saisissez le domaine ou l'adresse IP dans le champ de saisie approprié et appuyez sur Trace.
4. Vous pouvez copier les résultats pour les enregistrer dans un fichier ou les coller dans un autre programme.

Vous pouvez également suivre les mêmes instructions de traceroute sur Linux ci-dessus lorsque vous utilisez le programme de terminal Mac OS.

---

Ajoutez l’en-tête CF-RAY à vos journaux

L'en-tête CF-RAY permet de suivre une requête de site web sur le réseau Cloudflare. Transmettez le CF-RAY  d'une requête web au support Cloudflare dans le cadre du dépannage d'un problème. Vous pouvez également ajouter CF-RAY à vos journaux en éditant la configuration de votre serveur web d'origine avec le snippet ci-dessous qui correspond à votre marque de serveur web :

Pour les serveurs web Apache, ajoutez  %{CF-Ray}i à LogFormat

LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\" %{CF-Ray}i" cf_custom

Pour les serveurs web Nginx, ajoutez  %{CF-Ray}i à log_format

log_format cf_custom '$remote_addr - $remote_user [$time_local]  ''"$request" $status $body_bytes_sent ''"$http_referer" "$http_user_agent" ''$http_cf_ray';

---

Ressources associées

• Contacter le support Cloudflare
• Dépannage des erreurs HTTP 5XX Cloudflare
• Diagnostic des problèmes de réseau avec MTR et traceroute
• Outil en ligne de commande cURL