Azure AI 検索の監視データのリファレンス
この記事には、このサービスに関するすべての監視リファレンス情報が含まれています。
Azure AI Search 用に収集できるデータとその使用方法の詳細については、Azure AI Search の監視に関するページを参照してください。
メトリック
このセクションには、このサービスに関して自動的に収集されるすべてのプラットフォーム メトリックが一覧表示されています。 これらのメトリックは、Azure Monitor でサポートされているすべてのプラットフォーム メトリックのグローバル リストにも含まれています。
メトリックのリテンション期間の詳細については、「Azure Monitor メトリックの概要」を参照してください。
Microsoft.Search/searchServices でサポートされているメトリック
次の表に、Microsoft.Search/searchServices リソースの種類で使用できるメトリックの一覧を示します。
- すべての列がすべてのテーブルに存在するわけではない場合があります。
- 一部の列がページの表示領域を超えている場合があります。 [テーブルの展開] を選択すると、使用可能なすべての列が表示されます。
テーブルの見出し
- カテゴリ - メトリック グループまたは分類。
- メトリック - Azure Portal に表示されるメトリックの表示名。
- REST API の名前 - REST API で参照されるメトリック名。
- 単位 - 測定単位。
- 集計 - 既定の集計の種類。 有効な値: 平均 (Avg)、最小 (Min)、最大 (Max)、合計 (Sum)、数。
- ディメンション - メトリックで使用できるディメンション。
- 時間グレイン - メトリックをサンプリングする間隔。 たとえば、
PT1Mは、メトリックを 1 分ごとに、PT30Mは 30 分ごとに、PT1Hは 1 時間ごとにサンプリングすることを示します。 - DS エクスポート - メトリックが診断設定を介して Azure Monitor ログにエクスポート可能かどうかを示します。 メトリックのエクスポートについては、「Azure Monitor で診断設定を作成する」を参照してください。
| メトリック | REST API での名前 | 単位 | 集計 | Dimensions | 期間粒度 | DS エクスポート |
|---|---|---|---|---|---|---|
| 処理されたドキュメント数 処理されたドキュメント数 |
DocumentsProcessedCount |
カウント | 合計数 | DataSourceName、 Failed, IndexerName, IndexNameSkillsetName |
PT1M | はい |
| 検索の待機時間 検索サービスの平均検索待機時間 |
SearchLatency |
Seconds | Average | <なし> | PT1M | はい |
| 1 秒あたりの検索クエリ数 検索サービスの 1 秒あたりの検索クエリ数 |
SearchQueriesPerSecond |
CountPerSecond | Average | <なし> | PT1M | はい |
| スキル実行の呼び出し回数 スキルの実行数 |
SkillExecutionCount |
カウント | 合計数 | DataSourceName、 Failed, IndexerName, SkillName, SkillsetNameSkillType |
PT1M | はい |
| スロットルされた検索クエリの割合 検索サービスのスロットルされた検索クエリの割合 |
ThrottledSearchQueriesPercentage |
Percent | Average | <なし> | PT1M | はい |
SearchQueriesPerSecond は、検索サービスの 1 秒あたりの検索クエリ数 (QPS) の平均を示します。 クエリはミリ秒単位で実行するのが一般的であるため、秒として測定されるクエリのみが QPS などのメトリックに表示されます。 最小値は、該当する 1 分間に登録された秒あたりの検索クエリ数のうち最小の値になります。 最大値は最大値です。 平均値は、1 分間にわたって集計されます。
たとえば、1 分間のうち、1 秒は非常に負荷が高く、続く 58 秒は平均的な負荷で、最後の 1 秒はクエリが 1 つだけというパターンがあるとします。この場合、最初の 1 秒の値が SearchQueriesPerSecond の最大値、最後の １ 秒の値が最小値となります。
メトリック ディメンション
メトリック ディメンションについては、「多次元メトリック」を参照してください。
Azure AI Search には、実行されたドキュメントまたはスキルの数、"Document processed count"、"Skill execution invocation count" をキャプチャするメトリックに関連付けられた次のディメンションがあります。
| ディメンション名 | 説明 |
|---|---|
| DataSourceName | インデクサーの実行中に使用される名前付きデータ ソース接続。 有効な値は、サポートされているデータ ソースの種類のいずれかです。 |
| Failed | インスタンスが失敗したかどうかを示します。 |
| IndexerName | インデクサーの名前。 |
| IndexName | インデックスの名前。 |
| SkillsetName | インデクサーの実行中に使用されるスキルセットの名前。 |
| SkillName | スキルセット内のスキルの名前。 |
| SkillType | スキルの @odata.type。 |
リソース ログ
このセクションでは、このサービス用に収集できるリソース ログの種類を一覧表示します。 このセクションでは、Azure Monitor でサポートされているすべてのリソース ログ カテゴリの種類のリストからプルされます。
Microsoft.Search/searchServices でサポートされているリソース ログ
| カテゴリ | カテゴリの表示名 | ログ テーブル | 基本ログ プランをサポート | インジェスト時間変換をサポート | クエリの例 | エクスポートするコスト |
|---|---|---|---|---|---|---|
OperationLogs |
[操作ログ] | AzureDiagnostics 複数の Azure リソースからのログ。 |
いいえ | 番号 | いいえ |
Azure Monitor ログ テーブル
このセクションでは、このサービスに関連する Azure Monitor ログ テーブルの一覧を示します。このテーブルは、Kusto クエリを使用して Log Analytics によるクエリに使用できます。 テーブルにはリソース ログ データが含まれています。場合によっては、収集され、それらにルーティングされる内容によって異なります。
検索サービス
Microsoft.Search/searchServices
| テーブル | 説明 |
|---|---|
| AzureActivity | Azure アクティビティ ログのエントリは、コントロール プレーン操作に関する分析情報を提供します。 レプリカとパーティションの追加や削除など、コントロール プレーンで呼び出されたタスクは、"管理 キーの取得" アクティビティによって表されます。 |
| AzureDiagnostics | ログされたクエリとインデックス作成の操作。 Log Analytics の AzureDiagnostics テーブルに対するクエリには、共通プロパティ、 検索固有のプロパティ、およびスキーマリファレンスセクションに 記載されている検索固有の操作 を含めることができます。 |
| AzureMetrics | 正常性とパフォーマンスを測定する Azure AI Search によって出力されるメトリック データ。 |
リソース ログ テーブル
次の表に、Azure AI Search のリソース ログのプロパティを示します。 リソース ログは Azure Monitor ログまたは Azure Storage に収集されます。 Azure Monitor では、リソース プロバイダー名 Microsoft.Searchの下の AzureDiagnostics テーブルにログが収集されます。
| Azure Storage のフィールドまたはプロパティ | Azure Monitor ログのプロパティ | 説明 |
|---|---|---|
| time | TIMESTAMP | 操作が発生した日時 (UTC)。 |
| resourceId | Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) | ログが有効になっている Azure AI Search リソース。 |
| category | "OperationLogs" | ログ のカテゴリには、AuditOperational、、RequestExecution |
| operationName | 名前 | 操作の名前。 操作名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 | DurationMilliseconds | 操作時間 (ミリ秒)。 |
| operationVersion | ApiVersion | 要求で使用される API バージョン。 |
| resultType | (失敗) ? "Failed" : "Success" | 応答の種類。 |
| resultSignature | 状態 | 操作の HTTP 応答状態。 |
| properties | プロパティ | このイベント カテゴリに関連する拡張プロパティ。 |
アクティビティ ログ
リンクされたテーブルには、このサービスのアクティビティ ログに記録できる操作が一覧表示されます。 これらの操作は、アクティビティ ログで使用可能なすべてのリソース プロバイダー操作のサブセットです。
アクティビティ ログ エントリのスキーマの詳細については、「アクティビティ ログのスキーマ」を参照してください。
次の表に、アクティビティ ログに記録できる Azure AI Search に関連する一般的な操作を示します。 すべての Microsoft.Search 操作の完全な一覧については、Microsoft.Search リソース プロバイダーの操作を参照してください。
| 操作 | 説明 |
|---|---|
| 管理者キーの取得 | 管理者権限を必要とする操作は、"管理 キーの取得" 操作としてログに記録されます。 |
| クエリ キーの取得 | インデックスのドキュメント コレクションに対するすべての読み取り専用操作。 |
| 管理者キーを再生成する | プライマリまたはセカンダリの管理 API キーを再生成する要求。 |
共通エントリには、API キー ("管理者キーの取得" や "クエリ キーの取得" など、情報提供を目的とした一般的な通知) への参照が含まれています。 これらのアクティビティは、管理キー (オブジェクトの作成または削除) またはクエリ キーを使用して行われた要求を示しますが、要求自体は表示されません。 この粒度の情報については、リソース ログを構成する必要があります。
または、変更履歴を通じて分析情報を得られる場合もあります。 Azure portal で、アクティビティを選択して詳細ページを開き、基になる操作に関する情報の [履歴の変更] を選択します。
その他のスキーマ
このサービスでは、次のスキーマが使用されています。
クエリまたはカスタム レポートを作成する場合、Azure AI Search リソース ログを含むデータ構造は次のスキーマに準拠します。
Blob Storage に送信されるリソース ログの場合、各 BLOB には、ログ オブジェクトの配列が含まれる、レコードと呼ばれるルート オブジェクトが 1 つあります。 各 BLOB には、同じ時間帯に行われたすべての操作に関するレコードが含まれます。
リソース ログ スキーマ
Azure Monitor を通じて使用できるすべてのリソース ログは、共通の最上位レベルのスキーマを共有します。 Azure AI Search では、検索サービスに 固有のプロパティ と 操作 がさらに追加されます。
次の例は、共通プロパティ (TimeGenerated、Resource、Category など) と検索固有のプロパティ (OperationName と OperationVersion) を含むリソース ログを示しています。
| 名前 | Type | 説明と例 |
|---|---|---|
| TimeGenerated | 日時 | 操作のタイムスタンプ。 例: 2021-12-07T00:00:43.6872559Z |
| リソース | String | リソースの ID 例: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name> |
| カテゴリ | String | "OperationLogs"。 この値は定数です。 OperationLogs は、リソース ログに使用される唯一のカテゴリです。 |
| OperationName | String | 操作の名前 (操作の完全な一覧を参照)。 たとえば Query.Search とします |
| OperationVersion | String | 要求で使用される API バージョン。 例: 2020-06-30 |
| ResultType | String | "Success"。 その他の有効値 Success または Failure |
| ResultSignature | int | HTTP の結果コード。 例: 200 |
| DurationMS | int | 操作の期間 (ミリ秒)。 |
| プロパティ | オブジェクト | 操作固有データを含むオブジェクト。 次のプロパティ スキーマ テーブルを参照してください。 |
プロパティのスキーマ
次のプロパティは、Azure AI Search に固有のものです。
| 名前 | Type | 説明と例 |
|---|---|---|
| Description_s | String | 操作のエンドポイント。 例: GET /indexes('content')/docs |
| Documents_d | int | 処理されたドキュメント数。 |
| IndexName_s | String | 操作に関連付けられているインデックスの名前。 |
| Query_s | String | 要求で使用されるクエリ パラメーター。 例: ?search=beach access&$count=true&api-version=2020-06-30 |
OperationName 値 (ログされた操作)
リソース ログには、次の操作が表示されます。
| OperationName | 説明 |
|---|---|
| DataSources.* | インデクサー データ ソースに適用されます。 Create、Delete、Get、List を指定できます。 |
| DebugSessions.* | デバッグ セッションに適用されます。 Create、Delete、Get、List、Start、Status を指定できます。 |
| DebugSessions.DocumentStructure | エンリッチされたドキュメントがデバッグ セッションに読み込まれます。 |
| DebugSessions.RetrieveIndexerExecutionHistoricalData | インデクサー実行の詳細の要求。 |
| DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData | ナレッジ ストアに投影されるエンリッチメントの実行履歴。 |
| Indexers.* | インデクサーに適用されます。 Create、Delete、Get、List、Status を指定できます。 |
| Indexes.* | 検索インデックスに適用されます。 Create、Delete、Get、List を指定できます。 |
| indexes.Prototype | このインデックスは、データのインポート ウィザードによって作成されます。 |
| Indexing.Index | この操作は、ドキュメントの追加、更新、削除を行うための呼び出しです。 |
| Metadata.GetMetadata | 検索サービス システム データの要求。 |
| Query.Autocomplete | インデックスに対するオートコンプリート クエリ。 クエリの種類と構成に関するページを参照してください。 |
| Query.Lookup | インデックスに対する参照クエリ。 クエリの種類と構成に関するページを参照してください。 |
| Query.Search | インデックスに対するフルテキスト検索要求。 クエリの種類と構成に関するページを参照してください。 |
| Query.Suggest | インデックスに対する先行入力クエリ。 クエリの種類と構成に関するページを参照してください。 |
| ServiceStats | この操作は、サービス統計の取得を直接呼び出すか、ポータルの概要ページが読み込まれたり更新されたりしたときに暗黙的に呼び出されたりするルーチン呼び出しです。 |
| Skillsets.* | スキルセットに適用されます。 Create、Delete、Get、List を指定できます。 |
関連するコンテンツ
- Azure AI Search の監視の説明については、Azure AI Search の監視に関するページを参照してください。
- Azure リソースの監視の詳細については、「Azure Monitor で Azure リソースを監視する」を参照してください。