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 変数 req.service_id を使用してサービス ID を取得できます。 例えば、VCL のカスタムログディレクティブに req.service_id を追加して、サービス 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）、Admin の Upload VCL オプションを使用してアップロードします。 Fastly VCL スニペットのアップロードを参照してください。

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

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

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

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

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

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

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

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

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

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

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