Fastly のトラブルシューティング

以下の情報を使用して、クラウドインフラストラクチャプロジェクト環境のAdobe CommerceのMagento 2 用 Fastly CDN モジュールのトラブルシューティングと管理を行います。 例えば、応答ヘッダー値とキャッシュ動作を調査して、Fastly のサービスとパフォーマンスの問題を解決できます。

実稼動環境およびステージング環境では、を使用できます New Relic ログ fastly CDN および WAF ログデータを表示および分析して、エラーとパフォーマンスの問題のトラブルシューティングを行います。

Fastly サービス ID を見つけます

管理者から Fastly を設定したり、高度な Fastly 設定とトラブルシューティングのために Fastly API リクエストを送信したりするには、Fastly サービス ID が必要です。

プロジェクト環境で Fastly が有効になっている場合は、管理者からサービス ID を取得できます。 参照： Fastly 資格情報の取得.

開発者と高度な VCL ユーザーは、カスタム VCL を使用して、Fastly 変数を使用してサービス ID を取得できます req.service_id. 例えば、 req.service_id VCL のカスタム ログ ディレクティブに対して、サービス ID 値をキャプチャするには、次の手順を実行します。

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

実稼動環境とステージング環境に同じ VCL を使用できます。 参照： vcl_log の設定方法.

サイトのパフォーマンス、パージ、キャッシュの問題

以下のリストを使用して、クラウドインフラストラクチャー上のAdobe Commerceの Fastly サービス設定に関する問題を特定し、トラブルシューティングを行います。

Fastly の 503 エラー

Fastly が 503 タイムアウトエラーを返す場合は、エラーログと 503 エラーページを確認して、根本原因を特定します。

503 エラーが発生した場合は、実稼動環境またはステージング環境のエラーログと PHP アクセスログを確認して、問題のトラブルシューティングを行ってください。

エラーログを確認するには:

503 エラーが発生した場合、Fastly はエラーとメンテナンスページで理由を返します。 のコードを追加した場合、その理由を確認できないことがあります。 カスタム応答ページ. デフォルトのエラーページで理由コードを確認するには、カスタムエラーページのHTMLコードを削除します。

Fastly 503 エラーページを確認するには:

Apex とサブドメインは既に Fastly アカウントに関連付けられています

クラウドインフラストラクチャプロジェクトのAdobe Commerceの apex ドメインとサブドメインが、割り当てられたサービス ID を持つ既存の Fastly アカウントに既に関連付けられている場合、Fastly 設定を更新するまで起動できません。

Fastly サービスの検証またはデバッグ

サイト URL をテストし、応答で返されるヘッダー値を調べることで、クラウドインフラストラクチャサイト上のAdobe Commerceのパフォーマンスやキャッシュの問題をトラブルシューティングできます。

Fastly でのライブサイトの確認

Fastly API を使用して、 Fastly-Magento-VCL-Uploaded および X-Cache ライブサイトから返された応答ヘッダー。

Fastly API リクエストは、Fastly 拡張機能を通じて渡され、オリジンサーバーから応答を取得します。 応答から誤ったヘッダーが返された場合は、 オリジンサーバーを直接公開.

応答ヘッダーを確認するには:

ヘッダーに正しい値がない場合は、次の情報を参照してください。

Fastly キャッシュをバイパスしてAdobe Commerce サイトをチェック

Fastly サービスが誤ったヘッダーを返す場合、Fastly キャッシュをバイパスするリクエストを送信できる VCL スニペットを作成できます。 参照： Fastly キャッシュのバイパス.

VCL スニペットを追加した後、cURL コマンドを使用して、指定した IP アドレスから発信元サーバーに要求を送信します。 次に、応答にエラーがないか確認します。

キャッシュヒットおよびミス応答ヘッダーを確認します

返された応答に次の情報が含まれていることを確認します。

次の 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

応答ヘッダーで見つかったエラーの解決

この節では、Fastly API を使用して応答ヘッダーを確認する際に返されるエラーを解決するための推奨事項を説明します。

Fastly モジュールが有効になっていません

Fastly モジュールが有効になっていない場合（Fastly-Module-Enabled: no）に設定するか、ヘッダーがない場合は、 ssh を使用したログイン をプロジェクトに追加します。 次に、次のコマンドを実行して、モジュールのステータスを確認します。

php bin/magento module:status Fastly_Cdn

返されたステータスに基づいて、次の手順を使用して Fastly 設定を更新します。

Fastly VCL はアップロードされていません

Fastly VCL がアップロードされていない場合（Fastly-Magento-VCL-Uploaded: false）、を使用する VCL のアップロード 管理者が「」オプションを選択してアップロードします。 参照： Fastly VCL スニペットのアップロード.

X-Cache には MISS のみが含まれ、ヒットは含まれない

次の場合 X-Cache ヘッダーにを含める HIT （HIT, HIT または HIT, MISS）、Fastly がキャッシュされたコンテンツを正常に返すことを示します。

次の場合 X-Cache ヘッダー： MISS, MISS およびが次を含まない HIT、を実行します curl 再度コマンドを実行して、ページが最近キャッシュからパージされていないことを確認します。

同じ結果が得られる場合は、を使用します curl コマンド を確認します。 応答ヘッダー:

問題が解決しない場合は、別の拡張機能がこれらのヘッダーをリセットしている可能性があります。 ステージング環境で次の手順を繰り返し、すべての拡張機能を無効にし、各拡張機能を再度有効にして、ヘッダーをリセットしている拡張機能を特定します。 問題の原因となっている拡張機能を特定したら、実稼動環境でその拡張機能を無効にする必要があります。

応答ヘッダーをリセットする拡張機能を識別するには：

Fastly ヘッダーをリセットしている拡張機能を特定したら、拡張機能の開発者に問い合わせてください。 サードパーティの拡張機能を Fastly キャッシュで機能させるための修正や更新を提供することはできません。

Fastly 設定をロールバックする

カスタム VCL スニペットの更新やその他の Fastly 設定の変更により、クラウドインフラストラクチャサイト上のAdobe Commerceでエラーが発生した場合は、Fastly API を使用します アクティベート 以前の VCL バージョンにロールバックするコマンド。 管理者から VCL バージョンをロールバックすることはできません。

VCL のバージョンをロールバックするには:

Fastly API を使用した VCL のレビューと管理について詳しくは、を参照してください。 API を使用した VCL の管理.