参照文字列を使用した 4xx および 5xx エラーのトラブルシューティング
参照文字列を理解して Azure Front Door の問題の診断と解決に使用するためのガイド。
前提条件
- Azure Front Door プロファイルが必要です。 プロファイルを作成するには、「Azure Front Door プロファイルの作成」を参照してください。
参照文字列とは
参照文字列 (RefString とも呼ばれます) は、Azure Front Door で各要求の HTTP 応答ヘッダーに追加される短い文字列です。 これを使用すると、要求の処理方法の詳細 (ポイント オブ プレゼンス (POP) やバックエンドの状態など) が提供されます。
参照文字列を使用すると、キャッシュ ミス、バックエンド エラー、待機時間の問題など、Azure Front Door に関する問題のトラブルシューティングと解決に役立ちます。 要求の参照文字列を分析することで、根本原因を特定し、修正するための適切なアクションを実行できます。
Note
Microsoft サービスからエラー ページが発生した場合は、そこには既に、エラー ページを生成した要求の参照文字列が含まれています。 このような場合は、診断の手順に直接スキップできます。
参照文字列を収集する方法
参照文字列を収集するには、要求の HTTP 応答ヘッダーをキャプチャし、"X-Azure-Ref" という名前のヘッダーを探す必要があります。このヘッダーには、Base64 でエンコードされた参照文字列が含まれています。 設定や状況に応じて、さまざまな方法を使用して HTTP 応答ヘッダーをキャプチャできます。 Microsoft Edge ブラウザーから参照文字列を取得する方法の例を次に示します。
[
F12] または [Ctrl+Shift+I] を押して、ブラウザーの開発者ツールを開きます。[ネットワーク] タブに移動します。
ページを更新するか、要求をトリガーするアクションを実行します。
一覧で特定の要求を検索して、応答ヘッダー セクションで X-Azure-Ref ヘッダーを見つけます。
Azure portal の参照文字列トラブルシューティング ツールで使用する X-Azure-Ref ヘッダーの値をコピーします。
詳細については、「ネットワーク アクティビティの検査 - Microsoft Edge 開発者向けドキュメント」を参照してください。
Microsoft Edge ブラウザーから参照文字列を取得する方法の例:
トラブルシューティング ツールの一部と共に参照文字列を使用する方法
Azure Front Door では、参照文字列を使用して 4xx エラーと 5xx エラーを管理します。 接続の問題を追跡および診断するために、診断ツールを参照文字列と共に使用する手順を次に示します。
Azure Front Door プロファイルに移動します。
[問題の診断と解決] メニューを選択します。
下にスクロールし、[一般的な問題] のセクションにある [接続性] を選択します。
[どのような問題がありますか?] ボックスで [問題のサブタイプ] を選択し、ドロップダウン メニューで [4xx エラーと 5xx エラー] を選択してから、[次へ] を選択します。
[4xx および 5xx エラー] セクション内のボックスに参照文字列を入力します。 [追跡参照 – RefString] フィールドに、要求で指定された参照文字列を入力します。
最後に、[診断の実行] を選択して問題の原因を特定します。これにより、既知の問題である場合、そのエラーについて説明されます。
問題を表示している結果の例:
Note
診断機能では、結果を提供するために最大 15 分かかる場合があります。 処理が完了するまでお待ちいただき、その後、次の手順に進んでいただくようお願いします。
代わりのオプション
診断ツールを使用されない場合は、サポート チケットを送信するときに参照文字列を含めることができます。 さらに、アクセス ログ機能を有効にすると、RefString データの更新を Azure portal で直接受信できます。
参照とアクセス ログ パラメーターの追跡の詳細については、「Azure Front Door でのメトリックとログの監視」を参照してください。さまざまなエラーの識別に役立つアクセス ログの特定のフィールドが特に取り上げられています。
次のステップ
- 一般的な問題の対処方法の詳細情報は、「Front Door のトラブルシューティングの問題」を参照してください。
- 一般的な質問に対する回答については、「Azure Front Door の FAQ」を参照してください。