Dépannage

Diagnostiquez les vrais problèmes rencontrés : rien ne s’exécute, tout échoue, ou le préchauffage fonctionne mais rien n’accélère.

12 min de lecture

Les problèmes se répartissent en trois groupes, et identifier celui que vous rencontrez en réduit immédiatement la cause.

Rien ne fonctionne du tout

Aucune donnée d'analyse n'apparaît. Généralement la vérification ou le commutateur actif.

Il fonctionne mais des erreurs

Les URL renvoient 403, 429, 5xx ou des redirections. Généralement des URL bloquantes ou erronées.

Cela fonctionne proprement mais rien ne s'améliore

Les codes d'état conviennent, les temps de chargement ne le sont pas. Presque toujours un problème de mise en cache, pas un problème de réchauffement.

Rien ne fonctionne du tout

  1. 1

    Le warmer Actif est-il ?

    La cause la plus courante, et de loin. Un warmer inactif conserve ses paramètres et ne s'exécute jamais.

  2. 2

    Le hostname Vérifié est-il ?

    Cochez Compte → Hostnames. La vérification en attente bloque chaque exécution. Voir Hostname vérification.

  3. 3

    L'URL d'entrée hostname correspond-elle exactement à celle vérifiée ?

    example.com et www.example.com sont différents. Un warmer pointé sur le formulaire non vérifié ne s'exécutera pas.

  4. 4

    Avez-vous atteint une limite de forfait ?

    Cochez Compte → Abonnement. L'épuisement d'un budget d'URL quotidien ou mensuel arrête le réchauffement jusqu'à ce que la période soit réinitialisée.

  5. 5

    Une fenêtre de planification le bloque-t-elle ?

    Si un programme chaud est défini, les démarrages programmés en dehors de la fenêtre sont ignorés. Essayez de démarrer le warmer à la main – si cela fonctionne, la fenêtre en est la cause.

  6. 6

    Êtes-vous dans le bon espace de travail ?

    Warmers appartient à un espace de travail. Vérifiez le sélecteur de la barre latérale – le warmer peut exister quelque part que vous ne recherchez pas actuellement.

Il fonctionne mais erreur d'URL

403 Interdit

Quelque chose bloque délibérément le robot d'exploration : un WAF, un filtre de robot, une gestion de robot Cloudflare ou un plugin de sécurité.

  • Mettez sur liste verte les demandes de Cache Rocket sur votre pare-feu ou votre CDN.
  • Définissez un agent utilisateur personnalisé distinctif et ajoutez-le à la liste verte.
  • Réduisez le nombre maximal d'URL par minute  : de nombreux filtres de robots se déclenchent en fonction du taux de requêtes plutôt que de l'identité.
  • Recherchez un bloc de pays, si la région de votre warmer diffère de celle à partir de laquelle vous naviguez habituellement.

429 Trop de demandes

Vous vous réchauffez plus rapidement que votre serveur ou CDN ne le permet. Réduisez considérablement le maximum d'URL par minute : réduisez-le de moitié, confirmez que les erreurs s'arrêtent, puis augmentez progressivement. Si votre hôte applique une limite de tarif documentée, restez confortablement en dessous de celle-ci.

Erreurs du serveur 5xx

Votre origine échoue sous la charge. Réduisez immédiatement la limite de taux.

Traitez 5xx comme urgent

Si le réchauffement peut pousser votre origine vers des erreurs de serveur, un léger pic de trafic peut également le faire. Le warmer a rencontré un réel problème de capacité. Réduisez le taux maintenant, puis regardez pourquoi l'origine est si fragile.

Redirections 301/302

Les URL de votre entrée ou les liens internes pointent vers un endroit qui redirige. Chaque redirection gaspille une demande et chauffe la mauvaise adresse.

  • Utilisez la destination finale comme URL d'entrée, en incluant ou en excluant www car votre site le propose réellement.
  • Utilisez toujours https://, jamais http://.
  • Activez Réécrire vers HTTPS si les liens internes utilisent toujours http.
  • Faites correspondre la convention de barre oblique finale de votre site.

404 introuvable

Liens internes brisés, plan de site obsolète répertoriant les pages supprimées ou découvertes d'URL qui n'ont jamais été réelles. Corrigez les liens, régénérez le plan du site ou excluez le modèle incriminé.

Mauvais nombre d'URL

Beaucoup moins que prévu

  • La profondeur est trop faible. Les pages plus loin que votre réglage de profondeur ne sont jamais atteintes.
  • Les plans de site sont désactivés. Les activer est généralement le plus gros gain de couverture.
  • Les exclusions sont trop larges. Une règle destinée à /search peut en attraper plus que vous ne le souhaitiez.
  • Votre navigation est uniquement JavaScript. Les liens qui n'existent pas dans le HTML ne peuvent pas être découverts par une récupération HTTP. Pensez au réchauffement du navigateur ou ajoutez des plans de site.

Bien plus que prévu

  • URL à facettes. Les combinaisons de filtres et de tri se multiplient sans limite. Excluez-les, en utilisant l'expression régulière si disponible.
  • Paramètres de session ou de suivi. Les URL qui diffèrent uniquement par un paramètre de requête sont comptées séparément.
  • Pagination profonde. Les pages d'archives de vingt profondeurs valent rarement la peine d'être réchauffées.
  • La profondeur est trop élevée. Reculez d'un niveau.

Tip

Un nombre d’URL inattendu et élevé est le moyen le plus courant de dépenser un budget mensuel sur des pages que personne ne visite. Lorsque le décompte vous surprend, consultez la liste d'URL réelle avant d'augmenter votre plan.

Cela fonctionne proprement mais rien ne va plus vite

Les codes d'état sont 200, les URL sont couvertes et les deux temps de chargement sont toujours lents. Le réchauffement fonctionne, mais pas votre mise en cache. Cache Rocket ne peut remplir qu'un cache existant.

  1. 1

    Confirmez que la page peut être mise en cache

    Regardez les en-têtes de réponse. Cache-Control: no-store ou private signifie qu'il ne sera jamais mis en cache, quelle que soit la fréquence à laquelle vous le réchauffez.

  2. 2

    Recherchez Set-Cookie sur les pages publiques

    De nombreux caches refusent de stocker une réponse qui définit un cookie. Les cookies d’analyse et de session sur les pages anonymes sont souvent responsables.

  3. 3

    Vérifiez les règles de cache de votre CDN

    Confirmez que le chemin est réellement mis en cache plutôt que contourné et voyez en quoi la clé de cache varie.

  4. 4

    Comparez la demande du warmer à une vraie demande

    Si le warmer envoie un cookie, un en-tête ou un agent utilisateur que les visiteurs ne font pas, il se peut qu'il remplisse une variante de cache que personne ne demande.

  5. 5

    Consultez la liste d'URL froides de Cache Health.

    Il identifie exactement quelles URL sont concernées, ce qui révèle généralement le modèle. Voir Santé du cache.

Le diagnostic le plus utile

Demandez vous-même la même URL deux fois avec curl et comparez les horaires et les en-têtes de cache. Si votre propre deuxième requête n'est pas non plus plus rapide, le problème vient définitivement de votre configuration de mise en cache plutôt que de Cache Rocket.

Vérifiez manuellement le timing et les en-têtes de cache
bash
curl -s -o /dev/null -w "%{time_total}s\n" https://www.example.com/
curl -s -o /dev/null -w "%{time_total}s\n" https://www.example.com/

curl -sI https://www.example.com/ | grep -i "cache\|age\|set-cookie"

Problèmes d'intégration

Un webhook de déploiement renvoie 401.
Les clés API sont erronées, expirées ou remplacées. Confirmez que les noms d'en-tête sont exactement X-Public-Key et X-Secret-Key, et vérifiez les valeurs tronquées. Voir Clés API.
Un webhook de déploiement réussit mais rien ne se réchauffe.
Le hostname dans le corps ne correspond pas à un warmer actif. Vérifiez le hostname exact incluant le www, et que le warmer est actif.
Une purge CDN est rejetée.
Le jeton ne dispose pas de l'autorisation de purge ou est associé à un ID de zone incorrect. Voir Intégrations CDN.
Le plugin WordPress indique que les clés ne sont pas valides.
Recopiez les deux clés en surveillant les espaces. Si une nouvelle paire a été générée depuis, l'ancienne ne fonctionne plus.
Les alertes n'arrivent jamais.
Testez l'URL du webhook directement avec curl. Confirmez qu'au moins un événement est sélectionné et que l'intégration Slack ou Discord existe toujours.

Toujours bloqué ?

Rassemblez-les avant de contacter l’assistance – cela transforme un long échange en une seule réponse :

  • Le nom warmer et le hostname concernés.
  • Ce à quoi vous vous attendiez et ce qui s'est réellement passé.
  • Codes d'état représentatifs et temps de chargement de la page de résultats du warmer.
  • Si le hostname affiche Vérifié.
  • Le nom de votre forfait et votre identifiant d'abonnement dans la section Références de la page d'abonnement.