参照文字列を使用した 4xx エラーと 5xx エラーのトラブルシューティング

概要

この記事では、Azure Front Doorに関する問題の診断と解決に参照文字列を理解して使用する方法に関するガイダンスを提供します。

[前提条件]

• Azure Front Door プロファイルが必要です。 プロファイルを作成するには、「Azure Front Door プロファイルを作成するを参照してください。

参照文字列とは

RefString とも呼ばれる参照文字列は、各要求の HTTP 応答ヘッダーにAzure Front Doorによって追加される短い文字列です。 要求の処理方法の詳細 (ポイント オブ プレゼンス (POP) やバックエンドの状態など) を提供します。

参照文字列は、キャッシュ ミス、バックエンドエラー、待機時間の問題など、Azure Front Doorに関する問題のトラブルシューティングと解決に役立ちます。 要求の参照文字列を分析することで、根本原因を特定し、修正するための適切なアクションを実行できます。

参照文字列を収集する方法

参照文字列を収集するには、要求の HTTP 応答ヘッダーをキャプチャし、X-Azure-Ref という名前のヘッダーを探す必要があります。このヘッダーには、Base64 でエンコードされた参照文字列が含まれています。 設定や状況に応じて、さまざまな方法を使用して HTTP 応答ヘッダーをキャプチャできます。 Microsoft Edge ブラウザーから参照文字列を取得する方法の例を次に示します。

一部のトラブルシューティング ツールで参照文字列を使用する方法

Azure Front Doorでは、参照文字列を使用して 4xx エラーと 5xx エラーを管理します。 接続の問題を追跡および診断するために、診断ツールを参照文字列と共に使用する手順を次に示します。

1. Azure Front Door プロファイルに移動します。

2. [ 問題の診断と解決 ] メニューを選択します。

   参照文字列を使用して問題を診断する最初の手順を示すスクリーンショット。

3. 下にスクロールし、[一般的な問題] セクションで [接続] を選択します。

   参照文字列を使用して問題を診断する 2 番目の手順を示すスクリーンショット。

4. [ 問題 の種類] ボックスで、 問題のサブタイプを選択 し、ドロップダウン メニューで [4xx エラーと 5xx エラー ] を選択し、[ 次へ] を選択します。

   参照文字列を使用して問題を診断する 3 番目の手順を示すスクリーンショット。

5. 4xx および 5xx エラー セクション内のボックスに参照文字列を入力します。 [ 追跡参照 - RefString ] フィールドに、要求から指定された参照文字列を入力します。

   参照文字列を使用して問題を診断する 4 番目の手順を示すスクリーンショット。

6. 最後に、[ 診断の実行 ] を選択して問題の原因を特定します。これにより、既知の問題である場合のエラーが説明されます。

   問題を表示する結果の例:

   参照文字列を使用した職場での診断の例を示すスクリーンショット。

   注

   診断機能では、結果を提供するために最大 15 分が必要な場合があります。 さらなるアクションを実行する前に、プロセスが完了することを許可するように、お客様の忍耐をお願いします。

代替オプション

診断ツールを使用しないことを選択した場合は、サポート チケットを送信するときに参照文字列を含めることができます。 さらに、Access Logs 機能を有効にして、Azure ポータルで直接 RefString データの更新プログラムを受信できます。

参照とアクセス ログパラメーターの追跡の詳細については、「Monitor metrics and logs in Azure Front Door」を参照してください。このメトリックとログでは、さまざまな種類のエラーを識別するのに役立つアクセス ログ内の特定のフィールドが強調表示されています。

次のステップ

• 一般的な問題の対処方法について詳しくは、「Front Door のトラブルシューティング」に関する資料をご参照ください。
• 一般的な質問に対する回答については、Azure Front Door FAQ を参照してください。