Note
Azure AI 搜尋服務 可透過 Azure 入口網站、REST API 及 Azure SDK 取得。 它同時也是 Foundry IQ 的基礎，這是一個管理式知識層，能將企業內容轉化為可重複使用、權限感知的知識庫，供 Microsoft Foundry 入口網站中的代理使用。
本文包含本服務的所有監測參考資訊。
請參閱 監控 Azure AI 搜尋服務，以了解可收集的 Azure AI 搜尋服務 資料及其使用方法的詳細資訊。
指標
本節列出所有自動收集的平台指標。 這些指標同時也是全球 Azure 監視器 支援的所有平台指標清單的一部分。
有關指標保留的資訊，請參閱 Azure 監視器 指標概覽。
支援的度量標準為 Microsoft.Search/searchServices
下表列出了 Microsoft.Search/searchServices 資源類型可用的指標。
- 並非所有欄位都存在於每張表格中。
- 有些欄位可能超出頁面的視野範圍。 選擇 展開表格 以查看所有可用欄位。
表格標題
- 類別 - 指標群組或分類。
- Metric - Azure入口中顯示的度量顯示名稱。
- REST API 中的名稱 - REST API 中所指的指標名稱。
- 單位 - 計量單位。
- 聚合 - 預設的 聚合 類型。 有效數值：平均（平均）、最小（最小）、最大（最大）、總（總和）、計數。
- 維度 - - 指標可用的維度。
-
時間顆粒 - 度量取樣的區間。 例如，表示
PT1M指標每分鐘、PT30M每 30 分鐘、PT1H每小時抽樣一次，依此類推。 - DS 匯出- 指標是否能透過診斷設定匯出到 Azure 監視器 日誌。 有關匯出指標的資訊，請參閱 在 Azure 監視器 建立診斷設定。
| 公制 | REST API 中的名稱 | 進階平台指標 | 單位 | 聚合 | 尺寸 | 時間顆粒 | DS 匯出 |
|---|---|---|---|---|---|---|---|
|
索引器處理檔案（位元組） 索引器從檔案式資料來源（例如 Blob、ADLS Gen2、File、SharePoint、OneLake）處理的原始資料總位元組數 |
DocumentsProcessedBytes |
不 | Bytes | 總計（合計），平均 |
DataSourceName、IndexerName、IndexName |
PT1M | 是的 |
|
文件處理次數 處理文件數量 |
DocumentsProcessedCount |
不 | 計數 | 總計 (總和)、計數 |
DataSourceName， Failed， ， IndexerNameIndexName，SkillsetName |
PT1M | 是的 |
|
儲存空間使用量 搜尋服務依索引使用的儲存空間（文字+向量） |
IndexStorageUsage |
不 | Bytes | 平均值、最大值、最小值 | IndexName |
PT1M | 是的 |
|
向量儲存的使用 搜尋服務依索引的向量儲存使用情況 |
IndexVectorUsage |
不 | Bytes | 平均值、最大值、最小值 | IndexName |
PT1M | 是的 |
|
使用的運算單元 搜尋服務作業和索引預熱視窗所耗用的計算單位，以微 CU 小時計 (將總數除以 1,000,000 即可得出 CU 小時)。 狀態過濾器已被棄用。 |
PerRequestComputeConsumption |
不 | 計數 | 總計（合計），平均 |
Status、IndexName、ResourceKind、EventType |
PT1M | 是的 |
|
搜尋延遲 搜尋服務的平均搜尋延遲 |
SearchLatency |
不 | 秒數 | 平均 | <沒有> | PT1M | 是的 |
|
每秒搜尋查詢次數 搜尋服務的每秒搜尋查詢數 |
SearchQueriesPerSecond |
不 | 每秒計數 | 平均 | <沒有> | PT1M | 是的 |
|
技能執行召喚次數 技能執行次數 |
SkillExecutionCount |
不 | 計數 | 總計 (總和)、計數 |
DataSourceName， Failed， IndexerName， SkillName， SkillsetName， SkillType |
PT1M | 是的 |
|
搜尋請求限制百分比 搜尋服務中遭到節流的搜尋查詢百分比 |
ThrottledSearchQueriesPercentage |
不 | 百分比 | 平均 | <沒有> | PT1M | 是的 |
每秒搜尋查詢次數
此指標顯示搜尋服務每秒搜尋查詢數的平均值（QPS）。 查詢通常以毫秒為單位，因此只有以秒為單位的查詢會出現在像 QPS 這樣的指標中。 最低值是該分鐘內每秒搜尋查詢數的最低值。 最大值是最高值。 平均值是整分鐘的總和。
| 聚合類型 | 描述 |
|---|---|
| 平均 | 查詢執行在一分鐘內平均發生的秒數。 |
| 計數 | 在一分鐘間隔內發送到記錄的計量數量。 |
| 極限 | 在某分鐘內每秒記錄的最高搜尋查詢數。 |
| 最低限度 | 每分鐘內記錄的每秒搜尋查詢數的最低值。 |
| 總和 | 即在該分鐘內執行的所有查詢總和。 |
例如，在一分鐘內，你可能會遇到這樣的模式：有一秒鐘的高負載，是 SearchQueriesPerSecond 的最大值，接著是 58 秒的平均負載，最後是一秒鐘內只有一筆查詢，這是最小值。
另一個例子：如果一個節點輸出 100 個指標，每個指標的值是 40，則「計數」為 100，「總和」為 4000，「平均」為 40，「最大」為 40。
搜尋延遲
搜尋延遲表示查詢完成所需的時間。
| 聚合類型 | 延遲 |
|---|---|
| 平均 | 平均查詢時間以毫秒計。 |
| 計數 | 在一分鐘間隔內發送到記錄的計量數量。 |
| 極限 | 樣本中持續時間最長的查詢。 |
| 最低限度 | 樣本中執行時間最短的查詢。 |
| 總計 | 樣本中所有查詢的總執行時間，且在區間內（一分鐘）內執行。 |
受限制的搜尋查詢百分比
此指標指的是被丟棄而非處理的查詢。 當執行中的請求數量超過容量時，就會發生限速。 當某個複本退出輪替或在建立索引期間，您可能會看到已節流要求增加。 查詢與索引請求皆由同一組資源處理。
服務會根據資源消耗決定是否丟棄請求。 記憶體、CPU 與磁碟 IO 所消耗的資源百分比會在一段時間內平均計算。 若此百分比超過閾值，所有索引請求都會被限速，直到請求量減少為止。
視您的用戶端而定，已節流要求會以下列方式呈現：
- 服務會回傳錯誤
"You are sending too many requests. Please try again later." - 服務會回傳 503 錯誤代碼，表示該服務目前無法使用。
- 如果你使用Azure入口網站（例如搜尋總管），查詢會被靜默丟棄，你需要再次選擇Search。
若要確認已節流查詢，請使用已節流搜尋查詢計量。 你可以在 Azure 入口網站中探索指標，或依本文所述建立警示指標。 對於在抽樣區間內被丟棄的查詢，使用 Total 來取得未執行的查詢百分比。
| 聚合類型 | 節流 |
|---|---|
| 平均 | 在間隔內遭到捨棄的查詢百分比。 |
| 計數 | 在一分鐘間隔內發送到記錄的計量數量。 |
| 極限 | 在間隔內遭到捨棄的查詢百分比。 |
| 最低限度 | 在間隔內遭到捨棄的查詢百分比。 |
| 總計 | 在間隔內遭到捨棄的查詢百分比。 |
對於 限速搜尋查詢百分比，最小、最大、平均和總數都是相同的數值：從一分鐘內搜尋查詢總數中，被限速的搜尋查詢百分比。
運算單元使用量
此指標衡量您的 Azure AI 搜尋服務 服務所消耗的運算、記憶體及 I/O 資源，以毫計算單位（mCUs）表示。 它可作為不同作業類型處理成本的替代指標。 使用情況會隨時間變化，取決於執行的操作類型。
你可以從兩個層級來看待這個指標：
- 搜尋服務層級：整個服務的運算消耗整合。
- 指數層級：針對特定指數的消費量，有助於辨識哪些指數驅動最多資源使用。
| 聚合類型 | 描述 |
|---|---|
| 總和 | 在選定時間區間內消耗的 mCU 總數。 有助於理解整體計算成本隨時間變化。 |
| 平均值 | 在選定時間區間內平均消耗的 mCU。 |
此指標支援以下篩選條件：
索引名稱：將指標篩選到特定索引。 若未套用濾波器，指標會反映服務中所有索引的總用量。
操作名稱：根據計算消耗的操作來篩選指標。 若未套用濾波器，指標反映所有操作類型的總用電量。 有關支援值，請參見 監控資料參考。
公制尺寸
關於什麼是度量維度，請參見 多維度量。
Azure AI 搜尋服務 具有與以下指標相關的維度，這些指標用以統計執行的文件或技能數量。
| 指標名稱 | 描述 | 尺寸 | 範例使用案例 |
|---|---|---|---|
| 文件處理次數 | 顯示已處理索引文件的數量。 | 資料來源名稱、錯誤、索引名稱、索引程序名稱、技能設定名稱 | 可作為吞吐量的粗略衡量指標（索引器隨時間處理的文件數量） - 設定對失敗文件發出警示 |
| 技能執行召喚次數 | 顯示技能召喚次數。 | 資料來源名稱、失敗、索引名稱、索引器名稱、技能名稱、技能類型、技能組名稱 | 可作為參考，透過比較技能之間的相對調用數，以及將技能調用數與文件數量進行比較，以確保技能如預期被調用。 - 設定為對失敗的技能召喚發出警示 |
| 計算單位使用 | 顯示搜尋服務操作所消耗的 mCU | 索引名稱，操作 | 評估哪個操作消耗了最多的運算。 - 當污泥消耗超過特定作業類型的預期閾值時，設置警示 |
| 維度名稱 | 描述 |
|---|---|
| 資料來源名稱 | 在索引器執行時使用的命名資料來源連線。 有效值是 支援的資料來源類型之一。 |
| 失敗 | 顯示該實例是否失敗。 |
| 索引名 | 索引者的名字。 |
| 索引名稱 | 索引名稱。 |
| 技能組名稱 | 索引器執行時使用的技能組名稱。 |
| 技能名稱 | 技能組合內的某個技能名稱。 |
| 技能類型 | 技能的 @odata.type。 |
資源日誌
本節列出您可以為此服務收集的資源日誌類型。 本節從 Azure 監視器 支援的
Microsoft.Search/searchServices 的支援資源記錄
| 分類 | 出口成本 | 對數表 | 支援基本日誌方案 | 支援吞入時間轉換 | 範例查詢 |
|---|---|---|---|---|---|
| 作業日誌 | 不 |
AzureDiagnostics 來自多個 Azure 資源的日誌。 |
不 | 不 |
Azure 監控日誌表格
本節列出與此服務相關的 Azure 監視器 日誌資料表，可以使用 Log Analytics 以 Kusto 查詢來查詢這些資料表。 這些資料表包含資源日誌資料，可能還有更多資料，視收集和路由到的資料而定。
搜尋服務
Microsoft。搜尋/搜尋服務
| 表格 | 描述 |
|---|---|
| AzureActivity | Azure 活動日誌中的條目提供有關控制平面操作的見解。 控制平面上呼叫的任務，例如新增或移除複本與分割區，則透過「取得管理金鑰」活動來表示。 |
| AzureDiagnostics | 記錄查詢與索引操作。 對 AzureDiagnostics 表格的查詢可包含 Log Analytics 中常見屬性、search 專屬屬性，以及結構參考區塊列出的 search 特定操作。 |
| AzureMetrics | Azure AI 搜尋服務 所產生的衡量健康與績效的指標資料。 |
資源日誌表
下表列出 Azure AI 搜尋服務 中資源日誌的屬性。 資源日誌會被收集到 Azure 監視器 Logs 或 Azure 儲存體。 在 Azure 監視器中，記錄會收集在 AzureDiagnostics 資料表內，並位於資源提供者名稱 Microsoft.Search 之下。
| Azure 儲存體 欄位或屬性 | Azure 監視器 Logs 屬性 | 描述 |
|---|---|---|
| 時間 | 時間戳記 | 行動發生的日期與時間（UTC）。 |
| resourceId（資源識別） | Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) | 已啟用記錄的 Azure AI 搜尋資源。 |
| 分類 | 「行動日誌」 | 對數類別包括 Audit、 Operational、 Execution和 Request。 |
| 作業名稱 | 名稱 | 行動名稱。 操作名稱可以為 Indexes.ListIndexStatsSummaries， Indexes.Get， Indexes.Stats， Indexers.ListQuery.SearchQuery.SuggestQuery.LookupQuery.AutocompleteCORS.PreflightIndexes.UpdateIndexes.PrototypeServiceStatsDataSources.List， 。 Indexers.Warmup |
| durationMS | 持續時間毫秒 | 手術持續時間，以毫秒計。 |
| operationVersion | ApiVersion | 請求中使用的 API 版本。 |
| 結果類型 | （失敗）？ 「失敗」：「成功」 | 回應的類型。 |
| 結果簽名 | 現況 | 操作的 HTTP 回應狀態。 |
| 屬性 | 屬性 | 與此類事件相關的任何擴充屬性。 |
活動日誌
連結表列出可記錄於此服務活動日誌中的操作。 這些操作是 活動日誌中所有可能的資源提供者操作的子集。
欲了解更多活動日誌條目的結構，請參見 活動日誌結構。
下表列出了與 Azure AI 搜尋服務 相關的常見操作，這些操作可能會記錄在活動日誌中。 要查閱所有 Microsoft.Search 作業的完整清單，請參見Microsoft.Search 資源提供者作業。
| 操作 | 描述 |
|---|---|
| 取得管理金鑰 | 任何需要管理員權限的操作都會被記錄為「取得管理員金鑰」操作。 |
| 取得查詢鍵 | 任何針對索引庫的文件集合的唯讀操作。 |
| 重新生成管理金鑰 | 請求重新產生主或次要管理 API 金鑰。 |
常見的條目包括對 API 金鑰的引用——像是 取得管理員金鑰 和 查詢金鑰這類通用資訊通知。 這些活動表示使用管理金鑰（建立或刪除物件）或查詢金鑰提出的請求，但不會顯示請求本身。 若要取得此粒度的資訊，您必須設定資源記錄。
或者，你也可以透過變更歷史獲得一些洞見。 在 Azure 入口網站中，選擇活動以開啟詳細頁面，然後選擇「變更歷史」以獲取底層操作的資訊。
其他模式
以下架構用於此服務。
如果你正在建立查詢或自訂報告，包含 Azure AI 搜尋服務 資源日誌的資料結構會符合以下結構。
對於送入 blob 儲存的資源日誌，每個 blob 有一個稱為 記錄 的根物件，包含日誌物件陣列。 每個區塊包含同一小時內所有操作的紀錄。
資源日誌架構
所有透過 Azure 監視器 提供的資源日誌都共用一個 common 頂層結構。 Azure AI 搜尋服務增強了更多屬性和操作，這些都是搜尋服務獨有的。
以下範例說明一個資源日誌，包含常見屬性（TimeGenerated、Resource、Category 等）及搜尋專屬屬性（OperationName 和 OperationVersion）。
| 名稱 | 類型 | 描述與範例 |
|---|---|---|
| 時間生成 | 約會時間 | 操作的時間戳記。 例如： 2021-12-07T00:00:43.6872559Z |
| 資源 | 弦 | 資源識別。 例如： /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name> |
| 分類 | 弦 | 「行動日誌」。 這個數值是固定不變的。 OperationLogs 是唯一用於資源日誌的分類。 |
| 作業名稱 | 弦 | 操作名稱（詳見 完整操作列表）。 舉例來說 Query.Search |
| 運作版本 | 弦 | 請求中使用的 API 版本。 例如： 2026-04-01 |
| 結果類型 | 弦 | 「成功」。 其他可能的價值觀：成功或失敗 |
| 結果簽名 | 整數 | HTTP 結果碼。 例如： 200 |
| DurationMS | 整數 | 手術持續時間以毫秒計。 |
| 屬性 | 目的 | 包含特定操作資料的物件。 請參閱以下屬性結構表。 |
屬性結構
以下屬性是 Azure AI 搜尋服務 專屬的。
| 名稱 | 類型 | 描述與範例 |
|---|---|---|
| Description_s | 弦 | 行動的終點。 例如： GET /indexes('content')/docs |
| Documents_d | 整數 | 處理的文件數量。 |
| IndexName_s | 弦 | 與操作相關的索引名稱。 |
| Query_s | 弦 | 請求中使用的查詢參數。 例如： ?search=beach access&$count=true&api-version=2026-04-01 |
OperationName 值（已記錄的操作）
以下操作可以出現在資源日誌中。
| 作業名稱 | 描述 |
|---|---|
| 資料來源。* | 適用於索引器資料來源。 可為 Create、Delete、Get、List。 |
| DebugSessions.* | 適用於偵錯工作階段。 可為 Create、Delete、Get、List、Start 與 Status。 |
| DebugSessions.文件結構 | 已豐富化文件會載入到偵錯工作階段。 |
| DebugSessions.RetrieveIndexerExecutionHistoricalData | 索引子執行詳細資料的要求。 |
| DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData | 投影到知識存放區的豐富化執行歷程記錄。 |
| 索引者。* | 適用於索引器。 可以是「建立」、「刪除」、「取得」、「列出」和「狀態」。 |
| 索引。* | 適用於搜尋索引。 可為 Create、Delete、Get、List。 |
| indexes.Prototype | 索引元資料由 匯入資料 精靈根據資料輸入定義。 |
| Indexing.Index | 此操作即為呼叫索引文件。 |
| Metadata.GetMetadata | 搜尋服務系統資料的請求。 |
| 查詢·自動完成 | 對索引的自動補全查詢。 請參見 查詢類型與組成。 |
| Query.Lookup | 針對索引的查閱查詢。 請參見 查詢類型與組成。 |
| 查詢.搜索 | 針對索引的全文檢索要求。 請參見 查詢類型與組成。 |
| Query.Suggest | 預先輸入查詢，針對索引。 請參見 查詢類型與組成。 |
| 服務統計 | 此操作是例行呼叫 Get Service Statistics，可直接或隱含用於載入或刷新入口網站總覽頁面。 |
| 技能組合。* | 套用至技能集。 可為 Create、Delete、Get、List。 |
相關內容
- 有關監測Azure AI 搜尋服務的說明，請參見監測Azure AI 搜尋服務。
- 若需有關監控 Azure 資源的詳細資訊，請參閱 使用 Azure 監視器 監控 Azure 資源。