Snabbt felsökning

Använd följande information för att felsöka och hantera snabbuppdateringsmodulen för CDN för Magento 2 i dina Adobe Commerce i miljöer med molninfrastrukturprojekt. Du kan till exempel undersöka svarshuvudets värden och cachningsbeteendet för att lösa problem med snabb service och prestanda.

I Pro Production- och Staging-miljöer kan du använda New Relic-loggar för att visa och analysera snabbdata för CDN och WAF-loggdata för att felsöka fel och prestandaproblem.

Hitta snabbt tjänst-ID

Du behöver ett snabb service-ID för att konfigurera snabbt från administratören eller för att skicka in snabba API-begäranden för avancerad snabb konfiguration och felsökning.

Om Snabbt är aktiverat i din projektmiljö kan du hämta service-ID:t från administratören. Se Få snabbt inloggningsuppgifter.

Utvecklare och avancerade VCL-användare kan använda anpassad VCL för att hämta tjänst-ID:t med hjälp av snabbvariabeln req.service_id. Du kan till exempel lägga till req.service_id i det anpassade loggningsdirektivet i din VCL för att hämta service-ID-värdet:

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

Du kan använda samma VCL för produktions- och mellanlagringsmiljöer. Se Konfigurera vcl_log.

Problem med webbplatsprestanda, rensning och cache

Använd följande lista för att identifiera och felsöka problem som rör Snabb tjänstkonfiguration för din Adobe Commerce i molninfrastrukturmiljö.

503 fel från Snabb

Om du snabbt returnerar 503 timeout-fel kontrollerar du felloggarna och felsidan 503 för att identifiera rotorsaken.

Om du får ett 503-fel bör du kontrollera felloggen för produktions- eller mellanlagringsmiljön och PHP-åtkomstloggen för att felsöka problemet.

Kontrollera felloggarna:

När ett 503-fel inträffar returnerar Snabb orsaken på fel- och underhållssidan. Du kanske inte kan se orsaken om du har lagt till kod för en anpassad svarssida. Om du vill visa orsakskoden på standardfelsidan kan du ta bort HTML-koden för den anpassade felsidan.

Så här kontrollerar du snabbt felsidan för 503:

Apex och underdomäner som redan är kopplade till ett Fast-konto

Om API-domänen och underdomänerna för ditt Adobe Commerce i ett molninfrastrukturprojekt redan är kopplade till ett befintligt Fast-konto med ett tilldelat tjänst-ID, kan du inte starta förrän du uppdaterar din snabbkonfiguration:

Verifiera eller felsök snabbt tjänster

Du kan felsöka prestanda- eller cachelagringsproblem för en Adobe Commerce på en molninfrastrukturwebbplats genom att testa webbplatsens URL:er och undersöka de rubrikvärden som returneras i svaret.

Kontrollera publicerad webbplats snabbt

Använd API:t Snabbt för att kontrollera de Fastly-Magento-VCL-Uploaded- och X-Cache-svarshuvuden som returneras från din aktiva webbplats.

API-begäranden skickas snabbt via tillägget Fast för att få svar från era ursprungliga servrar. Om svaret returnerar felaktiga huvuden testar du origin-servrarna direkt.

Så här kontrollerar du svarsrubrikerna:

Om rubrikerna inte har rätt värden kan du läsa följande information:

Hoppa över snabbcachelagring för att kontrollera Adobe Commerce webbplatser

Om snabbtjänsten returnerar felaktiga rubriker kan du skapa ett VCL-kodfragment som gör att du kan skicka begäranden som kringgår snabbcachen. Se Kringgå snabbcache.

När du har lagt till VCL-fragmentet använder du cURL-kommandon för att skicka begäranden till den ursprungliga servern från den angivna IP-adressen. Kontrollera sedan om svaren innehåller fel.

Kontrollera headers för HIT- och MISS-svar i cache

Kontrollera att det returnerade svaret innehåller följande information:

Följande utdrag från utdata från cURL-kommandot visar korrekta värden för rubrikerna Pragma, X-Magento-Tags och 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

Åtgärda fel i svarshuvuden

I det här avsnittet ges förslag på hur du löser fel som returneras när du kontrollerar svarshuvuden med API:t Snabbt.

Modulen Snabbt är inte aktiverad

Om snabbmodulen inte är aktiverad (Fastly-Module-Enabled: no) eller om rubriken saknas använder du SSH för att logga in i projektet. Kör sedan följande kommando för att kontrollera modulens status.

php bin/magento module:status Fastly_Cdn

Baserat på den returnerade statusen kan du uppdatera snabbkonfigurationen med följande instruktioner.

Snabb VCL har inte överförts

Om Snabbt VCL inte har överförts (Fastly-Magento-VCL-Uploaded: false) använder du alternativet Överför VCL i Admin för att överföra den. Se Överför snabbt VCL-fragment.

X-Cache innehåller bara MISS, ingen HIT

Om rubriken X-Cache innehåller HIT (HIT, HIT eller HIT, MISS) anger det att det cachelagrade innehållet returneras snabbt.

Om rubriken X-Cache är MISS, MISS och inte innehåller HIT kör du kommandot curl igen för att kontrollera att sidan inte nyligen har rensats från cachen.

Om du får samma resultat kan du använda curl-kommandona och verifiera svarsrubrikerna:

Om problemet kvarstår är det troligt att ett annat tillägg återställer dessa rubriker. Upprepa följande procedur i mellanlagringsmiljön genom att inaktivera alla tillägg och aktivera om var och en för att avgöra vilket tillägg som återställer rubrikerna. När du har identifierat tillägget som orsakar problemet måste du inaktivera det i produktionsmiljön.

Identifiera tillägg som återställer svarshuvuden:

När du har identifierat det tillägg som återställer snabbrubriker kontaktar du tilläggsutvecklaren för ytterligare hjälp. Vi kan inte tillhandahålla korrigeringar eller uppdateringar för att få tillägg från tredje part att fungera med Snabb cachelagring.

Snabb återställning

Om uppdateringar av anpassade VCL-kodfragment eller andra snabbkonfigurationsändringar gör att fel bryts eller returneras på en Adobe Commerce på en molninfrastrukturwebbplats, använder du kommandot activate i snabbprogrammeringsgränssnittet för att återställa till en tidigare VCL-version. Du kan inte återställa VCL-versionen från administratören.

Så här återställer du VCL-versionen:

Mer information om hur du använder API:t Snabbt för att granska och hantera VCL finns i Hantera VCL med API:t.