Schnelle Fehlerbehebung

Verwenden Sie die folgenden Informationen, um das Fastly CDN-Modul für Magento 2 in Ihren Adobe Commerce in Cloud-Infrastrukturprojektumgebungen zu beheben und zu verwalten. Sie können beispielsweise die Werte der Antwort-Header und das Caching-Verhalten untersuchen, um Service- und Leistungsprobleme von Fastly zu beheben.

In Pro-Produktions- und Staging-Umgebungen können Sie New Relic-Protokolle verwenden, um Fastly CDN- und WAF-Protokolldaten anzuzeigen und zu analysieren, um Fehler und Leistungsprobleme zu beheben.

Fastly-Service-ID suchen

Sie benötigen die Fastly-Service-ID, um Fastly vom Administrator zu konfigurieren oder Fastly-API-Anfragen für erweiterte Fastly-Konfiguration und Fehlerbehebung zu senden.

Wenn Fastly in Ihrer Projektumgebung aktiviert ist, können Sie die Service-ID vom Administrator abrufen. Siehe Abrufen von Fastly-Anmeldeinformationen.

Entwickler und Benutzer mit erweiterter VCL können benutzerdefinierte VCL verwenden, um die Service-ID mithilfe der Fastly-Variablen-req.service_id abzurufen. Sie können beispielsweise die req.service_id zur benutzerdefinierten Protokollierungsanweisung in Ihrer VCL hinzufügen, um den Wert der Service-ID zu erfassen:

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

Sie können dieselbe VCL für Produktions- und Staging-Umgebungen verwenden. Siehe vcl_log in der Fastly-.

Probleme mit Site-Performance, Bereinigung und Cache

Verwenden Sie die folgende Liste, um Probleme im Zusammenhang mit der Fastly-Service-Konfiguration für Ihre Adobe Commerce in einer Cloud-Infrastrukturumgebung zu identifizieren und zu beheben.

503 Fehler von Fastly

Wenn Fastly 503 Zeitüberschreitungsfehler zurückgibt, überprüfen Sie die Fehlerprotokolle und die Fehlerseite 503, um die Grundursache zu identifizieren.

Wenn Sie einen 503-Fehler erhalten, überprüfen Sie das Fehlerprotokoll für die Produktions- oder Staging-Umgebung und das PHP-Zugriffsprotokoll, um das Problem zu beheben.

Überprüfen der Fehlerprotokolle:

Wenn ein 503-Fehler auftritt, gibt Fastly den Grund auf der Fehler- und Wartungsseite zurück. Möglicherweise wird der Grund nicht angezeigt, wenn Sie Code für eine benutzerdefinierte Antwortseite“. Um den Ursachen-Code auf der Standardfehlerseite anzuzeigen, können Sie den HTML-Code für die benutzerdefinierte Fehlerseite entfernen.

So überprüfen Sie die Fehlerseite von Fastly 503:

Apex und Subdomains, die bereits einem Fastly-Konto zugeordnet sind

Wenn die Apex-Domain und Subdomains für Ihr Adobe Commerce in Cloud-Infrastrukturprojekt bereits mit einem bestehenden Fastly-Konto mit zugewiesener Service-ID verknüpft sind, können Sie erst starten, wenn Sie Ihre Fastly-Konfiguration aktualisieren:

Fastly-Services überprüfen oder debuggen

Sie können Leistungs- oder Caching-Probleme für eine Adobe Commerce auf einer Cloud-Infrastruktur-Site beheben, indem Sie die Site-URLs testen und die in der Antwort zurückgegebenen Header-Werte überprüfen.

Live-Site über Fastly überprüfen

Verwenden Sie die Fastly-API, um die von Ihrer Live-Site zurückgegebenen Fastly-Magento-VCL-Uploaded- und X-Cache-Antwortkopfzeilen zu überprüfen.

Fastly API-Anfragen werden über die Fastly-Erweiterung weitergeleitet, um eine Antwort von Ihren Ursprungs-Servern zu erhalten. Wenn die Antwort falsche Kopfzeilen zurückgibt, testen Sie die ursprünglichen Server direkt.

Überprüfen der Antwort-Header:

Wenn die Kopfzeilen nicht die richtigen Werte aufweisen, lesen Sie die folgenden Informationen:

Umgehen des Fastly-Cache zur Überprüfung von Adobe Commerce-Sites

Wenn der Fastly-Service falsche Kopfzeilen zurückgibt, können Sie ein VCL-Fragment erstellen, mit dem Sie Anfragen senden können, die den Fastly-Cache umgehen. Siehe Umgehen des Fastly-Cache.

Nachdem Sie den VCL-Ausschnitt hinzugefügt haben, verwenden Sie cURL-Befehle, um von der angegebenen IP-Adresse aus Anfragen an den Ursprungs-Server zu senden. Überprüfen Sie dann die Antworten auf Fehler.

Überprüfen der Antwort-Header für Cache-Treffer und -Fehler

Stellen Sie sicher, dass die zurückgegebene Antwort die folgenden Informationen enthält:

Der folgende Auszug aus der cURL-Befehlsausgabe zeigt die richtigen Werte für die Pragma-, X-Magento-Tags- und Fastly-Module-Enabled-Kopfzeilen:

* 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

Beheben von Fehlern in Antwort-Headern

Dieser Abschnitt enthält Vorschläge zur Behebung von Fehlern, die beim Überprüfen von Antwort-Headern mithilfe der Fastly-API zurückgegeben wurden.

Fastly-Modul ist nicht aktiviert

Wenn das Fastly-Modul nicht aktiviert ist (Fastly-Module-Enabled: no) oder die Kopfzeile fehlt, verwenden Sie SSH, um sichProjekt anzumelden. Führen Sie dann den folgenden Befehl aus, um den Modulstatus zu überprüfen.

php bin/magento module:status Fastly_Cdn

Verwenden Sie basierend auf dem zurückgegebenen Status die folgenden Anweisungen, um die Fastly-Konfiguration zu aktualisieren.

Fastly VCL wurde nicht hochgeladen

Wenn die Fastly-VCL nicht hochgeladen wurde (Fastly-Magento-VCL-Uploaded: false), verwenden Sie die Option VCL hochladen in der Admin-Liste, um sie hochzuladen. Siehe Hochladen von Fastly VCL-Snippets.

X-Cache enthält nur MISS, kein HIT

Wenn die X-Cache-Kopfzeile HIT (HIT, HIT oder HIT, MISS) enthält, bedeutet dies, dass Fastly den zwischengespeicherten Inhalt erfolgreich zurückgibt.

Wenn die X-Cache-Kopfzeile MISS, MISS ist und keine HIT enthält, führen Sie den curl erneut aus, um sicherzustellen, dass die Seite nicht kürzlich aus dem Cache gelöscht wurde.

Wenn Sie dasselbe Ergebnis erhalten, verwenden Sie die curl Befehleüberprüfen Sie die Antwort-Header:

Wenn das Problem weiterhin besteht, wird diese Kopfzeile wahrscheinlich von einer anderen Erweiterung zurückgesetzt. Wiederholen Sie das folgende Verfahren in der Staging-Umgebung, indem Sie alle Erweiterungen deaktivieren und jede Erweiterung erneut aktivieren, um zu bestimmen, welche Erweiterung die Header zurücksetzt. Nachdem Sie die Erweiterung identifiziert haben, die das Problem verursacht, müssen Sie sie in der Produktionsumgebung deaktivieren.

So identifizieren Sie eine Erweiterung, die Antwortkopfzeilen zurücksetzt:

Nachdem Sie die Erweiterung identifiziert haben, die die Fastly-Kopfzeilen zurücksetzt, wenden Sie sich an den Entwickler der Erweiterung, um weitere Hilfe zu erhalten. Wir können keine Fehlerbehebungen oder Aktualisierungen bereitstellen, damit Erweiterungen von Drittanbietern mit der Fastly-Zwischenspeicherung funktionieren.

Rollback Fastly-Konfiguration

Wenn benutzerdefinierte VCL-Snippet-Aktualisierungen oder andere Fastly-Konfigurationsänderungen dazu führen, dass ein Adobe Commerce auf der Cloud-Infrastruktur-Site Fehler verursacht oder zurückgibt, verwenden Sie den Befehl Fastly API aktivieren, um zu einer früheren VCL-Version zurückzukehren. Sie können die VCL-Version nicht vom Administrator zurücksetzen.

Zurücksetzen der VCL-Version:

Weitere Informationen zur Verwendung der Fastly-API zur Überprüfung und Verwaltung von VCL finden Sie unter Verwalten von VCL mithilfe der API.