Note
Azure AI 検索は、Azure ポータル、REST API、およびAzure SDKから使用できます。 また、Foundry IQ は、エンタープライズ コンテンツを、Microsoft Foundry ポータルのエージェントの再利用可能なアクセス許可に対応したナレッジ ベースに変換するマネージド ナレッジ レイヤーです。
この記事には、このサービスに関するすべてのモニタリングリファレンス情報が含まれています。
Azure AI 検索<収集できるデータとその使用方法の詳細については、
メトリック
このセクションには、このサービスのために自動的に収集されたすべてのプラットフォーム指標が一覧化されています。 これらの指標は、Azure Monitorでサポートされている
指標保持に関する情報は、Azure Monitor 指標概要を参照してください。
Microsoft.Search/searchServices 用にサポートされているメトリック
次の表は、Microsoft.Search/searchServices リソースタイプで利用可能なメトリックの一覧です。
- すべての列がすべてのテーブルに存在しているわけではありません。
- 一部の列はページの閲覧範囲を超えている場合があります。 利用可能なすべての列を見るには 「表を展開 」を選択します。
テーブル見出し
- カテゴリ - 指標グループまたは分類。
- Metric - Azureポータルに表示されるメトリクス名。
- REST APIにおける名称 - REST APIで言及されるメトリック名。
- 単位 - 単位単位。
- 集約 - デフォルトの 集約 タイプ。 有効数値:平均(平均)、最小(最小)、最大(最大)、合計(合計)、カウント。
- 寸法 - メトリックに使用可能な寸法です。
-
タイムグレインの - 、つまり指標がサンプリングされる頻度。 例えば、
PT1Mは指標が1分ごと、PT30M30分ごと、PT1H1時間ごとにサンプリングされることを示している、というように。 - DS エクスポート- 診断設定を通じてAzure Monitorログにメトリクスをエクスポートできるかどうか。 指標のエクスポートに関する情報は、Azure Monitorで診斷設定を作成する」をご覧ください。
| メトリック | REST APIにおける名前 | 高度なプラットフォーム メトリック | ユニット | 集計 | サイズ | 期間粒度 | DS エクスポート |
|---|---|---|---|---|---|---|---|
|
インデクサー処理済みファイル (バイト) ファイル ベースのデータソースからインデクサーによって処理されたソース データの合計バイト数 (BLOB、ADLS Gen2、File、SharePoint、OneLake など) |
DocumentsProcessedBytes |
いいえ | Bytes | 合計 (総和)、平均 |
DataSourceName、 IndexerName、 IndexName |
PT1M | はい |
|
処理されたドキュメント数 処理されたドキュメントの数 |
DocumentsProcessedCount |
いいえ | カウント | 合計 (Sum)、カウント |
DataSourceName、 Failed、 IndexerName、 IndexName、 SkillsetName |
PT1M | はい |
|
ストレージの使用状況 インデックスによる検索サービスのストレージ使用量 (テキスト + ベクター) |
IndexStorageUsage |
いいえ | Bytes | 平均、最大、最小 | IndexName |
PT1M | はい |
|
ベクター ストレージの使用状況 インデックスによる検索サービスのベクター ストレージの使用状況 |
IndexVectorUsage |
いいえ | Bytes | 平均、最大、最小 | IndexName |
PT1M | はい |
|
使用されるコンピューティング ユニット 検索サービス操作とインデックスウォーム ウィンドウによって消費されるコンピューティング ユニット (マイクロ CU 時間単位) (CU 時間を取得するために合計を 1,000,000 で除算)。 状態フィルターは非推奨です。 |
PerRequestComputeConsumption |
いいえ | カウント | 合計 (総和)、平均 |
Status、IndexName、ResourceKind、EventType |
PT1M | はい |
|
検索の待機時間 検索サービスの平均検索待機時間 |
SearchLatency |
いいえ | 秒 | 平均 | <なし> | PT1M | はい |
|
1 秒あたりの検索クエリ数 検索サービスの 1 秒あたりの検索クエリ数 |
SearchQueriesPerSecond |
いいえ | 秒ごとのカウント | 平均 | <なし> | PT1M | はい |
|
スキル実行の呼び出し回数 スキルの実行数 |
SkillExecutionCount |
いいえ | カウント | 合計 (Sum)、カウント |
DataSourceName、 Failed、 IndexerName、 SkillName、 SkillsetName、 SkillType |
PT1M | はい |
|
スロットルされた検索クエリの割合 検索サービスに対して制限された検索クエリの割合 |
ThrottledSearchQueriesPercentage |
いいえ | パーセント | 平均 | <なし> | PT1M | はい |
1 秒あたりの検索クエリ数
このメトリックは、検索サービスの 1 秒あたりの検索クエリ数 (QPS) の平均を示します。 クエリはミリ秒単位で実行するのが一般的であるため、秒として測定されるクエリのみが QPS などのメトリックに表示されます。 最小値は、その分に登録された 1 秒あたりの検索クエリの最小値です。 最大値は最大値です。 平均は、1 分全体の集計です。
| 集計の種類 | 説明 |
|---|---|
| 平均 | クエリの実行が発生した 1 分以内の平均秒数。 |
| カウント | 1 分間にログに出力されるメトリックの数。 |
| 最大 | 1 分間に登録された 1 秒あたりの検索クエリの最大数。 |
| 最小 | 1 分間に登録された 1 秒あたりの検索クエリの最小数。 |
| 合計 | 1 分以内に実行されたすべてのクエリの合計。 |
たとえば、1 分以内に、SearchQueriesPerSecond の最大値である高負荷の 1 秒、平均読み込みの 58 秒、最後にクエリが 1 つしかない 1 秒 (最小値) のようなパターンが発生する場合があります。
別の例: ノードが 100 個のメトリックを出力する場合、各メトリックの値が 40 の場合、"Count" は 100、"Sum" は 4000、"Average" は 40、"Max" は 40 です。
検索の待機時間
検索の待機時間は、クエリの完了にかかる時間を示します。
| 集計の種類 | 遅延 |
|---|---|
| 平均 | クエリの平均実行時間 (ミリ秒)。 |
| カウント | 1 分間にログに出力されるメトリックの数。 |
| 最大 | サンプルの実行時間が最も長いクエリ。 |
| 最小 | サンプルの最短実行クエリ。 |
| 合計 | 間隔 (1 分) 内で実行される、サンプル内のすべてのクエリの合計実行時間。 |
スロットルされた検索クエリの割合
このメトリックは、処理されるのではなく削除されるクエリを指します。 スロットルは、実行中の要求の数が容量を超えた場合に発生します。 レプリカがローテーションから外されたときまたはインデックス作成時に、スロットルされた要求が増加する場合があります。 クエリ要求とインデックス作成要求の両方が、同じリソース セットによって処理されます。
サービスは、リソースの使用量に基づいて要求を削除するかどうかを決定します。 メモリ、CPU、ディスク IO 全体で消費されたリソースの割合は、一定期間にわたって平均されます。 この割合がしきい値を超えると、要求の量が減るまで、インデックスに対するすべての要求が調整されます。
クライアントタイプに応じて、制限されたリクエストは次の方法で示されます。
- サービスからエラーが返される
"You are sending too many requests. Please try again later." - サービスは、サービスが現在使用できないことを示す 503 エラー コードを返します。
- Azure ポータル (Search Explorer など) を使用している場合、クエリは自動的に削除されるため、Search を再度選択する必要があります。
調整されたクエリを確認するには、 調整された検索クエリメトリックを 使用します。 この記事の説明に従って、Azure ポータルでメトリックを調べたり、アラート メトリックを作成したりできます。 サンプリング間隔内に削除されたクエリの場合は、 Total を使用して、実行されなかったクエリの割合を取得します。
| 集計の種類 | Throttling |
|---|---|
| 平均 | 間隔内に削除されたクエリの割合。 |
| カウント | 1 分間にログに出力されるメトリックの数。 |
| 最大 | 間隔内に削除されたクエリの割合。 |
| 最小 | 間隔内に削除されたクエリの割合。 |
| 合計 | 間隔内に削除されたクエリの割合。 |
スロットルされた検索クエリの割合、最小、最大、平均、合計の値はすべて同じ値です。調整された検索クエリの割合は、1 分間の検索クエリの合計数から得られます。
コンピューティング ユニットの使用量
このメトリックは、Azure AI 検索 サービスによって消費されるコンピューティング、メモリ、および I/O リソースをミリ コンピューティング ユニット (mCPU) で表して測定します。 これは、さまざまな操作の種類の処理コストのプロキシとして機能します。 使用状況は、実行される操作によって時間の経過と同時に異なる場合があります。
このメトリックは、次の 2 つのレベルで表示できます。
- 検索サービス レベル: サービス全体のコンピューティング消費量の集計。
- インデックス レベル: 特定のインデックスにスコープを設定した消費量。どのインデックスが最もリソースの使用率を高めているかを特定するのに役立ちます。
| 集計の種類 | 説明 |
|---|---|
| 合計 | 選択した期間に消費された mCPU の合計。 時間の経過に伴う全体的なコンピューティング コストを理解するのに役立ちます。 |
| 平均 | 選択した期間に消費された平均 mCPU。 |
このメトリックでは、次のフィルターがサポートされています。
インデックス名: メトリックを特定のインデックスにフィルター処理します。 フィルターが適用されていない場合、メトリックにはサービス内のすべてのインデックスの合計消費量が反映されます。
操作名: コンピューティングの消費に寄与する操作によってメトリックをフィルター処理します。 フィルターが適用されていない場合、メトリックはすべての操作の種類の合計消費量を反映します。 サポートされている値については、「 監視データリファレンス」を参照してください。
メトリック ディメンション
計量次元とは何かについては、 多次元計量を参照してください。
Azure AI 検索には、実行されたドキュメントまたはスキルの数をキャプチャする次のメトリックに関連付けられたディメンションがあります。
| メトリック名 | 説明 | サイズ | サンプルのユース ケース |
|---|---|---|---|
| 処理されたドキュメント数 | インデクサーで処理されたドキュメントの数を示します。 | データ ソース名、失敗、インデックス名、インデクサー名、スキルセット名 | スループットの大まかな尺度として参照できます (インデクサーによって時間の経過と伴って処理されるドキュメントの数) - 失敗したドキュメントに対するアラートを設定する |
| スキル実行の呼び出し回数 | スキル呼び出しの数を示します。 | データ ソース名、失敗、インデックス名、インデクサー名、スキル名、スキルの種類、スキルセット名 | スキル間の相対的な呼び出し数とスキル呼び出しの数をドキュメントの数と比較して、スキルが期待どおりに呼び出されるようにするための参照。 - 失敗したスキル呼び出しに対するアラートを設定する |
| コンピューティング ユニットの使用量 | 検索サービスの操作によって消費された mCPU を示します | インデックス名、操作 | 最も多くのコンピューティングを消費した操作を評価します。 -指定した作業タイプで、muck の消費量が想定しきい値を超えた場合にアラートを設定する |
| ディメンション名 | 説明 |
|---|---|
| DataSourceName | インデクサーの実行中に使用される名前付きデータ ソース接続。 有効な値は、 サポートされているデータ ソースの種類の 1 つです。 |
| 失敗 しました | インスタンスが失敗したかどうかを示します。 |
| IndexerName | インデクサーの名前。 |
| IndexName | インデックスの名前。 |
| SkillsetName | インデクサーの実行中に使用されるスキルセットの名前。 |
| SkillName | スキルセット内のスキルの名前。 |
| SkillType | スキルの @odata.type 。 |
リソース ログ
このセクションでは、このサービスで収集可能なリソースログの種類を一覧にしています。 このセクションは、Azure Monitorでサポートされている
Microsoft.Search/searchServices でサポートされているリソースログ
| カテゴリ | 輸出コスト | ログ テーブル | 基本的なログプランをサポートします | インジェスション時間変換をサポートします | クエリの例 |
|---|---|---|---|---|---|
| 操作ログ | いいえ |
AzureDiagnostics 複数のAzureリソースからのログ。 |
いいえ | いいえ |
Azure Monitor ログ テーブル
このセクションでは、このサービスに関連するAzure Monitorのログテーブルを一覧にしており、これらはKustoクエリを使ってLog Analyticsでクエリ可能です。 テーブルにはリソースログデータが含まれており、収集・ルーティングされるデータによってはそれ以上のデータも含まれる可能性があります。
検索サービス
Microsoft.Search/searchServices
| テーブル | 説明 |
|---|---|
| AzureActivity | Azure アクティビティ ログのエントリは、コントロール プレーン操作に関する分析情報を提供します。 レプリカやパーティションの追加や削除など、コントロール プレーンで呼び出されるタスクは、"管理キーの取得" アクティビティを通じて表されます。 |
| AzureDiagnostics | ログに記録されたクエリとインデックス作成の操作。 Log Analyticsの AzureDiagnostics テーブルに対するクエリには、共通プロパティ、検索固有のプロパティ、およびスキーマ参照セクションに記載されている search 固有の操作が含まれます。 |
| AzureMetrics | 正常性とパフォーマンスを測定するAzure AI 検索によって出力されるメトリック データ。 |
リソース ログ テーブル
次の表に、Azure AI 検索のリソース ログのプロパティを示します。 リソース ログは、Azure Monitor ログまたはAzure Storageに収集されます。 Azure Monitorでは、azureDiagnostics テーブルのリソース プロバイダー名の下に Microsoft.Search のログが収集されます。
| Azure Storage フィールドまたはプロパティ | Azure Monitor Logs プロパティ | 説明 |
|---|---|---|
| 時間 | タイムスタンプ | 操作が発生した日時 (UTC)。 |
| resourceId | Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) | ログが有効になっているAzure AI 検索 リソース。 |
| カテゴリ | "OperationLogs" | ログ カテゴリには、 Audit、 Operational、 Execution、および Requestが含まれます。 |
| オペレーション名 | 名前 | 操作の名前。 操作名には、 Indexes.ListIndexStatsSummaries、 Indexes.Get、 Indexes.Stats、 Indexers.List、 Query.Search、 Query.Suggest、 Query.Lookup、 Query.Autocomplete、 CORS.Preflight、 Indexes.Update、 Indexes.Prototype、 ServiceStats、 DataSources.List、 Indexers.Warmupを指定できます。 |
| durationMS | 継続時間ミリ秒 | 操作の期間 (ミリ秒単位)。 |
| operationVersion | ApiVersion | 要求で使用される API バージョン。 |
| 結果タイプ | (失敗) ? "失敗" : "成功" | 応答の種類。 |
| resultSignature | ステータス | 操作の HTTP 応答状態。 |
| プロパティ | プロパティ | このカテゴリのイベントに関連するすべての拡張プロパティ。 |
アクティビティ ログ
リンクテーブルは、このサービスのアクティビティログに記録可能な操作を一覧にしています。 これらの操作は 、アクティビティログ内のすべてのリソース提供者操作のサブセットです。
アクティビティログエントリのスキーマの詳細については、 アクティビティログスキーマをご覧ください。
次の表に、アクティビティ ログに記録できるAzure AI 検索に関連する一般的な操作を示します。 Microsoft.Search のすべての操作一覧については、「Microsoft.Search リソース プロバイダーの操作」を参照してください。
| 操作 | 説明 |
|---|---|
| 管理者キーを取得する | 管理者権限を必要とする操作は、"管理キーの取得" 操作としてログに記録されます。 |
| クエリ キーを取得する | インデックス内のドキュメント コレクションに対する任意の読み取り専用操作。 |
| 管理者キーを再生成する | プライマリまたはセカンダリの管理者 API キーを再生成する要求。 |
一般的なエントリには、API キーへの参照が含まれます。管理者キーの 取得 や クエリ キーの取得などの一般的な情報通知です。 これらのアクティビティは、管理キー (オブジェクトの作成または削除) またはクエリ キーを使用して行われた要求を示しますが、要求自体は表示されません。 このグレインの情報については、リソース ログを構成する必要があります。
または、変更履歴を通じていくつかの分析情報を得ることができます。 Azure ポータルで、アクティビティを選択して詳細ページを開き、基になる操作に関する情報として [履歴の変更] を選択します。
その他のスキーマ
このサービスでは、次のスキーマが使用されています。
クエリまたはカスタム レポートを作成する場合、リソース ログを含むデータ構造Azure AI 検索次のスキーマに準拠します。
BLOB ストレージに送信されるリソース ログの場合、各 BLOB には、ログ オブジェクトの配列を含む レコード と呼ばれる 1 つのルート オブジェクトがあります。 各 BLOB には、同じ 1 時間に実行されたすべての操作のレコードが含まれます。
リソース ログ スキーマ
Azure Monitorで使用できるすべてのリソース ログは、common 最上位スキーマを共有します。 Azure AI 検索 は、検索サービスに固有のさらなるプロパティおよび操作を補完します。
次の例は、共通プロパティ (TimeGenerated、Resource、Category など) と検索固有のプロパティ (OperationName と OperationVersion) を含むリソース ログを示しています。
| 名前 | タイプ | 説明と例 |
|---|---|---|
| TimeGenerated | 日付時刻 | 操作のタイムスタンプ。 例えば: 2021-12-07T00:00:43.6872559Z |
| リソース | 文字列 | リソース ID。 例えば: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name> |
| カテゴリ | 文字列 | "OperationLogs" この値は定数です。 OperationLogs は、リソース ログに使用される唯一のカテゴリです。 |
| 操作名 | 文字列 | 操作の名前 (操作 の完全な一覧を参照)。 例を次に示します。 Query.Search |
| OperationVersion | 文字列 | 要求で使用される API バージョン。 例えば: 2026-04-01 |
| ResultType | 文字列 | 成功 その他の使用可能な値: 成功または失敗 |
| ResultSignature | int | HTTP 結果コード。 例えば: 200 |
| DurationMS | int | 操作の期間 (ミリ秒単位)。 |
| プロパティ | オブジェクト | 操作固有のデータを格納しているオブジェクト。 次のプロパティ スキーマ テーブルを参照してください。 |
プロパティ スキーマ
次のプロパティは、Azure AI 検索に固有です。
| 名前 | タイプ | 説明と例 |
|---|---|---|
| Description_s | 文字列 | 操作のエンドポイント。 例えば: GET /indexes('content')/docs |
| Documents_d | int | 処理されたドキュメントの数。 |
| IndexName_s | 文字列 | 操作に関連付けられているインデックスの名前。 |
| Query_s | 文字列 | 要求で使用されるクエリ パラメーター。 例えば: ?search=beach access&$count=true&api-version=2026-04-01 |
OperationName 値 (ログに記録された操作)
リソース ログには、次の操作が表示されます。
| 操作名 | 説明 |
|---|---|
| データソース。* | インデクサー データ ソースに適用されます。 作成、削除、取得、リストを指定できます。 |
| DebugSessions.* | デバッグ セッションに適用されます。 作成、削除、取得、一覧表示、開始、状態を指定できます。 |
| DebugSessions.DocumentStructure | エンリッチされたドキュメントがデバッグ セッションに読み込まれます。 |
| DebugSessions.RetrieveIndexerExecutionHistoricalData | インデクサー実行の詳細の要求。 |
| DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData | ナレッジ ストアに投影されるエンリッチメントの実行履歴。 |
| インデクサー。* | インデクサーに適用されます。 作成、削除、取得、一覧表示、および状態を指定できます。 |
| インデックス.* | 検索インデックスに適用されます。 作成、削除、取得、リストを指定できます。 |
| indexes.Prototype | インデックス メタデータは、データ入力に基づいて データのインポート ウィザードによって定義されます。 |
| Indexing.Index | この操作は、 インデックス ドキュメントの呼び出しです。 |
| Metadata.GetMetadata | 検索サービス システム データの要求。 |
| クエリ.オートコンプリート | インデックスに対するオートコンプリート クエリ。 「クエリの種類と構成」を参照してください。 |
| Query.Lookup | インデックスに対する参照クエリ。 「クエリの種類と構成」を参照してください。 |
| クエリ検索 | インデックスに対するフルテキスト検索要求。 「クエリの種類と構成」を参照してください。 |
| Query.Suggest | インデックスに対する先行クエリを入力します。 「クエリの種類と構成」を参照してください。 |
| ServiceStats | この操作は、サービス統計の 取得を直接呼び出すか、ポータルの概要ページが読み込まれたり更新されたりしたときに暗黙的に呼び出されたりするルーチン呼び出しです。 |
| スキルセット。* | スキルセットに適用することができます。 作成、削除、取得、リストを指定できます。 |
関連コンテンツ
- 監視Azure AI 検索の説明については、Monitor Azure AI 検索を参照してください。
- Azureリソースの監視については、Monitor Azure resources with Azure Monitor を参照してください。