Azure SRE エージェント操作のトラブルシューティングに関する FAQ

この記事では、Azure SRE エージェントを使用するときの一般的な運用上の問題と、実用的な解決策について説明します。 通常、これらの問題は、アクセス許可、リージョンの可用性、デプロイの問題、管理アクセスの要件に関連します。

一般的なトラブルシューティングのシナリオ

次の表に、一般的な問題とそれらの解決策の概要を示します。 ロールとアクセス許可をエージェントに適用する方法の詳細については、「 ロールとアクセス許可」を参照してください。

Scenario 理由 解決策
エージェントは、チャットとナレッジ グラフにアクセス許可エラーを表示します。 エージェントは Contributor アクセスを使用して作成されており、Reader アクセス許可のみを持つアカウントがエージェントとの対話を試みています。 リソース グループのユーザー アカウントへの 共同作成者 または 所有者 のアクセス権を付与します。
場所のドロップダウン リストが空白です。 米国以外のリージョン ポリシーは、スウェーデン中部へのアクセスをブロックします。 サブスクリプションまたは管理グループが米国のみのデプロイに制限されている場合は、デプロイに米国東部 2 を使用します。
[作成] ボタンは使用不可になります。 ユーザー アカウントに管理アクセス許可がありません。 ユーザー アカウントに 所有者 または ユーザー アクセス管理者 のアクセス許可があることを確認します。
エージェントはログまたはメトリックに対してクエリを実行できません。 Log Analytics ワークスペースに対するアクセス許可が不十分です。 ターゲット ワークスペースに対するエージェントのマネージド ID Log Analytics 閲覧者 のアクセス許可を付与します。
外部統合は失敗します。 ネットワーク接続または認証の問題。 ファイアウォール規則を確認し、サービス プリンシパルの構成を確認します。

デプロイの問題

次のセクションでは、Azure SRE エージェントをデプロイするときに発生する可能性がある一般的な問題について説明します。

デプロイが見つかりません

いくつかの理由により、デプロイが見つからないというエラーが発生する可能性があります。 ます、エージェントに正しい名前を付けており、適切なファイアウォール規則が設定されていることを確認してください。

  • エージェントの名前がサブスクリプション全体で一意であることを確認します。
  • エージェント エンドポイントへのアクセスを妨げる可能性があるジオブロックまたはファイアウォールルールを確認してください。

名前付けとネットワーク構成が正しい場合は、次の手順を使用して、エージェントの "DeploymentNotFound" エラーを解決します。

Azure SRE エージェントでのプロビジョニングエラーの通知を示すスクリーンショット。

  1. ユーザー アカウントに所有者または管理者のアクセス許可と、 スウェーデン中部、 米国東部 2、オーストラリア 東部 のリージョン (デプロイに応じて) にリソースを作成するアクセス許可があることを確認します。

  2. サブスクリプションが SRE エージェントの許可リストに含まれているかどうかを確認します。 次のコマンドを実行します。

    az provider show -n Microsoft.App | grep -C 15 agents

    サブスクリプションが許可リストに含まれている場合は、次のメッセージのような出力が表示されます。

    エージェントへのユーザー アクセスを確認するコンソール応答のスクリーンショット。

    特に "resourcetype : agents" と "defaultApiVersion : 2025-05-01-preview"を探します。

    このコマンドを実行しても予期した結果が返されない場合は、サブスクリプションを登録する必要があります。

  3. サブスクリプションを再登録するには、Azure portal を通じ、Azure Cloud Shell内で az provider register コマンドを実行します。

    az provider register --namespace "Microsoft.App"

    その後、エージェントを作成し直してください。

デプロイ検証エラー

デプロイの検証が失敗した場合:

  1. リソース クォータを確認する: サブスクリプションにデプロイ リージョンの使用可能なクォータがあることを確認します。
  2. リソース プロバイダーの登録を確認する: Microsoft.App プロバイダーが登録されていることを確認します。
  3. Azure Policy を確認する: 組織のポリシーによってリソースの作成がブロックされているかどうかを確認します。

権限とアクセスの問題

次のセクションでは、Azure SRE エージェントのアクセス許可とアクセス制御に関連する問題に対処します。

アクセス許可エラー

エージェントとチャットまたは対話ができない場合、403 許可されていませんエラーか、クロスオリジン リソース共有 (CORS) ポリシーのエラーに関連した問題である可能性があります。 次のスクリーンショットに、エラー メッセージの例を示します。

間違ったアクセス許可が原因で発生したエラーのスクリーンショット。

または、ネットワーク トレースに次の出力が表示される場合があります。

エージェントでアクセス許可エラーが発生したときのブラウザー ネットワーク トレースのスクリーンショット。

この問題を解決するには、次の手順を実行します。

  • エージェントをホストするリソース グループに対する、共同作成者または所有者のアクセス権があることを確認します。
  • グループベースのロールの割り当てのみに依存しないようにします。 問題が解決しない場合は、アカウントにロールを直接割り当てます。
  • Azure portal のアクセスのチェック機能を使用して、適切なアクセス許可があることを確認します。

エージェントによって管理されるIDに関する問題

エージェントが Azure リソースにアクセスできない場合:

  1. マネージド ID の作成を確認する: エージェントのマネージド ID が正常に作成されていることを確認します。
  2. ロールの割り当てを確認する: マネージド ID にターゲット リソースに対する適切なアクセス許可があることを確認します。
  3. 条件付きアクセス ポリシーを確認する: 組織のポリシーがマネージド ID アクセスをブロックしていないことを確認します。

ネットワークと接続の問題

次のセクションは、Azure SRE エージェントに影響する可能性があるネットワークと接続の問題を解決するのに役立ちます。

ポータルが応答しなくなる

SRE Agent を使用しようとすると Azure portal が応答しなくなるのであれば、ファイアウォール規則によって Azure ドメインへのアクセスがブロックされている可能性があります。

適切なドメインへのアクセスを許可するには、ファイアウォール設定の中で許可リストに *.azuresre.ai を追加します。 通常 Zscaler では、既定で *.azuresre.ai ドメインへのアクセスがブロックされています。

WebSocket 接続エラー

リアルタイム チャット機能が機能しない場合:

  1. プロキシ設定を確認する: 企業プロキシが WebSocket 接続をブロックする可能性があります。
  2. ファイアウォール規則を確認する: *.azuresre.ai が HTTP トラフィックと WebSocket トラフィックの両方の許可リストにあることを確認します。
  3. ネットワーク接続のテスト: ブラウザー開発者ツールを使用して、接続エラーを確認します。

パフォーマンスの問題

次のセクションでは、Azure SRE エージェントに関する一般的なパフォーマンス関連の問題について説明します。

応答時間が遅い

エージェントの応答が予想よりも遅い場合:

  1. Azure サービスの正常性を確認する: デプロイ リージョンで停止がないことを確認します。
  2. クエリの複雑さを確認する: 複雑なログ クエリの処理に時間がかかる場合があります。
  3. リソース制限の監視: ターゲット リソース (Log Analytics など) がスロットリングされていないことを確認します。

チャット インターフェイスの読み込みに関する問題

チャット インターフェイスが読み込まれない場合:

  1. ブラウザー キャッシュをクリアする: ページを強制的に更新します (Ctrl + F5 キー)。
  2. シークレットまたはプライベート ブラウズを試す: ブラウザー拡張機能の競合を除外します。
  3. JavaScript コンソールを確認する: ブラウザー開発者ツールでエラー メッセージを探します。

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

次のセクションは、外部サービス統合に関する問題のトラブルシューティングに役立ちます。

GitHub または Azure DevOps の接続エラー

ソース管理の統合が失敗した場合:

  1. 認証を確認する: サービス プリンシパルまたは個人用アクセス トークンのアクセス許可を確認します。
  2. API アクセスのテスト: エージェントが外部サービス API に到達できることを確認します。
  3. ファイアウォール規則を確認する: github.com または dev.azure.com への送信アクセスを確認します。

カスタム MCP サーバーの問題

カスタム モデル コンテキスト プロトコル サーバーが機能しない場合:

  1. サーバーの正常性を確認する: MCP サーバーが実行されていてアクセス可能であることを確認します。
  2. 認証をテストする: 適切な認証構成を確認します。
  3. ログの確認: エージェント ログで接続エラーまたはプロトコル エラーを確認します。

データとストレージの問題

以降のセクションでは、Azure SRE エージェントでのデータストレージと取得に関連する問題について説明します。

会話履歴が見つからない

会話スレッドが消えた場合:

  1. データ保持の設定を確認する: 構成されたアイテム保持ポリシーを確認します。
  2. アクセス許可を確認する: 会話データにアクセスできることを確認します。
  3. サポートに問い合わせる: データ復旧に関するサポート。

ナレッジ ベースのアップロードエラー

ドキュメントをナレッジ ベースにアップロードできない場合:

  1. ファイル サイズの制限を確認する: ドキュメントがサイズの制約内にあることを確認します。
  2. ファイル形式を確認する: サポートされているドキュメントの種類を確認します。
  3. ストレージのアクセス許可を確認する: BLOB ストレージへのマネージド ID アクセスを確認します。

ヘルプを受ける

このガイドで取り上げ以上のサポートが必要な場合は、次のリソースを使用してください。

エスカレーション経路

このガイドで取り上げられない問題については、次のオプションをお試しください。

  • Azure サポート: デプロイまたはサービスの問題のサポート チケットを作成します。
  • Microsoft Docs: 公式ドキュメント で更新プログラムを確認してください。
  • Azure の状態: Azure の [状態] ページ でサービスの停止を監視します。

関連するコンテンツ

  • Last updated on