Résolution rapide des problèmes

Utilisez les informations suivantes pour résoudre les problèmes et gérer le module Fastly CDN pour Magento 2 dans vos environnements de projet d’infrastructure cloud Adobe Commerce. Par exemple, vous pouvez examiner les valeurs d’en-tête de réponse et le comportement de mise en cache pour résoudre les problèmes de service et de performances Fastly.

Dans les environnements de production et d’évaluation Pro, vous pouvez utiliser les journaux New Relic pour afficher et analyser les données des journaux Fastly CDN et WAF afin de résoudre les erreurs et les problèmes de performances.

Localisation de l’ID de service Fastly

Vous avez besoin de l’identifiant du service Fastly pour configurer Fastly à partir de l’administration ou pour envoyer des requêtes d’API Fastly pour une configuration et un dépannage Fastly avancés.

Si Fastly est activé dans votre environnement de projet, vous pouvez obtenir l’ID de service auprès de l’administrateur. Voir Obtention des informations d’identification Fastly.

Les développeurs et les utilisateurs avancés de VCL peuvent utiliser un VCL personnalisé pour récupérer l’ID de service à l’aide de la variable Fastly req.service_id. Par exemple, vous pouvez ajouter le req.service_id à la directive de journalisation personnalisée dans votre VCL pour capturer la valeur de l’ID de service :

log {"syslog"} req.service_id {" my_logging_endpoint_name :: "}

Vous pouvez utiliser le même VCL pour les environnements de production et d’évaluation. Voir vcl_log dans la documentation Fastly.

Problèmes de performances, de purge et de mise en cache du site

Utilisez la liste suivante pour identifier et résoudre les problèmes liés à la configuration de service Fastly pour votre environnement Adobe Commerce sur une infrastructure cloud.

Erreurs 503 de Fastly

Si Fastly renvoie des erreurs de délai d’expiration 503, vérifiez les journaux d’erreurs et la page d’erreur 503 pour identifier la cause première.

Si vous recevez une erreur 503, vérifiez le journal des erreurs de l’environnement de production ou d’évaluation et le journal d’accès php pour résoudre le problème.

Pour vérifier les journaux d’erreurs :

Lorsqu’une erreur 503 se produit, Fastly renvoie la raison sur la page d’erreur et de maintenance. Il se peut que vous ne puissiez pas en voir la raison si vous avez ajouté du code pour une page de réponse personnalisée. Pour afficher le code de motif sur la page d’erreur par défaut, vous pouvez supprimer le code d’HTML de la page d’erreur personnalisée.

Pour vérifier la page d’erreur Fastly 503 :

Apex et sous-domaines déjà associés à un compte Fastly

Si le domaine apex et les sous-domaines de votre projet d’infrastructure cloud Adobe Commerce sont déjà associés à un compte Fastly existant avec un ID de service attribué, vous ne pouvez pas lancer tant que vous n’avez pas mis à jour votre configuration Fastly :

Vérification ou débogage des services Fastly

Vous pouvez résoudre les problèmes de performances ou de mise en cache d’un site Adobe Commerce sur une infrastructure cloud en testant les URL du site et en examinant les valeurs d’en-tête renvoyées dans la réponse.

Vérifier le site en direct via Fastly

Utilisez l’API Fastly pour vérifier les en-têtes de réponse Fastly-Magento-VCL-Uploaded et X-Cache renvoyés par votre site en ligne.

Les requêtes d’API Fastly sont transmises par l’intermédiaire de l’extension Fastly pour obtenir une réponse de vos serveurs d’origine. Si la réponse renvoie des en-têtes incorrects, testez directement les serveurs origin.

Pour vérifier les en-têtes de réponse :

Si les en-têtes n’ont pas les valeurs correctes, consultez les informations suivantes :

Contournement du cache Fastly pour vérifier les sites Adobe Commerce

Si le service Fastly renvoie des en-têtes incorrects, vous pouvez créer un fragment de code VCL qui vous permet d’envoyer des requêtes qui contournent le cache Fastly. Voir Contournement du cache Fastly.

Après avoir ajouté le fragment de code VCL, utilisez les commandes cURL pour envoyer des requêtes au serveur d’origine à partir de l’adresse IP spécifiée. Vérifiez ensuite les réponses pour détecter les erreurs.

Vérifier les en-têtes de réponse d’accès au cache et d’absence

Vérifiez que la réponse renvoyée contient les informations suivantes :

L’extrait suivant de la sortie de la commande cURL affiche les valeurs correctes pour les en-têtes Pragma, X-Magento-Tags et Fastly-Module-Enabled :

* STATE: INIT => CONNECT handle 0x600057800; line 1402 (connection #-5000)
* Rebuilt URL to: https://www.mymagento.biz.c.sv7gVom4qrpek.ent.magento.cloud/
* Added connection 0. The cache now contains 1 members
* Trying 192.0.2.31...
* STATE: CONNECT => WAITCONNECT handle 0x600057800; line 1455 (connection #0)

% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0* Connected to www.mymagento.biz.c.sv7gVom4qrpek.ent.magento.cloud (54.229.163.31) port 443 (#0)

* STATE: WAITCONNECT => SENDPROTOCONNECT handle 0x600057800; line 1562 (connection #0)
  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0* ALPN, offering h2

... portion omitted for brevity ...

< Set-Cookie: mage-messages=%5B%5D; expires=Wed, 22-Nov-2017 17:39:58 GMT; Max-Age=31536000; path=/
< Pragma: cache
< Expires: Wed, 23 Nov 2016 17:39:56 GMT
< Cache-Control: max-age=86400, public, s-maxage=86400, stale-if-error=5, stale-while-revalidate=5
< X-Magento-Tags: cb_welcome_popup store cb cb_store_info_mobile cb_header_promotional_bar cb_store_info cb_discount-promo-bar cpg_2 cb_83 cb_81 cb_84 cb_85 cb_86 cb_87 cb_88 cb_89 p5646 catalog_product p5915 p6040 p6197 p6227 p7095 p6109 p6122 p6331 p7592 p7651 p7690
< Fastly-Module-Enabled: yes
< Strict-Transport-Security: max-age=31536000
    < Content-Security-Policy: upgrade-insecure-requests
    < X-Content-Type-Options: nosniff
    < X-XSS-Protection: 1; mode=block
    < X-Frame-Options: SAMEORIGIN
    < X-Platform-Server: i-dff64b52
    <
    * STATE: PERFORM => DONE handle 0x600057800; line 1955 (connection #0)
    * multi_done
      0     0    0     0    0     0      0      0 --:--:--  0:00:02 --:--:--     0
    * Connection #0 to host www.mymagento.biz.c.sv7gVom4qrpek.ent.magento.cloud left intact

Résoudre les erreurs trouvées dans les en-têtes de réponse

Cette section fournit des suggestions pour résoudre les erreurs renvoyées lors de la vérification des en-têtes de réponse à l’aide de l’API Fastly.

Le module Fastly n’est pas activé

Si le module Fastly n’est pas activé (Fastly-Module-Enabled: no) ou si l’en-tête est manquant, utilisez SSH pour vous connecter au projet. Exécutez ensuite la commande suivante pour vérifier le statut du module.

php bin/magento module:status Fastly_Cdn

En fonction du statut renvoyé, utilisez les instructions suivantes pour mettre à jour la configuration Fastly .

Fastly VCL n’a pas été chargé

Si le Fastly VCL n’a pas été chargé (Fastly-Magento-VCL-Uploaded : false), utilisez l’option Télécharger VCL dans l’Administration pour le charger. Voir Chargement rapide de fragments de code VCL.

X-Cache contient uniquement MISS, pas d’ACCÈS.

Si l’en-tête X-Cache contient des HIT (HIT, HIT ou HIT, MISS), cela indique que Fastly renvoie correctement le contenu mis en cache.

Si l’en-tête X-Cache est MISS, MISS et ne contient pas de HIT, exécutez à nouveau la commande curl pour vous assurer que la page n’a pas été récemment purgée du cache.

Si vous obtenez le même résultat, utilisez les commandes curl et vérifiezen-têtes de réponse 🔗 :

Si le problème persiste, une autre extension réinitialise probablement ces en-têtes. Répétez la procédure suivante dans l’environnement d’évaluation en désactivant toutes les extensions et en réactivant chacune d’elles pour déterminer l’extension qui réinitialise les en-têtes. Après avoir identifié l’extension à l’origine du problème, vous devez la désactiver dans l’environnement de production.

Pour identifier une extension qui réinitialise les en-têtes de réponse :

Après avoir identifié l’extension qui réinitialise les en-têtes Fastly, contactez le développeur d’extensions pour obtenir une assistance supplémentaire. Nous ne pouvons pas fournir de correctifs ou de mises à jour pour que les extensions tierces fonctionnent avec la mise en cache Fastly.

Restaurer rapidement la configuration

Si des mises à jour de fragments de code VCL personnalisés ou d'autres modifications de configuration Fastly entraînent une panne ou le renvoi d'erreurs par un site d'infrastructure cloud d'Adobe Commerce, utilisez la commande Fastly API activate pour restaurer une version antérieure de VCL. Vous ne pouvez pas restaurer la version VCL à partir de l'administrateur.

Pour restaurer la version VCL :

Pour plus d’informations sur l’utilisation de l’API Fastly pour examiner et gérer le VCL, voir Gérer le VCL à l’aide de l’API.