文件Commerce雲端基礎結構上的 Commerce 指南

Fastly疑難排解

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • undefined
  • undefined

使用以下資訊來疑難排解和管理雲端基礎結構專案環境中Adobe Commerce中用於Magento2的Fastly CDN模組。 例如，您可以調查回應標頭值和快取行為來解決Fastly服務和效能問題。

在Pro生產和測試環境中，您可以使用New Relic記錄來檢視和分析Fastly CDN和WAF記錄資料，以疑難排解錯誤和效能問題。

NOTE
如需有關設定和設定Fastly的資訊，請參閱設定Fastly。

找到Fastly服務ID

您需要Fastly服務ID才能從管理員設定Fastly，或提交Fastly API請求以進行進階Fastly設定和疑難排解。

如果您的專案環境中啟用了Fastly，則可以從管理員那裡取得服務ID。 檢視取得Fastly認證。

開發人員和進階VCL使用者可以使用自訂VCL來使用Fastly變數req.service_id擷取服務ID。 例如，您可以將req.service_id新增至VCL中的自訂記錄指示詞，以擷取服務ID值：

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

您可以在生產和測試環境中使用相同的VCL。 請參閱如何設定vcl_log。

網站效能、清除和快取問題

使用以下清單來識別和疑難排解與雲端基礎結構環境中Adobe Commerce的Fastly服務設定相關的問題。

  • 存放區功能表未顯示或未運作 — 您可能是使用直接連至原始伺服器的連結或暫時連結，而非使用即時網站URL，或您在cURL命令中使用-H "host:URL"。 如果您略過Fastly前往原始伺服器，主功能表將無法運作，且顯示的標頭不正確，導致瀏覽器端無法快取。

  • 上層導覽無法運作 — 上層導覽仰賴Edge Side Include (ESI)處理，此處理會在您上傳預設MagentoFastly VCL程式碼片段時啟用。 如果導覽無法運作，請上傳Fastly VCL並重新檢查網站。

  • 地理位置/GeoIP無法運作 — 預設MagentoFastly VCL片段會將國家/地區代碼附加至URL。 如果國家/地區代碼無法運作，請上傳Fastly VCL並重新檢查網站。

  • 頁面未快取 — 依預設，Fastly不會快取具有Set-Cookies標頭的頁面。 Adobe Commerce甚至會在可快取的頁面上設定Cookie (TTL > 0)。 預設MagentoFastly VCL會移除可快取頁面上的這些Cookie。 如果頁面未快取，請上傳Fastly VCL並重新檢查網站。

    如果範本中的頁面區塊標示為無法快取，也會發生此問題。 在這種情況下，問題很可能是因為協力廠商模組或擴充功能封鎖或移除Adobe Commerce標頭所造成。 若要解決此問題，請參閱X-Cache只包含MISS，沒有HIT。

  • 清除請求失敗 — 當您提交清除請求時，Fastly會傳回下列錯誤：

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

    此問題可能是由以下任一問題造成：

    • 雲端基礎結構專案環境上Adobe Commerce的Fastly服務設定中有無效的Fastly認證
    • 自訂VCL程式碼片段中的程式碼無效

    若要解決此問題，請參閱Adobe Commerce說明中心的清除Cloud上的Fastly快取時發生錯誤。

來自Fastly的503錯誤

如果Fastly傳回503逾時錯誤，請檢查錯誤記錄檔和503錯誤頁面以找出根本原因。

NOTE
如果執行大量作業時發生逾時，您可以延長Admin的Fastly逾時。

如果您收到503錯誤，請檢視生產或中繼環境錯誤記錄檔和php存取記錄檔，以疑難排解問題。

若要檢查錯誤記錄檔：

  • 錯誤記錄

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

    此記錄檔包含來自應用程式或PHP引擎的任何錯誤，例如memory_limit或max_execution_time exceeded錯誤。 如果找不到任何Fastly相關錯誤，請檢查PHP存取記錄。

  • PHP存取記錄

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

    在記錄中搜尋傳回503錯誤之URL的HTTP 200回應。 如果您找到200回應，表示Adobe Commerce未傳回錯誤頁面。 這表示問題可能發生在Fastly服務設定中設定的間隔超過first_byte_timeout值之後。

發生503錯誤時，Fastly會在錯誤和維護頁面上傳回原因。 如果您為自訂回應頁面新增程式碼，可能無法檢視原因。 若要在預設錯誤頁面上檢視原因代碼，您可以移除自訂錯誤頁面的HTML代碼。

若要檢視Fastly 503錯誤頁面：

  1. 登入管理員。

  2. 按一下​ 商店 > 設定 > 組態 > 進階 > 系統。

  3. 在右窗格中，展開​ 完整頁面快取。

  4. 在​ Fastly組態 ​區段中，展開​ 自訂合成頁面，如下圖所示。

    自訂503錯誤頁面

  5. 按一下​ 設定HTML。

  6. 移除自訂程式碼。 您可以將它儲存在文字程式中以便稍後再新增。

  7. 按一下​ 上傳 ​將您的更新傳送給Fastly。

  8. 按一下頁面頂端的「儲存設定」。

  9. 重新開啟造成503錯誤的URL。 Fastly傳回錯誤頁面，其原因如以下範例所示。

    Fastly錯誤

Apex和子網域已與Fastly帳戶相關聯

如果雲端基礎結構專案中Adobe Commerce的頂點網域和子網域已與一個指派的服務ID相關聯的現有Fastly帳戶，您必須更新Fastly設定才能啟動：

驗證或偵錯Fastly服務

您可以測試網站URL並檢查回應中傳回的標頭值，藉此疑難排解雲端基礎結構網站上Adobe Commerce的效能或快取問題。

透過Fastly檢查即時網站

使用Fastly API檢查從您的即時網站傳回的Fastly-Magento-VCL-Uploaded和X-Cache回應標題。

Fastly API請求會透過Fastly擴充功能傳遞，以從原始伺服器取得回應。 如果回應傳回不正確的標頭，請直接測試原始伺服器。

若要檢查回應標頭：

  1. 在終端機中，使用下列curl命令測試您的即時網站URL：

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

    如果您尚未設定靜態路由或完成線上站台上網域的DNS設定，請使用繞過DNS名稱解析的--resolve旗標。

    code language-bash 
    curl -svo /dev/null --resolve '<your_hostname>:443:<IP-address-of-cache-node>' <https-URL>
    note note
    NOTE
    若要搭配--resolve選項使用此命令，您必須透過SSL/TLS憑證啟用Fastly的TLS，並尋找快取節點的IP位址。

  2. 在回應中，驗證標頭以確保Fastly正常運作。 您應該會在回應中看到下列不重複標題：

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

如果標題的值不正確，請參閱下列資訊：

略過Fastly快取以檢查Adobe Commerce網站

如果Fastly服務傳回錯誤的標頭，您可以建立VCL程式碼片段，讓您提交繞過Fastly快取的請求。 請參閱略過快速快取。

新增VCL程式碼片段後，請使用cURL命令從指定的IP位址將請求提交至原始伺服器。 然後，檢查回應是否有錯誤。

檢查快取命中和未命中的回應標題

確認傳回的回應包含下列資訊：

  • 包含X-Magento-Tags標頭

  • Fastly-Module-Enabled標頭的值為Yes或專案環境中安裝的CDNMagento2模組的Fastly版本號碼

  • Cache-Control： max-age大於0

  • Pragma設定為cache

以下cURL命令輸出摘錄顯示Pragma、X-Magento-Tags和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
NOTE
如需有關點選和遺漏的詳細資訊，請參閱Fastly檔案中的瞭解具有遮蔽服務的快取HIT和MISS標頭。

解決在回應標頭中發現的錯誤

本節提供解決使用Fastly API檢查回應標頭時傳回的錯誤的建議。

Fastly模組未啟用

如果未啟用Fastly模組(Fastly-Module-Enabled: no)或標頭遺失，請使用SSH登入專案。 然後，執行下列命令以檢查模組狀態。

php bin/magento module:status Fastly_Cdn

根據傳回的狀態，使用以下指示來更新Fastly設定。

  • Module does not exist — 如果模組不存在，請安裝和設定整合分支中Magento2的Fastly CDN模組。 安裝完成後，請啟用並設定模組。 檢視設定Fastly。

  • Module is disabled — 如果Fastly模組已停用，請更新您本機環境中integration分支上的環境設定以啟用它。 然後，將變更推送到「測試」和「生產」。 請參閱管理擴充功能。

    如果您使用組態管理，請先檢查app/etc/config.php組態檔中的Fastly CDN模組狀態，然後再將變更推送至生產或中繼環境。

    如果未在config.php檔案中啟用模組(Fastly_CDN => 0)，請刪除檔案並執行以下命令，以最新的組態設定來更新config.php。

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

Fastly VCL尚未上傳

如果Fastly VCL尚未上傳(Fastly-Magento-VCL-Uploaded： false)，請使用Admin中的​ 上傳VCL ​選項進行上傳。 請參閱上傳Fastly VCL片段。

X-Cache只包含MISS，沒有HIT

如果X-Cache標頭包含HIT （HIT, HIT或HIT, MISS），則表示Fastly已成功傳回快取的內容。

如果X-Cache標頭為MISS, MISS且未包含HIT，請再次執行curl命令以確定該頁面最近未從快取中清除。

如果您取得相同的結果，請使用curl命令並驗證回應標頭：

  • Pragma是cache
  • X-Magento-Tags已存在
  • Cache-Control: max-age大於0

如果問題仍然存在，其他擴充功能可能會重設這些標題。 在中繼環境中重複下列程式，方法是停用所有擴充功能並重新啟用每個擴充功能，以決定要重設標題的擴充功能。 識別導致問題的擴充功能後，您必須在生產環境中將其停用。

識別重設回應標頭的擴充功能：

  1. 登入管理員。

  2. 瀏覽至​ 商店 > 設定 > 設定 > 進階 > 進階。

  3. 在右窗格的​ 停用模組輸出 ​區段中，尋找並停用所有擴充功能。

  4. 按一下​ 儲存設定。

  5. 按一下​ 系統 > 工具 > 快取管理。

  6. 按一下​ 排清Magento快取。

  7. 對每個擴充功能完成以下步驟，可能會導致Fastly標題問題：

    • 一次啟用一個擴充功能、儲存設定，然後排清Adobe Commerce快取。

    • 執行curl命令以驗證回應標頭。

    對每個擴充功能重複此程式。 如果Fastly回應標題不再顯示，表示您已識別造成Fastly問題的擴充功能。

在您識別正在重設Fastly標題的擴充功能後，請聯絡擴充功能開發人員以取得其他協助。 我們無法提供修正或更新，讓協力廠商擴充功能可搭配Fastly快取運作。

復原Fastly設定

如果自訂VCL程式碼片段更新或其他Fastly設定變更導致雲端基礎結構網站上的Adobe Commerce中斷或傳回錯誤，請使用Fastly API 啟用命令復原到較早的VCL版本。 您無法從「管理員」回覆VCL版本。

要回覆VCL版本：

  1. 若要取得服務的可用VCL版本清單，請執行以下命令

    code language-bash 
    curl -H "Fastly-Key: <FASTLY_API_TOKEN>" -H "Accept: application/json" https://api.fastly.com/service/<FASTLY_SERVICE_ID>/version

  2. 執行下列指令，將作用中的VCL版本變更為指定的版本。

    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

如需使用Fastly API來檢閱和管理VCL的詳細資訊，請參閱使用API管理VCL。

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