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 zur Ansicht und Analyse von Schnellsten CDN- und WAF-Protokolldaten zur Fehlerbehebung und zur Behebung von Leistungsproblemen.

NOTE
Informationen zum Einrichten und Konfigurieren von Fastly finden Sie unter Schnelles Einrichten.

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 Schnelles Abrufen von Anmeldedaten.

Entwickler und fortgeschrittene VCL-Benutzer können benutzerdefinierte VCL verwenden, um die Dienst-ID mithilfe der Fastly-Variablen abzurufen. req.service_id. Sie können beispielsweise die req.service_id zur benutzerdefinierten Protokollierungsrichtlinie in Ihrer VCL hinzu, 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 So konfigurieren Sie 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.

  • Store-Menü wird nicht angezeigt oder funktioniert nicht- Sie können einen Link oder einen temporären Link direkt zum Herkunftsserver verwenden, anstatt die Live-Site-URL zu verwenden, oder Sie haben -H "host:URL" in einer cURL, Befehl. Wenn Sie die Option Schnell zum Herkunftsserver umgehen, funktioniert das Hauptmenü nicht und falsche Kopfzeilen werden angezeigt, die das Zwischenspeichern auf der Browserseite zulassen.

  • Obere Navigation funktioniert nicht—Die obere Navigationsleiste basiert auf der ESI-Verarbeitung (Edge Side Includes), die beim Hochladen der standardmäßigen Magento Fastly VCL-Snippets aktiviert ist. Wenn die Navigation nicht funktioniert, Fastly VCL hochladen und überprüfen Sie die Site erneut.

  • Geolokation/GeoIP funktioniert nicht— Die standardmäßigen Magento Fastly VCL-Snippets hängen den Ländercode an die URL an. Wenn der Ländercode nicht funktioniert, Fastly VCL hochladen und überprüfen Sie die Site erneut.

  • Seiten werden nicht zwischengespeichert—Standardmäßig speichert Fastly keine Seiten mit dem Set-Cookies -Kopfzeile. Adobe Commerce setzt Cookies auch auf zwischenspeicherbaren Seiten (TTL > 0). Die standardmäßige Magento Fastly VCL entfernt diese Cookies auf zwischenspeicherbaren Seiten. Wenn Seiten nicht zwischengespeichert werden, Fastly VCL hochladen und überprüfen Sie die Site erneut.

    Dieses Problem kann auch auftreten, wenn ein Seitenblock in einer Vorlage als unerreichbar markiert ist. In diesem Fall wird das Problem höchstwahrscheinlich durch ein Drittanbietermodul oder eine Erweiterung verursacht, die die Adobe Commerce-Kopfzeilen blockiert oder entfernt. Informationen zum Beheben des Problems finden Sie unter X-Cache enthält nur MISS, keinen HIT.

  • Löschanfragen schlagen fehl—Schnell gibt den folgenden Fehler zurück, wenn Sie eine Bereinigungsanforderung senden:

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

    Dieses Problem kann durch eines der folgenden Probleme verursacht werden:

    • Ungültige Fastly-Anmeldeinformationen in der Fastly-Dienstkonfiguration für Adobe Commerce in der Cloud-Infrastruktur-Projektumgebung
    • Ungültiger Code in einem benutzerdefinierten VCL-Snippet

    Informationen zum Beheben des Problems finden Sie unter Fehler beim Bereinigen des schnellen Cache in Cloud im Adobe Commerce Help Center.

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.

NOTE
Wenn die Zeitüberschreitung beim Ausführen von Massenvorgängen auftritt, können Sie Schnelles Timeout für den Administrator erweitern.

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:

  • Fehlerprotokoll

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

    Dieses Protokoll enthält beispielsweise Fehler der Anwendung oder der PHP-Engine memory_limit oder max_execution_time exceeded Fehler. Wenn Sie keine Fastly-bezogenen Fehler finden, überprüfen Sie das PHP-Zugriffsprotokoll.

  • PHP-Zugriffsprotokoll

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

    Suchen Sie im Protokoll nach HTTP-200-Antworten nach der URL, die den 503-Fehler zurückgegeben hat. Wenn Sie die Antwort "200"finden, bedeutet dies, dass Adobe Commerce die Seite ohne Fehler zurückgegeben hat. Dies weist darauf hin, dass das Problem möglicherweise nach dem Intervall aufgetreten ist, das die first_byte_timeout -Wert, der in der Konfiguration des Fastly-Dienstes festgelegt ist.

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. 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:

  1. Anmelden an den Administrator.

  2. Klicks Stores > Einstellungen > Konfiguration > Erweitert > System.

  3. Erweitern Sie im rechten Bereich Vollständiger Seiten-Cache.

  4. Im Schnelle Konfiguration Abschnitt erweitern Benutzerdefinierte Synthetische Seiten wie in der folgenden Abbildung dargestellt.

    Benutzerdefinierte Fehlerseite 503

  5. Klicks HTML festlegen.

  6. Entfernen Sie den benutzerspezifischen Code. Sie können sie in einem Textprogramm speichern, um sie später erneut hinzuzufügen.

  7. Klicks Hochladen um Ihre Updates an Fastly zu senden.

  8. Klicks Konfiguration speichern oben auf der Seite.

  9. Öffnen Sie die URL, die den 503-Fehler verursacht hat, erneut. Gibt schnell eine Fehlerseite mit dem Grund zurück, wie im folgenden Beispiel gezeigt.

    Schneller Fehler

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 Fastly-Magento-VCL-Uploaded und X-Cache Antwort-Header, 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 Ursprungs-Server direkt.

Überprüfen der Antwortheader:

  1. Verwenden Sie in einem Terminal Folgendes: curl -Befehl zum Testen Ihrer Live-Site-URL:

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

    Wenn Sie keine statische Route festgelegt oder die DNS-Konfiguration für die Domänen auf Ihrer Live-Site abgeschlossen haben, verwenden Sie die --resolve -Markierung, die die DNS-Namensauflösung umgeht.

    code language-bash
    curl -svo /dev/null --resolve '<your_hostname>:443:<IP-address-of-cache-node>' <https-URL>
    
    note note
    NOTE
    So verwenden Sie diesen Befehl mit --resolve müssen Sie TLS mit Fastly über ein SSL-/TLS-Zertifikat aktiviert haben und die IP-Adresse des Cache-Knotens suchen.
  2. Überprüfen Sie in der Antwort die Kopfzeilen um sicherzustellen, dass Fastly funktioniert. Folgende eindeutige Header sollten in der Antwort angezeigt werden:

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

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:

  • Umfasst die X-Magento-Tags header

  • Der Wert der Fastly-Module-Enabled -Kopfzeile ist entweder Yes oder die Versionsnummer des Fastly for CDN Magento 2-Moduls, das in der Projektumgebung installiert ist

  • Cache-Control: max-age größer als 0

  • Pragma Einstellung ist cache

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
NOTE
Detaillierte Informationen zu Treffern und Fehlern finden Sie unter Grundlegendes zu Cache-HIT- und MISS-Headern mit abgeschirmten Diensten in der Fastly-Dokumentation.

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 wenn die Kopfzeile fehlt, SSH zur Anmeldung verwenden zum Projekt hinzu. 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.

  • Module does not exist—Wenn das Modul nicht vorhanden ist Installieren und Konfigurieren das Fastly CDN Module für Magento 2 in einer Integrationsverzweigung. Nach Abschluss der Installation aktivieren und konfigurieren Sie das Modul. Siehe Schnelles Einrichten.

  • Module is disabled—Wenn das Fastly-Modul deaktiviert ist, aktualisieren Sie die Umgebungskonfiguration auf einem integration -Verzweigung in Ihrer lokalen Umgebung verwenden, um sie zu aktivieren. Übertragen Sie dann die Änderungen auf Staging und Produktion. Siehe Erweiterungen verwalten.

    Wenn Sie Konfigurationsverwaltung, überprüfen Sie den Status des Fastly CDN-Moduls im app/etc/config.php Konfigurationsdatei vor dem Pushen von Änderungen an die Produktions- oder Staging-Umgebung.

    Wenn das Modul nicht aktiviert ist (Fastly_CDN => 0) in der config.php Datei, löschen Sie die Datei und führen Sie den folgenden Befehl aus, um die Datei zu aktualisieren config.php mit den neuesten Konfigurationseinstellungen.

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

Fast VCL wurde nicht hochgeladen

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

X-Cache enthält nur MISS, keinen HIT

Wenn die Variable X-Cache header contains HIT (HIT, HIT oder HIT, MISS), weist es darauf hin, dass der zwischengespeicherte Inhalt schnell erfolgreich zurückgegeben wird.

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

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

  • Pragma is cache
  • X-Magento-Tags exists
  • Cache-Control: max-age größer als 0

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 Erweiterungen, die Antwortheader zurücksetzen:

  1. Anmelden an den Administrator.

  2. Navigieren Sie zu Stores > Einstellungen > Konfiguration > Erweitert > Erweitert.

  3. Im Modulausgabe deaktivieren im rechten Bereich finden Sie alle Ihre Erweiterungen und deaktivieren Sie sie.

  4. Klicks Konfiguration speichern.

  5. Klicks System > Instrumente > Cacheverwaltung.

  6. Klicks Magento-Cache leeren.

  7. Führen Sie die folgenden Schritte für jede Erweiterung aus, die möglicherweise Probleme mit Fastly-Kopfzeilen verursacht:

    • Aktivieren Sie jeweils eine Erweiterung, speichern Sie die Konfiguration und leeren Sie den Adobe Commerce-Cache.

    • Führen Sie die curl commands zur Überprüfung der Antwortheader.

    Wiederholen Sie diesen Vorgang für jede Erweiterung. Wenn die Header für schnelle Antworten nicht mehr angezeigt werden, haben Sie die Erweiterung identifiziert, die Probleme mit Fastly verursacht.

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 benutzerdefinierte VCL-Snippet-Aktualisierungen oder andere schnelle Konfigurationsänderungen dazu führen, dass eine Adobe Commerce auf der Cloud-Infrastruktur-Site Fehler beschädigt oder zurückgibt, verwenden Sie die Fastly-API Aktivieren -Befehl, 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:

  1. Um eine Liste der verfügbaren VCL-Versionen für einen Dienst zu erhalten, führen Sie den folgenden Befehl aus

    code language-bash
    curl -H "Fastly-Key: <FASTLY_API_TOKEN>" -H "Accept: application/json" https://api.fastly.com/service/<FASTLY_SERVICE_ID>/version
    
  2. Führen Sie den folgenden Befehl aus, um die aktive VCL-Version in eine angegebene Version zu ändern.

    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
    

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

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