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 |
每秒搜尋查詢數
此計量會顯示搜尋服務的每秒搜尋查詢平均數 （QPS）。 查詢通常會以毫秒為單位執行，因此只有測量為秒的查詢會出現在 QPS 之類的計量中。 最小值是在該分鐘期間註冊的每秒搜尋查詢最小值。 最大值是最高的值。 平均值是整個分鐘的匯總。
| 彙總類型 | 描述 |
|---|---|
| 平均 | 查詢執行期間，一分鐘內的平均秒數。 |
| 計數 | 一分鐘間隔內發給記錄的計量數目。 |
| 最大值 | 一分鐘內註冊的每秒搜尋查詢數目上限。 |
| 最小值 | 一分鐘內註冊的每秒搜尋查詢數目下限。 |
| Sum | 在一分鐘內執行的所有查詢總和。 |
例如，在一分鐘內，您可能會有如下的模式：有 1 秒出現極高的負載，這是 SearchQueriesPerSecond 的最大值，接著有 58 秒的平均負載，最後的 1 秒只有一個查詢，而這會是最小值。
另一個範例：如果節點發出 100 個計量，其中每個計量的值是 40，則「Count」為 100，「Sum」為 4000，「Average」為 40，而「Max」為 40。
搜尋延遲
搜尋延遲表示查詢需要多久的時間才能完成。
| 彙總類型 | Latency |
|---|---|
| 平均 | 平均查詢持續時間 (以毫秒為單位)。 |
| 計數 | 一分鐘間隔內發給記錄的計量數目。 |
| 最大值 | 範例中執行時間最長的查詢。 |
| 最小值 | 範例中執行時間最短的查詢。 |
| 總數 | 範例中所有查詢的總執行時間，是在間隔內執行的 (一分鐘)。 |
節流搜尋查詢百分比
此計量是指捨棄而不是處理的查詢。 當執行中的要求數目超過容量時，就會發生節流。 當複本從輪替或編製索引期間取出時，您可能會看到節流要求增加。 查詢和索引要求都是由同一組資源處理。
服務會根據資源使用量來判斷是否要卸除要求。 系統將計算一段時間內的平均記憶體、CPU 和磁碟 IO 已使用的資源百分比。 如果這個百分比超過閾值，則索引的所有要求都會受到節流，直到要求量降低為止。
視您的用戶端而定，節流要求可以透過下列方式指出：
- 服務會傳回錯誤
"You are sending too many requests. Please try again later." - 服務會傳回 503 錯誤碼，指出服務目前無法使用。
- 如果您使用入口網站 (例如搜尋總管)，則會以無訊息方式卸除查詢，您必須再次選取 [搜尋]。
若要確認節流查詢，請使用節流搜尋查詢計量。 如本文所述，您可以在入口網站中探索計量，或建立警示計量。 對於在取樣間隔內卸除的查詢，請使用 Total 來取得未執行的查詢百分比。
| 彙總類型 | 節流 |
|---|---|
| 平均 | 在間隔內捨棄的查詢百分比。 |
| 計數 | 一分鐘間隔內發給記錄的計量數目。 |
| 最大值 | 在間隔內捨棄的查詢百分比。 |
| 最小值 | 在間隔內捨棄的查詢百分比。 |
| 總數 | 在間隔內捨棄的查詢百分比。 |
針對節流的搜尋查詢百分比，最小值、最大值、平均值和總計全是相同的值：一分鐘內的搜尋查詢總數中，已節流的搜尋查詢百分比。
載入計量維度
如需計量維度是什麼的資訊，請參閱多維度計量。
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 版本。 例如：2024-07-01 |
| 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=2024-07-01 |
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 資源。