Foundry IQ(Azure AI 搜尋服務)監控資料參考

Note

Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。

本文包含本服務的所有監測參考資訊。

請參閱「監控 Foundry IQ(Azure AI 搜尋服務)」,了解您可以為 Foundry IQ 收集的資料以及如何使用。

指標

本節列出所有自動收集的平台指標。 這些指標同時也是全球 Azure 監視器 支援的所有平台指標清單的一部分。

有關指標保留的資訊,請參閱 Azure 監視器 指標概覽。

支援的度量標準為 Microsoft.Search/searchServices

下表列出了 Microsoft.Search/searchServices 資源類型可用的指標。

  • 並非所有欄位都存在於每張表格中。
  • 有些欄位可能超出頁面的視野範圍。 選擇 展開表格 以查看所有可用欄位。

表格標題

  • 類別 - 指標群組或分類。
  • 計量 - Azure 入口網站中顯示的計量顯示名稱。
  • REST API 中名稱 - REST API 中用來參考的計量名稱。
  • 單位 - 量值單位。
  • 匯總 - 預設 匯總 類型。 有效數值:平均(平均)、最小(最小)、最大(最大)、總(總和)、計數。
  • 指標 - 指標的可用維度。
  • 時間粒度 - 度量取樣的間隔。 例如,表示 PT1M 指標每分鐘、 PT30M 每 30 分鐘、 PT1H 每小時抽樣一次,依此類推。
  • DS 匯出 - 該計量是否可透過診斷設定匯出至 Azure 監視器 Logs。 有關匯出指標的資訊,請參閱 在 Azure 監視器 建立診斷設定。
公制 REST API 中的名稱 進階平台指標 單位 聚合 尺寸 時間顆粒 DS 匯出
索引器已處理的檔案(位元組)

索引器從檔案式資料來源(例如 Blob、ADLS Gen2、File、SharePoint、OneLake)處理的原始資料總位元組數
DocumentsProcessedBytes 不 Bytes 總計(合計),平均 DataSourceName、IndexerName、IndexName PT1M 是的
已處理文件數

處理文件數量
DocumentsProcessedCount 不 計數 總計 (總和)、計數 DataSourceName、、 Failed、 IndexerName、 IndexName、 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 是的

每秒搜尋查詢次數

此指標顯示 Foundry IQ 服務每秒搜尋查詢次數(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 來取得未執行的查詢百分比。

聚合類型 節流
平均 在間隔內遭到捨棄的查詢百分比。
計數 在一分鐘間隔內發送到記錄的計量數量。
極限 在間隔內遭到捨棄的查詢百分比。
最低限度 在間隔內遭到捨棄的查詢百分比。
總計 在間隔內遭到捨棄的查詢百分比。

對於 限速搜尋查詢百分比,最小、最大、平均和總數都是相同的數值:從一分鐘內搜尋查詢總數中,被限速的搜尋查詢百分比。

運算單元使用量

計算單元使用指標(AggregateComputeUnits)用於衡量您的 Foundry IQ 服務耗用的運算、記憶體及 I/O 資源。 它以毫計算單位(mCUs)表示資料。 此指標提供消耗的診斷視角,而非發票金額。 使用量會隨時間變化,取決於你執行的操作類型。

對於符合資格的付費無伺服器索引器執行,請將服務彙總使用情況與排程、執行歷史、處理項目及來源資料量相關聯。 不要根據獨立的文件與技能計數指標上的 IndexerName 維度來推斷每個索引器的計算單位。 索引器狀態與服務統計中的執行秒數衡量的是配額,而非計算計費。 請參閱 索引器計算可觀察性。

你可以從兩個層級來看待這個指標:

  • Foundry IQ 服務層級:整個服務的運算消耗彙整。
  • 索引層級:限於特定索引的使用量,有助於辨識哪些索引占用最多資源。
聚合類型 描述
總和 在選定時間區間內消耗的 mCU 總數。 有助於理解整體計算成本隨時間變化。
平均 在選定時間區間內平均消耗的 mCU。

此指標支援以下篩選條件:

  • 索引名稱:將此指標篩選至特定索引。 若未套用濾波器,指標會反映服務中所有索引的總用量。

  • 操作名稱:依據對計算消耗有貢獻的操作來篩選指標。 若未套用篩選器,指標會反映各作業類型合併的消耗量。 資源日誌操作名稱並非支援的指標維度值清單。

公制尺寸

關於什麼是度量維度,請參見 多維度量。

Foundry IQ 具有與下列指標相關的維度,用以記錄執行的文件或技能數量。

指標名稱 描述 尺寸 範例使用案例
文件處理數量 顯示已處理索引文件的數量。 資料來源名稱、錯誤、索引名稱、索引程序名稱、技能設定名稱 可作為吞吐量的粗略衡量指標(索引器隨時間處理的文件數量)
- 設定對失敗文件發出警示
技能執行叫用次數 顯示技能召喚次數。 資料來源名稱、失敗、索引名稱、索引器名稱、技能名稱、技能類型、技能組名稱 可作為參考,透過比較技能之間的相對調用數,以及將技能調用數與文件數量進行比較,以確保技能如預期被調用。
- 設定為對失敗的技能召喚發出警示
計算單位使用 顯示 Foundry IQ 服務上作業所消耗的 mCUs 索引名稱,操作 評估哪個操作消耗了最多的運算。
- 當污泥消耗超過特定作業類型的預期閾值時,設置警示
維度名稱 描述
DataSourceName 在索引器執行時使用的命名資料來源連線。 有效值是 支援的資料來源類型之一。
失敗 顯示該實例是否失敗。
索引器名稱 索引者的名字。
索引名稱 索引名稱。
技能組名稱 索引器執行時使用的技能組名稱。
SkillName 技能組合內的某個技能名稱。
技能類型 技能的 @odata.type。

資源日誌

本節列出您可以為此服務收集的資源日誌類型。 本節從 Azure 監視器 支援的 所有資源日誌類別類型列表中擷取資料。

Microsoft.Search/searchServices 的支援資源記錄

分類 出口成本 對數表 支援基本記錄方案 支援擷取時轉換 範例查詢
作業日誌 不 AzureDiagnostics

來自多個 Azure 資源的日誌。

不 不

Azure 監控日誌表格

本節列出與此服務相關的 Azure 監視器 日誌資料表,可以使用 Log Analytics 以 Kusto 查詢來查詢這些資料表。 這些資料表包含資源日誌資料,可能還有更多資料,視收集和路由到的資料而定。

搜尋服務

Microsoft。搜尋/搜尋服務

表格 描述
AzureActivity Azure 活動日誌中的條目提供有關控制平面操作的見解。 控制平面上呼叫的任務,例如新增或移除複本與分割區,則透過「取得管理金鑰」活動來表示。
AzureDiagnostics 記錄查詢與索引操作。 對 AzureDiagnostics 表格的查詢可包含 Log Analytics 中常見屬性、search 專屬屬性,以及結構參考區塊列出的 search 特定操作。
AzureMetrics 由 Foundry IQ 輸出的指標數據,用來衡量健康與表現。

資源日誌表

下表列出 Foundry IQ 中資源日誌的屬性。 資源日誌會被收集到 Azure 監視器 Logs 或 Azure 儲存體。 在 Azure 監視器中,記錄會收集在 AzureDiagnostics 資料表內,並位於資源提供者名稱 Microsoft.Search 之下。

Azure 儲存體 欄位或屬性 Azure 監視器 Logs 屬性 描述
時間 時間戳記 行動發生的日期與時間(UTC)。
resourceId(資源識別) Concat(“/”, “/subscriptions”, SubscriptionId, “resourceGroups”, ResourceGroupName, “providers/Microsoft.Search/searchServices”, ServiceName) 已啟用日誌的 Foundry IQ 資源。
分類 「行動日誌」 對數類別包括 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 回應狀態。
屬性 屬性 與此類事件相關的任何擴充屬性。

活動日誌

連結表列出可記錄於此服務活動日誌中的操作。 這些操作是 活動日誌中所有可能的資源提供者操作的子集。

欲了解更多活動日誌條目的結構,請參見 活動日誌結構。

下表列出可能記錄在活動日誌中、與 Foundry IQ 相關的常見操作。 要查閱所有 Microsoft.Search 作業的完整清單,請參見Microsoft.Search 資源提供者作業。

操作 描述
取得管理金鑰 任何需要管理員權限的操作都會被記錄為「取得管理員金鑰」操作。
取得查詢鍵 任何針對索引庫的文件集合的唯讀操作。
重新生成管理金鑰 請求重新產生主或次要管理 API 金鑰。

常見的條目包括對 API 金鑰的引用——像是 取得管理員金鑰 和 查詢金鑰這類通用資訊通知。 這些活動表示使用管理金鑰(建立或刪除物件)或查詢金鑰提出的請求,但不會顯示請求本身。 若要取得此粒度的資訊,您必須設定資源記錄。

或者,你也可以透過變更歷史獲得一些洞見。 在 Azure 入口網站中,選擇活動以開啟詳細頁面,然後選擇「變更歷史」以獲取底層操作的資訊。

其他模式

以下架構用於此服務。

如果您正在建立查詢或自訂報表,包含 Foundry IQ 資源記錄的資料結構會符合以下結構。

對於送入 blob 儲存的資源日誌,每個 blob 有一個稱為 記錄 的根物件,包含日誌物件陣列。 每個區塊包含同一小時內所有操作的紀錄。

資源日誌架構

所有透過 Azure 監視器 提供的資源日誌都共用一個 common 頂層結構。 Foundry IQ 另外包含 Foundry IQ 服務獨有的 更多屬性 與 作業。

以下範例說明一個資源日誌,包含常見屬性(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-10-01
結果類型 弦 「成功」。 其他可能的價值觀:成功或失敗
結果簽名 整數 HTTP 結果碼。 例如: 200
DurationMS 整數 手術持續時間以毫秒計。
屬性 目的 包含特定操作資料的物件。 請參閱以下屬性結構表。

屬性結構

以下屬性為 Foundry IQ 專屬。

名稱 類型 描述與範例
Description_s 弦 行動的終點。 例如: GET /indexes('content')/docs
Documents_d 整數 處理的文件數量。
IndexName_s 弦 與操作相關的索引名稱。
Query_s 弦 請求中使用的查詢參數。 例如: ?search=beach access&$count=true&api-version=2026-10-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 Foundry IQ 服務系統資料的請求。
查詢·自動完成 對索引的自動補全查詢。 請參見 查詢類型與組成。
Query.Lookup 針對索引的查閱查詢。 請參見 查詢類型與組成。
查詢.搜索 針對索引的全文檢索要求。 請參見 查詢類型與組成。
Query.Suggest 預先輸入查詢,針對索引。 請參見 查詢類型與組成。
服務統計 此操作是例行呼叫 Get Service Statistics,可直接或隱含用於載入或刷新入口網站總覽頁面。
技能組合。* 套用至技能集。 可為 Create、Delete、Get、List。