Schnelle Fehlerbehebung

Verwenden Sie die folgenden Informationen, um das Fastly CDN-Modul für Magento 2 in Ihrer Adobe Commerce in Cloud-Infrastruktur-Projektumgebungen zu beheben und zu verwalten. Sie können beispielsweise die Werte der Antwortheader und das Cache-Verhalten untersuchen, um Probleme mit dem schnellen Service und der Leistung zu beheben.

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

Fastly Service ID suchen

Sie benötigen die Fastly-Dienst-ID, um eine schnelle Konfiguration über den Administrator durchzuführen oder um Fastly-API-Anfragen für erweiterte schnelle Konfiguration und Fehlerbehebung zu senden.

Wenn Fastly in Ihrer Projektumgebung aktiviert ist, können Sie die Dienst-ID vom Admin abrufen. Siehe Schnelle Anmeldeinformationen abrufen.

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

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

Sie können denselben VCL für Produktions- und Staging-Umgebungen verwenden. Siehe Konfigurieren von vcl_log.

Probleme mit der Site-Leistung, -Bereinigung und -Cache

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

503 Fehler von Fastly

Wenn Fastly 503-Timeout-Fehler 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 können Sie den Grund nicht sehen, wenn Sie Code für eine benutzerdefinierte Antwortseite hinzugefügt haben. Um den Grund-Code auf der Standardfehlerseite anzuzeigen, können Sie den HTML-Code für die benutzerdefinierte Fehlerseite entfernen.

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

Apex und Subdomänen, die bereits mit einem Fastly-Konto verknüpft sind

Wenn die Apex-Domäne und die Subdomänen für Ihr Adobe Commerce on Cloud-Infrastrukturprojekt bereits mit einem vorhandenen Fastly-Konto mit einer zugewiesenen Service-ID verknüpft sind, können Sie erst starten, nachdem Sie Ihre Schnelle Konfiguration aktualisiert haben:

Überprüfen oder Debuggen von Fastly-Diensten

Sie können Leistungs- oder Zwischenspeicherungsprobleme für eine Adobe Commerce auf der Cloud-Infrastruktur-Site beheben, indem Sie die Site-URLs testen und die in der Antwort zurückgegebenen Kopfzeilenwerte untersuchen.

Schnellere Überprüfung der Live-Site

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

Schnelle API-Anfragen werden über die Fastly-Erweiterung übergeben, um eine Antwort von Ihren Ursprungs-Servern zu erhalten. Wenn die Antwort falsche Header zurückgibt, testen Sie die Herkunftsserver direkt.

Überprüfen der Antwortheader:

Wenn die Header nicht über die richtigen Werte verfügen, finden Sie weitere Informationen unter:

Umgehen des schnellen Cache, um Adobe Commerce-Sites zu überprüfen

Wenn der Fastly-Dienst falsche Header zurückgibt, können Sie einen VCL-Snippet erstellen, mit dem Sie Anforderungen senden können, die den Fastly-Cache umgehen. Siehe Schnellen Cache umgehen.

Nachdem Sie das VCL-Snippet hinzugefügt haben, verwenden Sie cURL-Befehle, um Anforderungen von der angegebenen IP-Adresse an den Ausgangsserver zu senden. Überprüfen Sie dann die Antworten auf Fehler.

Überprüfen der Cache-HIT- und MISS-Antwortheader

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

Der folgende Ausschnitt aus der Ausgabe des cURL-Befehls zeigt die richtigen Werte für die Header Pragma, X-Magento-Tags und 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

Beheben von Fehlern in Antwortheadern

Dieser Abschnitt enthält Vorschläge zur Behebung von Fehlern, die beim Überprüfen von Antwortheadern mit der Fastly-API zurückgegeben werden.

Fastly-Modul ist nicht aktiviert

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

php bin/magento module:status Fastly_Cdn

Verwenden Sie je nach zurückgegebenem Status die folgenden Anweisungen, um die Konfiguration Fastly zu aktualisieren.

Fast VCL wurde nicht hochgeladen

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

X-Cache enthält nur MISS, keinen HIT

Wenn die Kopfzeile X-Cache HIT (HIT, HIT oder HIT, MISS) enthält, deutet dies darauf hin, dass der zwischengespeicherte Inhalt schnell erfolgreich zurückgegeben wird.

Wenn die Kopfzeile X-Cache den Wert MISS, MISS aufweist und nicht den Wert HIT enthält, führen Sie den Befehl curl erneut aus, um sicherzustellen, dass die Seite nicht vor Kurzem aus dem Cache gelöscht wurde.

Wenn Sie dasselbe Ergebnis erhalten, verwenden Sie die curl Befehle und überprüfen Sie die Antwortheader:

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

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

Nachdem Sie die Erweiterung identifiziert haben, die Fastly-Header zurücksetzt, wenden Sie sich für weitere Unterstützung an den Entwickler der Erweiterung. Wir können keine Fehlerbehebungen oder Aktualisierungen bereitstellen, damit Erweiterungen von Drittanbietern mit dem Fastly-Caching funktionieren.

Schnelle Rollback-Konfiguration

Wenn benutzerspezifische VCL-Snippet-Aktualisierungen oder andere Fastly-Konfigurationsänderungen dazu führen, dass eine Adobe Commerce auf der Cloud-Infrastruktur-Site Fehler beschädigt oder zurückgibt, verwenden Sie den Befehl "Fastly API activate", 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 zum Überprüfen und Verwalten von VCL finden Sie unter Verwalten von VCL mithilfe der API.