Snelle probleemoplossing

Gebruik de volgende informatie om de Fastly CDN module voor Magento 2 in uw Adobe Commerce op het projectmilieu's van de wolkeninfrastructuur problemen op te lossen en te beheren. U kunt bijvoorbeeld de headerwaarden van reacties en het gedrag van caching onderzoeken om problemen met services en prestaties snel op te lossen.

In Pro-productie- en staging-omgevingen kunt u New Relic-logboeken om snel CDN en het logboekgegevens van WAF te bekijken en te analyseren om fouten en prestatiesproblemen op te lossen.

NOTE
Voor informatie over vestiging en het vormen van Fastly, zie Snel instellen.

Service-id snel zoeken

U hebt de snelste service-id nodig om snel vanaf de beheerder te configureren of snel API-aanvragen voor geavanceerde snelle configuratie en probleemoplossing in te dienen.

Als Fastly in uw projectmilieu wordt toegelaten, kunt u de dienstidentiteitskaart van Admin krijgen. Zie Snelle gebruikersgegevens ophalen.

De ontwikkelaars en de gevorderde gebruikers VCL kunnen douane VCL gebruiken om de dienst identiteitskaart terug te winnen gebruikend de Snelle variabele req.service_id. U kunt bijvoorbeeld de opdracht req.service_id aan de richtlijn van het douaneregistreren in uw VCL om de waarde van de dienstidentiteitskaart te vangen:

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

U kunt dezelfde VCL gebruiken voor productie- en testomgevingen. Zie Hoe te om vcl_log te vormen.

Problemen met de prestaties, leegmaken en cache van de site

Gebruik de volgende lijst om problemen met betrekking tot de Fastly-serviceconfiguratie voor uw Adobe Commerce in de cloud-infrastructuur te identificeren en op te lossen.

  • Opslagmenu wordt niet weergegeven of werkt niet—U kunt een koppeling of tijdelijke koppeling rechtstreeks naar de oorspronkelijke server gebruiken in plaats van de URL van de livesite, of u hebt -H "host:URL" in een cURL, opdracht. Als u Fastly naar de oorspronkelijke server overslaat, werkt het hoofdmenu niet en worden onjuiste kopteksten weergegeven die caching op de browserzijde toestaan.

  • De bovenste navigatie werkt niet—De bovenste navigatie is afhankelijk van de verwerking van Edge Side Includes (ESI) die is ingeschakeld wanneer u de standaard VCL-fragmenten voor snel Magento uploadt. Als de navigatie niet werkt, Upload de Fastly VCL en controleer de site opnieuw.

  • Geo-location/GeoIP werkt niet— De standaard VCL-fragmenten voor snel Magento voegen de landcode toe aan de URL. Als de landcode niet werkt, Upload de Fastly VCL en controleer de site opnieuw.

  • Pagina's worden niet in cache geplaatst—Standaard worden bij Snelheid geen pagina's in het cachegeheugen opgeslagen met de opdracht Set-Cookies header. Adobe Commerce stelt cookies zelfs in op cacheable pages (TTL > 0). Met het standaard Magento VCL worden deze cookies op pagina's die in een cache kunnen worden geplaatst, snel verwijderd. Als pagina's niet in cache worden geplaatst, Upload de Fastly VCL en controleer de site opnieuw.

    Deze kwestie kan ook voorkomen als een paginablok in een malplaatje uncacheable duidelijk is. In dat geval, wordt het probleem zeer waarschijnlijk veroorzaakt door een derdemodule of een uitbreiding die de kopballen van Adobe Commerce blokkeren of verwijderen. Ga voor een oplossing van het probleem naar X-cache bevat alleen MISS, geen HIT.

  • Aanvragen voor opschonen zijn mislukt—Hiermee wordt snel de volgende fout geretourneerd wanneer u een verwijderingsverzoek indient:

    code language-text
    The purge request was not processed successfully.
    

    Dit probleem kan worden veroorzaakt door een van de volgende problemen:

    • Ongeldige Fastly geloofsbrieven in de Fastly de dienstconfiguratie voor de Adobe Commerce op het projectmilieu van de wolkeninfrastructuur
    • Ongeldige code in een aangepast VCL-fragment

    Ga voor een oplossing van het probleem naar Fout bij snel leegmaken van cache in cloud in het Adobe Commerce Help Center.

503 fouten van snel

Als er snel 503 time-outfouten worden geretourneerd, controleert u de foutlogboeken en de 503-foutpagina om de hoofdoorzaak te identificeren.

NOTE
Als de time-out optreedt bij het uitvoeren van bulkbewerkingen, kunt u De snelste time-out voor de beheerder verlengen.

Als u een fout 503 ontvangt, controleer het van de de milieufout van de Productie of het Staging milieu en php toegangslogboek om de kwestie problemen op te lossen.

De foutenlogboeken controleren:

  • Foutlogboek

    code language-text
    /var/log/platform/<project-ID>/error.log
    

    Dit logbestand bevat eventuele fouten van de toepassing of de PHP-engine, bijvoorbeeld memory_limit of max_execution_time exceeded fouten. Als u geen Fastly verwante fouten vindt, controleer het PHP toegangslogboek.

  • PHP-toegangslogboek

    code language-text
    /var/log/platform/<project-ID>/php.access.log
    

    Zoek in het logbestand naar HTTP 200-reacties op de URL die de fout 503 heeft geretourneerd. Als u het antwoord van 200 vindt, betekent dit dat Adobe Commerce de pagina zonder fouten heeft geretourneerd. Dit geeft aan dat de kwestie mogelijk is opgetreden na het interval dat groter is dan de first_byte_timeout waarde die in de Fastly de dienstconfiguratie wordt geplaatst.

Wanneer er een fout van 503 optreedt, wordt de reden snel geretourneerd op de fout- en onderhoudspagina. Mogelijk kunt u de reden niet zien als u code voor een aangepaste reactiepagina. Als u de redencode op de standaardfoutpagina wilt weergeven, kunt u de HTML-code voor de aangepaste foutpagina verwijderen.

De foutpagina Fastly 503 controleren:

  1. Aanmelden aan de beheerder.

  2. Klikken Winkels > Instellingen > Configuratie > Geavanceerd > Systeem.

  3. Vouw in het rechterdeelvenster uit Volledige paginacache.

  4. In de Snelle configuratie sectie, uitvouwen Aangepaste synthetische pagina's zoals het volgende cijfer toont.

    Aangepaste foutpagina 503

  5. Klikken HTML instellen.

  6. Verwijder de aangepaste code. U kunt de sjabloon opslaan in een tekstprogramma en deze later weer toevoegen.

  7. Klikken Uploaden om uw updates snel te verzenden.

  8. Klikken Config opslaan boven aan de pagina.

  9. Open de URL die de fout 503 heeft veroorzaakt. Retourneert snel een foutpagina met de reden zoals in het volgende voorbeeld wordt getoond.

    Fout: snel

Apex- en subdomeinen die al zijn gekoppeld aan een snelaccount

Als het apex-domein en de subdomeinen voor uw Adobe Commerce on cloud-infrastructuurproject al zijn gekoppeld aan een bestaand Fastly-account met een toegewezen Service-id, kunt u pas starten wanneer u de Fastly-configuratie bijwerkt:

Verifieer of zuivert de Snelle diensten

U kunt problemen met de prestaties of caching oplossen voor een Adobe Commerce op een cloudinfrastructuursite door site-URL's te testen en de headerwaarden te bekijken die in het antwoord worden geretourneerd.

Live site snel controleren

Gebruik de snelheids-API om de Fastly-Magento-VCL-Uploaded en X-Cache antwoordheaders die zijn geretourneerd van uw livesite.

Snelle API-aanvragen worden doorgegeven via de snelheidsuitbreiding om een antwoord te krijgen van uw oorspronkelijke servers. Als de reactie onjuiste kopballen terugkeert, test oorspronkelijke servers rechtstreeks.

De antwoordheaders controleren:

  1. Gebruik in een terminal het volgende curl opdracht om de URL van uw livesite te testen:

    code language-bash
    curl https://<live URL> -vo /dev/null -H Fastly-Debug:1
    

    Als u geen statische route hebt geplaatst of de DNS configuratie voor de domeinen op uw levende plaats voltooid, gebruik --resolve markering, die DNS naamresolutie overslaat.

    code language-bash
    curl -svo /dev/null --resolve '<your_hostname>:443:<IP-address-of-cache-node>' <https-URL>
    
    note note
    NOTE
    Deze opdracht gebruiken met de opdracht --resolve hebt, moet u TLS hebben ingeschakeld met Fastly via een SSL/TLS-certificaat en het IP-adres van het cacheknooppunt zoeken.
  2. Controleer in de reactie de koppen om ervoor te zorgen dat Fastly werkt. De volgende unieke kopteksten worden weergegeven in het antwoord:

    code language-http
    < Fastly-Magento-VCL-Uploaded: yes
    < X-Cache: HIT, MISS
    

Zie de volgende informatie als de kopteksten niet de juiste waarden hebben:

Snelcache omzeilen om Adobe Commerce-sites te controleren

Als de Fastly dienst onjuiste kopballen terugkeert, kunt u een fragment tot stand brengen VCL dat u toestaat om verzoeken te verzenden die de Fastly geheime voorgeheugen overslaan. Zie Snelcache omzeilen.

Nadat u het VCL-fragment hebt toegevoegd, gebruikt u cURL-opdrachten om vanaf het opgegeven IP-adres aanvragen bij de oorspronkelijke server in te dienen. Controleer vervolgens de reacties op fouten.

HIT- en MISS-responsheaders voor cache controleren

Controleer of de geretourneerde reactie de volgende informatie bevat:

  • Met de X-Magento-Tags header

  • De waarde van Fastly-Module-Enabled header is Yes of het versieaantal van de Fastly voor Magento 2 CDN module die in het projectmilieu wordt geïnstalleerd

  • Cache-control: max-age is groter dan 0

  • Pragma instellen is cache

In het volgende fragment uit de uitvoer van de opdracht cURL worden de juiste waarden voor de opdracht Pragma, X-Magento-Tags, en Fastly-Module-Enabled kopteksten:

* 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
NOTE
Voor gedetailleerde informatie over treffers en missen raadpleegt u Begrijpen van de kopballen van het geheime voorgeheugen HIT en van MISS met beschermde diensten in de Fastly documentatie.

Fouten in responsheaders oplossen

Deze sectie bevat suggesties voor het oplossen van fouten die worden geretourneerd wanneer responsheaders worden gecontroleerd met de snelheids-API.

Module Snelheid is niet ingeschakeld

Als de module Snelheid niet is ingeschakeld (Fastly-Module-Enabled: no) of als de koptekst ontbreekt, SSH gebruiken om u aan te melden aan het project. Voer vervolgens de volgende opdracht uit om de status van de module te controleren.

php bin/magento module:status Fastly_Cdn

Gebaseerd op de teruggekeerde status, gebruik de volgende instructies om de Fastly configuratie bij te werken.

  • Module does not exist—Als de module niet bestaat installeren en configureren de Fastly CDN Module voor Magento 2 in een integratietak. Nadat de installatie is voltooid, schakelt u de module in en configureert u deze. Zie Snel instellen.

  • Module is disabled—Als de module Snelheid is uitgeschakeld, werkt u de omgevingsconfiguratie bij op een integration vertakken in uw lokale omgeving om deze in te schakelen. Druk vervolgens op de wijzigingen in Staging en Production. Zie Extensies beheren.

    Als u Configuratiebeheercontroleert u de status van de Fastly CDN-module in het dialoogvenster app/etc/config.php configuratiebestand voordat u wijzigingen aanbrengt in de omgeving Productie of Staging.

    Als de module niet is ingeschakeld (Fastly_CDN => 0) in de config.php bestand, verwijder het bestand en voer de volgende opdracht uit om bij te werken config.php met de meest recente configuratie-instellingen.

    code language-bash
    bin/magento magento-cloud:scd-dump
    

VCL is niet snel geüpload

Als de Fastly VCL niet is geüpload (Fastly-Magento-VCL-Uploaded: false), de VCL uploaden in Admin om het te uploaden. Zie VCL-fragmenten snel uploaden.

X-cache bevat alleen MISS, geen HIT

Als de X-Cache header contains HIT (HIT, HIT of HIT, MISS), geeft dit aan dat de inhoud in de cache snel wordt geretourneerd.

Als de X-Cache header is MISS, MISS en bevat niet HIT, voert u de curl opnieuw gebruiken om ervoor te zorgen dat de pagina niet onlangs uit het geheime voorgeheugen werd leeggemaakt.

Als u hetzelfde resultaat krijgt, gebruikt u de opdracht curl opdrachten en verifieert de antwoordheaders:

  • Pragma is cache
  • X-Magento-Tags exists
  • Cache-Control: max-age is groter dan 0

Als het probleem zich blijft voordoen, worden deze headers waarschijnlijk opnieuw ingesteld door een andere extensie. Herhaal de volgende procedure in de het Staging milieu door alle uitbreidingen onbruikbaar te maken en elk opnieuw toe te laten om te bepalen welke uitbreiding de kopballen opnieuw instelt. Nadat u de extensie hebt geïdentificeerd die het probleem veroorzaakt, moet u deze uitschakelen in de productieomgeving.

Zo identificeert u extensies die de antwoordheaders opnieuw instellen:

  1. Aanmelden aan de beheerder.

  2. Navigeren naar Winkels > Instellingen > Configuratie > Geavanceerd > Geavanceerd.

  3. In de Uitvoer van modules uitschakelen in het rechterdeelvenster, zoekt u alle extensies en schakelt u deze uit.

  4. Klikken Config opslaan.

  5. Klikken Systeem > Gereedschappen > Cachebeheer.

  6. Klikken Cache van Magento leegmaken.

  7. Voer de volgende stappen uit voor elke extensie die mogelijk problemen veroorzaakt met snelkopteksten:

    Herhaal dit proces voor elke extensie. Als de headers voor snelle reactie niet meer worden weergegeven, hebt u de extensie geïdentificeerd die problemen met Snelheid veroorzaakt.

Nadat u de extensie hebt geïdentificeerd die de sneltoetsen opnieuw instelt, neemt u contact op met de ontwikkelaar van de extensie voor verdere ondersteuning. We kunnen geen correcties of updates opgeven om extensies van derden te laten werken met snel cachegeheugen.

Snelconfiguratie terugdraaien

Als een Adobe Commerce op een cloudinframsite fouten onderbreekt of retourneert in aangepaste VCL-fragmentupdates of andere snelle configuratiewijzigingen, gebruikt u de snelheids-API activate gebruiken om terug te gaan naar een eerdere VCL-versie. U kunt de VCL-versie niet terugdraaien vanuit de beheerfunctie.

De VCL-versie terugdraaien:

  1. Om een lijst van de beschikbare versies VCL voor de dienst te krijgen, stel het volgende bevel in werking

    code language-bash
    curl -H "Fastly-Key: <FASTLY_API_TOKEN>" -H "Accept: application/json" https://api.fastly.com/service/<FASTLY_SERVICE_ID>/version
    
  2. Voer de volgende opdracht uit om de actieve VCL-versie te wijzigen in een opgegeven versie.

    code language-bash
    curl -H "Fastly-Key: <FASTLY_API_TOKEN>" -H "Content-Type: application/x-www-form-urlencoded" -H "Accept: application/json" -X PUT https://api.fastly.com/service/<FASTLY_SERVICE_ID>/version/<VERSION_ID>/activate
    

Ga voor meer informatie over het gebruik van de snelheids-API voor het controleren en beheren van VCL naar VCL beheren met de API.

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26