Azure AI 搜尋服務監視數據參考
本文包含此服務的所有監視參考資訊。
如需您可以針對 Azure AI 搜尋收集的數據，以及如何使用它的詳細資訊，請參閱 監視 Azure AI 搜尋 服務。
計量
本節列出針對此服務的所有自動收集平台計量。 這些計量也是 Azure 監視器中支援的所有平台計量全域清單的一部分。
如需計量保留的相關資訊，請參閱 Azure 監視器計量概觀。
Microsoft.Search/searchServices 支援的計量
下表列出 Microsoft.Search/searchServices 資源類型的可用計量。
- 所有資料行可能不存在於每個資料表中。
- 某些資料行可能超出頁面的檢視區域。 選取 [展開資料表] 以檢視所有可用的資料行。
資料表標題
- 類別 - 計量群組或分類。
- 計量 - Azure 入口網站中顯示的計量顯示名稱。
- REST API 中的名稱 - REST API 中所指的計量名稱。
- 單位 - 測量單位。
- 彙總 - 預設彙總類型。 有效值：平均值 (Avg)、最小值 (Min)、最大值 (Max)、總計 (Sum)、計數。
- 維度 - 計量可用的維度。
- 時間精細度 - 取樣計量的間隔。 例如，
PT1M表示計量會每分鐘取樣、每 30 分鐘PT30M、每小時PT1H，以此類推。 - DS 匯出 - 計量是否可透過診斷設定，匯出至 Azure 監視器記錄。 如需匯出計量的資訊，請參閱在 Azure 監視器中建立診斷設定。
| 計量 | REST API 中的名稱 | 單位 | 彙總 | 維度 | 時間精細度 | DS 匯出 |
|---|---|---|---|---|---|---|
| 文件處理計數 已處理的檔數目 |
DocumentsProcessedCount |
計數 | 總計、計數 | DataSourceName、、 Failed、 IndexerName、 IndexName、 SkillsetName |
PT1M | Yes |
| 搜尋延遲 搜尋服務的平均搜尋延遲 |
SearchLatency |
秒 | 平均 | <none> | PT1M | Yes |
| 每秒搜尋查詢數 搜尋服務的每秒搜尋查詢數 |
SearchQueriesPerSecond |
每秒計數 | 平均 | <none> | PT1M | Yes |
| 技能執行調用計數 技能執行數目 |
SkillExecutionCount |
計數 | 總計、計數 | DataSourceName、、FailedIndexerName、SkillName、、SkillsetName、SkillType |
PT1M | Yes |
| 節流搜尋查詢百分比 針對搜尋服務進行節流處理的搜尋查詢百分比 |
ThrottledSearchQueriesPercentage |
Percent | 平均 | <none> | PT1M | Yes |
SearchQueriesPerSecond 會顯示搜尋服務每秒搜尋查詢的平均 （QPS）。 查詢通常會以毫秒為單位執行，因此只有測量為秒的查詢會出現在 QPS 之類的計量中。 最小值是在該分鐘期間註冊的每秒搜尋查詢最小值。 最大值是最高的值。 平均值是整個分鐘的匯總。
例如，在一分鐘內，您可能會有類似這樣的模式：SearchQueriesPerSecond 最大負載的一秒，後面接著 58 秒的平均負載，最後一秒只有一個查詢，這是最小值。
載入計量維度
如需計量維度是什麼的資訊，請參閱多維度計量。
Azure AI 搜尋具有下列維度，這些維度與擷取執行的檔或技能計數、「文件處理計數」和「技能執行調用計數」相關。
| 維度名稱 | 描述 |
|---|---|
| DataSourceName | 在索引器執行期間使用的具名數據源連接。 有效值為其中一個 支持的數據源類型。 |
| 失敗 | 指出實例是否失敗。 |
| IndexerName | 索引器的名稱。 |
| IndexName | 索引的名稱。 |
| SkillsetName | 索引器執行期間所使用的技能集名稱。 |
| SkillName | 技能集內的技能名稱。 |
| SkillType | @odata.type技能的 。 |
資源記錄
本節列出您可以針對此服務收集的資源記錄類型。 該區段會從 Azure 監視器中支援的所有資源記錄類別類型清單提取。
Microsoft.Search/searchServices 支援的資源記錄
| 類別 | 類別顯示名稱 | 記錄資料表 | 支援基本記錄計劃 | 支援擷取時間轉換 | 範例查詢 | 匯出的成本 |
|---|---|---|---|---|---|---|
OperationLogs |
作業記錄 | AzureDiagnostics 來自多個 Azure 資源的記錄。 |
No | 無 | No |
Azure 監視器記錄資料表
本節列出與這項服務相關的 Azure 監視器記錄數據表，這些數據表可供 Log Analytics 使用 Kusto 查詢進行查詢。 數據表包含資源記錄數據，而且可能更多數據取決於所收集的內容並路由傳送至它們。
搜尋服務
Microsoft.Search/searchServices
| 資料表 | Description |
|---|---|
| AzureActivity | 來自 Azure 活動記錄的專案提供控制平面作業的深入解析。 在控制平面上叫用的工作，例如新增或移除複本和分割區，會透過「取得 管理員 索引鍵」活動來表示。 |
| AzureDiagnostics | 記錄的查詢和索引作業。 對 Log Analytics 中 AzureDiagnostics 數據表的查詢可以包含通用屬性、 搜尋特定屬性，以及 架構參考區段中所列的搜尋特定作業 。 |
| AzureMetrics | Azure AI 搜尋所發出的計量數據，可測量健康情況和效能。 |
資源記錄數據表
下表列出 Azure AI 搜尋服務中資源記錄的屬性。 資源記錄會收集到 Azure 監視器記錄或 Azure 儲存體。 在 Azure 監視器中，記錄會收集在 AzureDiagnostics 數據表中，其資源提供者名稱為 Microsoft.Search。
| Azure 儲存體欄位或屬性 | Azure 監視器記錄屬性 | 描述 |
|---|---|---|
| time | timestamp | 作業發生的日期和時間 (UTC)。 |
| resourceId | Concat（“/”， “/subscriptions”， SubscriptionId， “resourceGroups”， ResourceGroupName， “providers/Microsoft.Search/searchServices”， ServiceName） | 已啟用記錄的 Azure AI 搜尋資源。 |
| category | “OperationLogs” | 記錄類別包括 Audit、 Operational、 Execution和 Request。 |
| operationName | 名稱 | 作業名稱。 工作名稱可以是 Indexes.ListIndexStatsSummaries、、、Indexes.Stats、Query.SearchQuery.SuggestIndexers.ListQuery.Lookup、Indexes.UpdateQuery.AutocompleteCORS.Preflight、ServiceStatsIndexes.Prototype、 。 DataSources.ListIndexers.WarmupIndexes.Get |
| durationMS | DurationMilliseconds | 作業的持續時間 (以毫秒為單位)。 |
| operationVersion | ApiVersion | 要求所使用的 API 版本。 |
| resultType | （失敗） ？ “Failed” ： “Success” | 回應的類型。 |
| resultSignature | 狀態 | 作業的 HTTP 回應狀態。 |
| 內容 | 屬性 | 與這個事件類別相關的任何擴充屬性。 |
活動記錄檔
連結的資料表會列出此服務活動記錄檔中可記錄的操作。 這些操作是活動記錄中的所有可能資源提供者操作的子集。
如需活動記錄項目結構描述的詳細資訊，請參閱活動記錄結構描述。
下表列出與 Azure AI 搜尋相關的常見作業，這些作業可能會記錄在活動記錄中。 如需所有 Microsoft.Search 作業的完整清單，請參閱 Microsoft.Search 資源提供者作業。
| 作業 | 描述 |
|---|---|
| 取得 管理員 金鑰 | 任何需要系統管理許可權的作業都會記錄為「取得 管理員 金鑰」作業。 |
| 取得查詢金鑰 | 針對索引之檔集合的任何唯讀作業。 |
| 重新產生 管理員 金鑰 | 重新產生主要或次要系統管理員 API 金鑰的要求。 |
常見的專案包括 API 金鑰的參考 - 一般資訊通知，例如取得 管理員 金鑰和取得查詢金鑰。 這些活動表示使用系統管理密鑰（建立或刪除物件）或查詢金鑰所進行的要求，但不會顯示要求本身。 如需此粒紋的資訊，您必須設定資源記錄。
或者，您可以透過變更歷程記錄取得一些見解。 在 Azure 入口網站 中，選取活動以開啟詳細數據頁面，然後選取 [變更歷程記錄] 以取得基礎作業的相關信息。
其他架構
下列架構用於此服務。
如果您要建置查詢或自定義報表，則包含 Azure AI 搜尋服務資源記錄的數據結構符合下列架構。
對於傳送至 Blob 記憶體的資源記錄，每個 Blob 都有一個稱為 記錄 的根物件，其中包含記錄對象的陣列。 每個 Blob 都包含相同小時內所執行之所有作業的記錄。
資源記錄結構描述
所有可透過 Azure 監視器取得的資源記錄都會共用通用 的最上層架構。 Azure AI 搜尋補充包含 搜尋服務特有的更多屬性 和 作業 。
下列範例說明包含一般屬性的資源記錄檔（TimeGenerated、Resource、Category 等等）和搜尋特定屬性（OperationName 和 OperationVersion）。
| 名稱 | 類型 | 描述和範例 |
|---|---|---|
| TimeGenerated | Datetime | 作業的時間戳。 例如：2021-12-07T00:00:43.6872559Z |
| 資源 | String | 資源標識碼。 例如：/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 | 「成功」。 其他可能的值：成功或失敗 |
| ResultSignature | int | HTTP 結果碼。 例如：200 |
| DurationMS | int | 作業的期間 (以毫秒為單位)。 |
| 屬性 | Object | 包含作業特定數據的物件。 請參閱下列屬性架構數據表。 |
屬性架構
下列屬性專屬於 Azure AI 搜尋。
| 名稱 | 類型 | 描述和範例 |
|---|---|---|
| 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.* | 適用於索引器數據源。 可以是 [建立]、[刪除]、[取得]、[列表]。 |
| DebugSessions.* | 適用於偵錯會話。 可以是 [建立]、[刪除]、[取得]、[列表]、[開始] 和 [狀態]。 |
| DebugSessions.DocumentStructure | 擴充的檔會載入至偵錯會話。 |
| DebugSessions.RetrieveIndexerExecutionHistoricalData | 索引器執行詳細數據的要求。 |
| DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData | 投影至知識存放區的擴充執行歷程記錄。 |
| 索引。* | 適用於索引器。 可以是 [建立]、[刪除]、[取得]、[列表] 和 [狀態]。 |
| 指標。* | 適用於搜尋索引。 可以是 [建立]、[刪除]、[取得]、[列表]。 |
| 指標。原型 | 此索引是由匯入數據精靈所建立。 |
| Indexing.Index | 此作業是新增 、更新或刪除文件的呼叫。 |
| Metadata.GetMetadata | 搜尋服務系統數據的要求。 |
| Query.Autocomplete | 針對索引自動完成查詢。 請參閱 查詢類型和組合。 |
| Query.Lookup | 針對索引的查閱查詢。 請參閱 查詢類型和組合。 |
| Query.Search | 針對索引的全文搜索要求。 請參閱 查詢類型和組合。 |
| Query.Suggest | 針對索引預先輸入查詢。 請參閱 查詢類型和組合。 |
| ServiceStats | 這項作業是直接呼叫或隱含呼叫 Get Service Statistics 的例程呼叫，以在載入或重新整理入口網站概觀頁面時填入入口網站概觀頁面。 |
| Skillsets.* | 適用於技能集。 可以是 [建立]、[刪除]、[取得]、[列表]。 |
相關內容
- 如需監視 Azure AI 搜尋的描述，請參閱 監視 Azure AI 搜尋 。
- 如需監視 Azure 資源的詳細資訊，請參閱使用 Azure 監視器來監視 Azure 資源。