Azure AI Document Intelligence の待機時間に関する問題のトラブルシューティング

2025-03-03

この記事では、Document Intelligence の待機時間の問題に対処するためのトラブルシューティングのヒント、修復策、ベストプラクティスについて説明します。待機時間とは、API サーバーが受信要求を処理してクライアントに応答を配信するまでにかかる時間を指します。ドキュメントの分析に必要な時間は、ドキュメントのサイズ (ページ数など) と各ページの内容によって異なります。

Document Intelligence はマルチテナントサービスとして動作し、類似するドキュメントの待機時間が同等であることは保証されますが、常に同一であるとは限りません。待機時間やパフォーマンスの変動は、特に画像や大きなドキュメントを大規模に処理する場合、マイクロサービスベースのステートレスなすべての非同期サービスに固有の特性です。ハードウェア容量を増やし、スケーラビリティを向上するための継続的な取り組みにもかかわらず、実行時にいくつかの待機時間の問題が依然として発生する場合があります。

Note

Azure AI サービスについては、待機時間に関するサービスレベルアグリーメント (SLA) は提供されません。
Document Intelligence API を使用すると、非同期機能が提供されるため、バックエンドに要求を送信してから最大 24 時間後には結果にアクセスできます。
これらの結果を取得するには、POST 操作によって提供される要求 ID を使用します。標準のポーリングシーケンス中に問題が発生した場合は、要求 ID を保存し、後でもう一度試してから、再試行を検討してください。さらに支援が必要な場合は、サポートのページを参照してください。

待機時間のベースラインを設定する

待機時間を評価するには、まず、特定のシナリオのベースラインメトリックを確立する必要があります。これらのメトリックにより、アプリケーション環境のコンテキスト内で予想されるエンドツーエンドおよびサーバーの待機時間が得られます。これらのベースラインメトリックを設定すると、予想される状態と予期しない状態を簡単に区別できます。

Azure リージョンの状態を確認する

待機時間の問題が発生した場合、最初の手順は、Azure の状態を調べて、サービスに影響を与える可能性のある停止や問題が現在発生していないかどうかを確認することです。

アクティブなイベントはすべて [Current Impact] タブの下に表示されます。
ホストリージョンでリソースを確認することもできます。 [地域] → [製品とサービス] → [AI と機械学習] → [Azure AI Document Intelligence] の順に移動し、お使いのリージョンの状態を確認します。

ファイルサイズを確認する

要求 API を使用して送信するファイルのサイズを監視します。大きなファイルを並列処理すると、処理時間が長くなる可能性があります。ページあたりの待機時間を測定して、メトリックを正規化します。ページあたりの待機時間が常に 15 秒を超える期間が続く (1 時間を超える) 場合は、この問題に対処することを検討してください。

Azure Blob Storage の待機時間を確認する

要求のサイズは、Azure Storage 操作での待機時間に影響します。大規模な操作では、ネットワーク経由で転送され、Azure Storage によって処理されるデータの量が増えるため、完了するまでの時間が長くなります。

Azure Storage については、Azure portal に、ブロック BLOB の待機時間に関する 2 つのメトリックが用意されています。

エンドツーエンド (E2E) の待ち時間: Azure Storage が 1 つ目の要求パケットを受け取ってから、最後の応答パケットについてクライアントの受信確認を受け取るまでの間隔を測定します。
サーバーの待ち時間: Azure Storage が最後の要求パケットを受け取ってから、1 つ目の応答パケットを返すまでの間隔を測定します。

待機時間メトリックを表示するには、Azure portal でストレージリソースに移動します。

左側のナビゲーションウィンドウで、[監視] ドロップダウンメニューから [分析情報] を選択します。
[分析情報] タブで、E2E と Server の両方の待機時間メトリックを示すグラフを含んだウィンドウが開きます。

詳細については、「Blob Storage での待ち時間」を "参照" してください。

リソースの監視メトリックを確認する

Azure portal モニターでは、アプリケーションのパフォーマンスと可用性を向上するために、アプリケーションに関する分析情報が提供されます。 Azure portal でアプリのパフォーマンスを監視するために使用できるツールがいくつかあります。

[概要] ページで、[監視] を選択し、期間を選択し、ページの [要求待機時間] メトリックをレビューします。
左側のナビゲーションウィンドウで、[監視] ドロップダウンメニューから [メトリック] を選択します。
- メインウィンドウで、[+ メトリックの追加] を選択します。
- [スコープ] と [メトリック名前空間] のフィールドは変更しないでおきます。 [待機時間] パラメーターを [メトリック] フィールドに追加し、必要に応じて [集計] フィールドを調整します。

Azure portal で待機時間アラートを設定する

アラートは、Azure Monitor データが潜在的な問題を示唆している場合にプロアクティブな通知を提供して、問題の特定と解決に役立ちます。アラートルールはデータを監視し、指定されたリソースで、設定された条件が満たされたときに通知します。アラートは、Azure portal で次のように設定できます。

左側のナビゲーションウィンドウで、[監視] ドロップダウンメニューから [アラート] を選択します。
[アラートルールの作成] ボタンを選択します。
開いた新しいウィンドウで、[シグナルの選択] ドロップダウンメニューから [待機時間] を選択します。
ページのフィールドに入力して、アラートを構成します。
構成が完了したら、[確認と作成] を選択します

お問い合わせ

長い待機時間の問題を解決できない場合は、次の情報を Microsoft にメールでお送りください。

Model Name
バージョン
サブスクリプション ID
リソース ID
タイムスタンプと問題の説明
関係する操作の要求 ID (可能な場合)
ログ
サンプルファイル
JSON ファイル (出力または分析結果)
トレーニングセット (カスタムニューラルモデルに関連するトレーニング問題の場合)

さらに支援が必要な場合は、Microsoft Learn ページの下部にあるフィードバックウィジットを使用することもできます。

次の方法で共有