Documentatie Commerce Handleiding Commerce on Cloud Infrastructure

Snelle probleemoplossing

Last update: Tue Nov 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Onderwerpen:
Cloud
Configuratie
Cache

Gemaakt voor:

Beheerder
Ontwikkelaar

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.

Op ProProductie en het Staging milieu's, kunt u logboeken van New Relicgebruiken om snel CDN en het logboekgegevens van WAF te bekijken en te analyseren om fouten en prestatiesproblemen problemen op te lossen.

NOTE

Voor informatie over vestiging en het vormen van Fastly, zie Opstelling Fastly.

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 krijgen de Snelle geloofsbrieven.

Ontwikkelaars en gevorderde VCL-gebruikers kunnen aangepaste VCL gebruiken om de service-id op te halen met behulp van de snelvariabele req.service_id . U kunt bijvoorbeeld de instructie req.service_id toevoegen aan de aangepaste logboekinstructie in uw VCL om de waarde van de service-id vast te leggen:

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

U kunt dezelfde VCL gebruiken voor productie- en testomgevingen. Zie vcl_login de Snelle Documentatie.

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.

het menu van de Opslag toont of werkt niet - u zou een verbinding of een tijdelijke verbinding rechtstreeks aan de oorsprongserver in plaats van het gebruiken van levende plaats URL kunnen gebruiken, of u gebruikte -H "host:URL" in het bevel van a cURL. Als u Fastly naar de oorspronkelijke server overslaat, werkt het hoofdmenu niet en worden onjuiste kopteksten weergegeven die caching op de browserzijde toestaan.
De hoogste navigatie werkt niet - de hoogste navigatie baseert zich op de Zijde van Edge omvat (ESI) verwerking die wordt toegelaten wanneer u het standaardMagento snel VCL fragmenten uploadt. Als de navigatie niet werkt, uploadt de Fastly VCLen controleert de plaats opnieuw.
Geo-location/GeoIP werkt niet - de fragmenten VCL van het standaardMagento voegen de landcode aan URL snel toe. Als de landcode niet werkt, uploadt de Fastly VCLen controleert de plaats opnieuw.
de Pagina's zijn niet caching - door gebrek, leidt de Fastly geen pagina's met de Set-Cookies kopbal in het voorgeheugen op. 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 de pagina's niet in het voorgeheugen onderbrengen, uploadt de Fastly VCLen controleert de plaats 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. Om de kwestie op te lossen, zie x-Geheime voorgeheugen slechts MISS, geen HITbevat.

zuivert verzoeken ontbreken - keert snel de volgende fout terug wanneer u een zuiveringsverzoek voorlegt:

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

Om de kwestie op te lossen, zie Fout die het geheime voorgeheugen van de Fout op Cloudin het Centrum van de Hulp van Adobe Commerce leegmaakt.

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 onderbreking wanneer het runnen van bulkverrichtingen voorkomt, kunt u de Snelle onderbreking voor Adminuitbreiden.

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.

om de foutenlogboeken te controleren:

Foutlogboek

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

Dit logbestand bevat eventuele fouten van de toepassing of 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 de first_byte_timeout -waarde overschrijdt die is ingesteld in de Fastly-serviceconfiguratie.

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

om de Fastly 503 foutenpagina te controleren:

Loginaan Admin.
Klik Slaat op > Montages > Configuratie > Geavanceerd > Systeem.
In de juiste ruit, breid Volledig Geheime voorgeheugen van de Pagina uit.
In de Snelle sectie van de Configuratie, breid de Synthetische Pagina's van de Douane uit aangezien het volgende cijfer toont.
Klik Vastgestelde HTML.
Verwijder de aangepaste code. U kunt de sjabloon opslaan in een tekstprogramma en deze later weer toevoegen.
Klik uploaden om uw updates naar Fastly te verzenden.
Klik sparen Config bij de bovenkant van de pagina.
Open de URL die de fout 503 heeft veroorzaakt. Retourneert snel een foutpagina met de reden zoals in het volgende voorbeeld wordt getoond.

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:

Werk de apex- en subdomeinconfiguratie bij op de bestaande Fastly-account. Zie Veelvoudige Snelle rekeningen en toegewezen domeinen.
laat en vormt sneltoe en voltooit de DNS configuratie

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 te controleren die door uw livesite worden geretourneerd.

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

om de reactiekopballen te controleren:

Gebruik in een terminal de 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 de --resolve vlag, 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
Als u deze opdracht met de optie `--resolve` wilt gebruiken, moet u TLS hebben ingeschakeld met Fastly via een SSL/TLS-certificaat en moet u het IP-adres van het cacheknooppunt zoeken.

In de reactie, verifieer de kopballenom ervoor te zorgen dat de 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:

VCL-upload controleren
X-cache bevat alleen MISS, geen HIT

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 snel geheime voorgeheugen van de Bekeerling.

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:

Bevat de header X-Magento-Tags
De waarde van de header Fastly-Module-Enabled is Yes of het versienummer van de module Fastly voor CDN Magento 2 die in de projectomgeving is geïnstalleerd
cache-Controle: max-ageis groter dan 0
Pragmahet plaatsen is cache

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

* 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 klappen en missen, zie Begrip van de kopballen van het geheime voorgeheugen HIT en van MISS met de beschermde dienstenin 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 Fastly module niet (Fastly-Module-Enabled: no) wordt toegelaten of als de kopbal mist, gebruik SSH aan loginaan 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 installeer en vormde FastlyCDN Module voor Magento 2 in een integratietak. Nadat de installatie is voltooid, schakelt u de module in en configureert u deze. Zie Opstelling snel.

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

Als u Beheer van de Configuratiegebruikt, controleer de Fastly CDN modulestatus in het app/etc/config.php configuratiedossier alvorens u veranderingen in de Productie of het Opvoeren milieu duwt.

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

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

VCL is niet snel geüpload

Als Fastly VCL niet is geupload (Fastly-Magento-VCL-Uploaded: false), gebruik uploadt VCL optie in Admin om het te uploaden. Zie snel VCL fragmentenuploaden.

X-cache bevat alleen MISS, geen HIT

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

Als de X-Cache header MISS, MISS is en niet HIT bevat, voert u de opdracht curl opnieuw uit om ervoor te zorgen dat de pagina niet onlangs uit de cache is verwijderd.

Als u het zelfde resultaat krijgt, gebruik curl bevelenen verifieer de reactiekopballen:

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.

om een uitbreidingen te identificeren die reactiekopballen terugstelt:

Loginaan Admin.
Navigeer aan Slaat > Montages > Configuratie > Geavanceerd > Geavanceerd.
In maak de sectie van de Output van Modules in de juiste ruit onbruikbaar, vind elk van uw uitbreidingen en maak hen onbruikbaar.
Klik sparen Config.
Klik Systeem > Hulpmiddelen > het Beheer van het Geheime voorgeheugen.
Klik het Geheime voorgeheugen van het Magento van de Duw.
Voer de volgende stappen uit voor elke extensie die mogelijk problemen veroorzaakt met snelkopteksten:
- Schakel één extensie tegelijk in, sla de configuratie op en verwijder de Adobe Commerce-cache.
- Voer de curl bevelenin werking om de reactiekopballente verifiëren.
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 de de fragmentupdates van douaneVCL of andere Fastly configuratieveranderingen een Adobe Commerce op de plaats van de wolkeninfrastructuur veroorzaken om fouten te breken of terug te keren, gebruik snel API activeerbevel om terug naar een vroegere versie terug te rollen VCL. U kunt de VCL-versie niet terugdraaien vanuit de beheerfunctie.

om terug versie te rollen VCL:

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`

Voer de volgende opdracht uit om de actieve VCL-versie te wijzigen in een opgegeven versie.

code language-bash

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`

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

Voor details over het gebruiken van Fastly API om VCL te herzien en te beheren, zie VCL beheren gebruikend API.

recommendation-more-help

05f2f56e-ac5d-4931-8cdb-764e60e16f26