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。 |
相關內容
- 有關監控 Foundry IQ 的說明,請參閱 Monitor Foundry IQ 。
- 若需有關監控 Azure 資源的詳細資訊,請參閱 使用 Azure 監視器 監控 Azure 資源。