Dépannage rapide

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

Dans les environnements de production et d’évaluation Pro, vous pouvez utiliser les journaux New Relic pour afficher et analyser rapidement les données du journal 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 de service Fastly pour effectuer une configuration Fastly à partir de l’administrateur ou pour envoyer des demandes d’API Fastly pour une configuration et un dépannage rapides avancés.

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

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 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 Comment configurer vcl_log.

Problèmes de performances, de purge et de 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 d’infrastructure cloud Adobe Commerce.

503 erreurs de Fastly

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

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

Pour vérifier les journaux d’erreur :

Lorsqu’une erreur 503 se produit, la fonction renvoie rapidement la raison sur la page d’erreur et de maintenance. Vous ne pourrez peut-être pas voir la raison si vous avez ajouté du code pour une page de réponse personnalisée. Pour afficher le code de raison 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 et les sous-domaines apex de votre projet d’infrastructure cloud Adobe Commerce sont déjà associés à un compte Fastly existant avec un ID de service affecté, vous ne pouvez pas le lancer tant que vous n’avez pas mis à jour votre configuration Fastly :

Vérification ou débogage des services rapides

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

Archivage rapide du site

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 actif.

Les demandes d’API rapides sont transmises via l’extension Fastly afin d’obtenir une réponse de vos serveurs d’origine. Si la réponse renvoie des en-têtes incorrects, testez les serveurs d’origine directement.

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

Si les en-têtes ne comportent pas les valeurs correctes, reportez-vous aux informations suivantes :

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

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

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. Recherchez ensuite les erreurs dans les réponses.

Vérifier les en-têtes de réponse HIT et MISS du cache

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 détecté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 l’état du module.

php bin/magento module:status Fastly_Cdn

En fonction de l’état renvoyé, suivez les instructions suivantes pour mettre à jour la configuration Fastly.

Le fichier VCL Fastly n’a pas été chargé.

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

X-Cache contient uniquement MISS, aucun accès

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

Si l’en-tête X-Cache est MISS, MISS et ne contient pas 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 curl commandes et vérifiez les en-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 :

Une fois que vous avez identifié l’extension qui réinitialise les en-têtes Fastly, contactez le développeur de l’extension pour obtenir une aide supplémentaire. Nous ne pouvons pas fournir de correctifs ou de mises à jour pour que les extensions tierces fonctionnent avec une mise en cache rapide.

Restauration rapide de la configuration

Si des mises à jour de fragments de code VCL personnalisés ou d’autres modifications de configuration Fastly entraînent la rupture ou le renvoi d’erreurs d’une Adobe Commerce sur le site d’infrastructure cloud, 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 VCL, voir Gestion de VCL à l’aide de l’API.