Risoluzione rapida dei problemi

Utilizza le seguenti informazioni per risolvere i problemi e gestire il modulo Fastly CDN per il Magento 2 nell’ambiente di progetto Adobe Commerce on Cloud Infrastructure. Ad esempio, puoi analizzare i valori delle intestazioni di risposta e il comportamento di caching per risolvere i problemi di servizio e prestazioni Fastly.

Negli ambienti di produzione e staging di Pro è possibile utilizzare registri New Relic per visualizzare e analizzare i dati di registro Fastly CDN e WAF per la risoluzione di errori e problemi di prestazioni.

Individua ID servizio Fastly

È necessario l’ID servizio Fastly per configurare Fastly dall’amministratore o per inviare richieste API Fastly per la configurazione e la risoluzione dei problemi Fastly avanzati.

Se Fastly è abilitato nell’ambiente del progetto, puoi ottenere l’ID servizio dall’Amministratore. Vedi Ottieni credenziali rapide.

Gli sviluppatori e gli utenti VCL avanzati possono utilizzare VCL personalizzato per recuperare l'ID servizio utilizzando la variabile Fastly req.service_id. Ad esempio, puoi aggiungere req.service_id alla direttiva di registrazione personalizzata nel file VCL per acquisire il valore dell'ID servizio:

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

È possibile utilizzare lo stesso VCL per gli ambienti di produzione e staging. Vedi Come configurare vcl_log.

Problemi relativi a prestazioni del sito, eliminazione e cache

Utilizza il seguente elenco per identificare e risolvere i problemi relativi alla configurazione del servizio Fastly per l’ambiente Adobe Commerce sull’infrastruttura cloud.

503 errori di Fastly

Se Fastly restituisce errori di timeout 503, controllare i registri di errore e la pagina di errore 503 per identificare la causa principale.

Se ricevi un errore 503, controlla il registro degli errori dell’ambiente di produzione o di staging e il registro di accesso php per risolvere il problema.

Per controllare i registri errori:

Quando si verifica un errore 503, Fastly restituisce il motivo nella pagina di errore e manutenzione. Potresti non essere in grado di visualizzare il motivo se hai aggiunto il codice per una pagina di risposta personalizzata. Per visualizzare il codice motivo nella pagina di errore predefinita, è possibile rimuovere il codice HTML per la pagina di errore personalizzata.

Per controllare la pagina di errore Fastly 503:

Apex e sottodomini già associati a un account Fastly

Se il dominio e i sottodomini APEX per il progetto di infrastruttura cloud Adobe Commerce on sono già associati a un account Fastly esistente con un ID servizio assegnato, non puoi avviarli finché non aggiorni la configurazione Fastly:

Verificare o eseguire il debug dei servizi Fastly

Puoi risolvere i problemi di prestazioni o caching per un sito Adobe Commerce sull’infrastruttura cloud testando gli URL del sito ed esaminando i valori di intestazione restituiti nella risposta.

Controlla il sito live tramite Fastly

Utilizza l'API Fastly per controllare le intestazioni di risposta Fastly-Magento-VCL-Uploaded e X-Cache restituite dal tuo sito live.

Le richieste API Fastly vengono trasmesse tramite l’estensione Fastly per ottenere una risposta dai server di origine. Se la risposta restituisce intestazioni non corrette, verificare direttamente i server di origine.

Per controllare le intestazioni di risposta:

Se i valori delle intestazioni non sono corretti, consulta le seguenti informazioni:

Ignora Fastly Cache per controllare i siti Adobe Commerce

Se il servizio Fastly restituisce intestazioni non corrette, puoi creare uno snippet VCL che consente di inviare richieste ignorando la cache Fastly. Vedere Ignora Fastly Cache.

Dopo aver aggiunto lo snippet VCL, utilizzare i comandi cURL per inviare le richieste al server di origine dall'indirizzo IP specificato. Quindi, controlla le risposte per individuare eventuali errori.

Controllare le intestazioni di risposta cache HIT e MISS

Verifica che la risposta restituita contenga le seguenti informazioni:

L'estratto seguente dell'output del comando cURL mostra i valori corretti per le intestazioni Pragma, X-Magento-Tags e 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

Risolvi gli errori rilevati nelle intestazioni di risposta

Questa sezione fornisce suggerimenti per la risoluzione degli errori restituiti durante il controllo delle intestazioni di risposta tramite l’API Fastly.

Il modulo Fastly non è abilitato

Se il modulo Fastly non è abilitato (Fastly-Module-Enabled: no) o se manca l'intestazione, utilizzare SSH per accedere al progetto. Quindi, esegui il seguente comando per controllare lo stato del modulo.

php bin/magento module:status Fastly_Cdn

In base allo stato restituito, utilizza le istruzioni seguenti per aggiornare la configurazione Fastly.

VCL Fastly non è stato caricato

Se il file VCL Fastly non è stato caricato (Fastly-Magento-VCL-Uploaded: false), utilizzare l'opzione Carica VCL nell'amministratore per caricarlo. Consulta Caricare frammenti VCL Fastly.

X-Cache contiene solo mancanti, nessun HIT

Se l'intestazione X-Cache contiene HIT (HIT, HIT o HIT, MISS), indica che Fastly restituisce correttamente il contenuto memorizzato nella cache.

Se l'intestazione X-Cache è MISS, MISS e non contiene HIT, eseguire nuovamente il comando curl per assicurarsi che la pagina non sia stata eliminata di recente dalla cache.

Se ottieni lo stesso risultato, utilizza i curl comandi e verifica le intestazioni di risposta:

Se il problema persiste, è probabile che un’altra estensione ripristini queste intestazioni. Ripeti la procedura seguente nell’ambiente di staging disabilitando tutte le estensioni e riabilitando ciascuna per determinare quale estensione sta reimpostando le intestazioni. Dopo aver identificato l’estensione che causa il problema, devi disabilitarla nell’ambiente di produzione.

Per identificare un'estensione che ripristina le intestazioni di risposta:

Dopo aver identificato l’estensione che sta reimpostando le intestazioni Fastly, contatta lo sviluppatore di estensioni per ulteriore assistenza. Non è possibile fornire correzioni o aggiornamenti per far funzionare le estensioni di terze parti con il caching Fastly.

Rollback della configurazione Fastly

Se gli aggiornamenti personalizzati del frammento di codice VCL o altre modifiche alla configurazione Fastly causano l'interruzione o la restituzione di errori in un sito di infrastruttura cloud di Adobe Commerce, utilizza il comando Fastly API activate per tornare a una versione VCL precedente. Non è possibile eseguire il rollback della versione VCL dall'amministratore.

Per eseguire il rollback della versione VCL:

Per informazioni dettagliate sull'utilizzo dell'API Fastly per rivedere e gestire VCL, vedere Gestire VCL utilizzando l'API.