設定 Foundry IQ(Azure AI 搜尋服務)的診斷記錄

附註

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

診斷日誌可讓您深入了解在 Foundry IQ(Azure AI 搜尋服務)資源中發生的作業。 與在訂閱層級(稱為控制平面)追蹤 Azure 資源上所執行作業的活動日誌不同,診斷記錄會監控 Foundry IQ 服務本身上的作業。 診斷記錄對於對索引編製和查詢等服務作業的有效監督至關重要。

本文說明如何啟用診斷記錄,並尋找 Foundry IQ 資源上系統與使用者操作的相關資訊。

附註

Foundry IQ 不會記錄存取 Foundry IQ 服務內容或操作的個人或應用程式的身份。 如果您需要此層級的監視,就必須在用戶端應用程式中加以實作。

先決條件

啟用診斷記錄

  1. 前往 Azure 入口網站中的 Foundry IQ 服務。

  2. 在 [監視]>[診斷設定] 底下,選取 [新增診斷設定]。

  3. 提供描述性名稱,以識別記錄服務和記錄層級,例如 「my-search-service-all-logs」 或 「my-search-service-audit-logs」。。

  4. 在 [記錄] 底下,選擇類別:

    • 稽核記錄記錄 使用者或應用程式與資料或服務設定的互動,但不包含使用者或群組的身份。
    • 作業記錄會擷取 Foundry IQ 服務上相關作業的資訊。
    • allLogs 會收集所有內容。

    詳細資訊記錄的儲存成本可能很昂貴,且管理及儲存方式複雜。 您可能想要從 allLogs 開始,然後在它符合資訊需求時切換至更多範圍記錄。 如需這些類別的詳細資訊,請參閱 Azure 監視器中的診斷設定。

  5. 針對目的地,建議您傳送至 Log Analytics 工作區,以便對資料執行 Kusto 查詢。 提供現有的Log Analytics工作區來儲存您的記錄。

  6. 儲存設定。

如果您需要更全面的資料收集策略,請重複這些步驟。

您建立的每個診斷設定都需要個別的記憶體。 如果您使用 Azure 入口網站來檢閱記錄,預設會使用第一個診斷設定。 您可以瀏覽至特定工作區以取得視覺效果支援。

附註

如果您使用 基於金鑰的驗證,Foundry IQ 無法監控個別使用者對 Foundry IQ 服務內容的存取。 如果您需要此層級的監視,就必須在用戶端應用程式中加以實作。

檢視 Log Analytics 中的記錄

請依照以下指示,探索您 Foundry IQ 服務的日誌分析資料。

  1. 在 [監視] 底下,選取 [記錄]。 查詢中樞預設會開啟。 您可以嘗試可用的查詢,或關閉中樞,並在 KQL 模式中開啟查詢視窗,以執行以 Kusto 查詢語言 (KQL) 撰寫的查詢。

    Azure 入口網站查詢總管中 KQL 模式選項的螢幕擷圖。

  2. 在查詢視窗中,您可以對記錄執行 Kusto 查詢。

    Azure 入口網站中查詢與結果的截圖。

範例 Kusto 查詢

以下是一些您可以用來探索記錄資料的基本 Kusto 查詢。

執行此查詢,以查看指定期間內 Foundry IQ 服務的所有診斷記錄:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.SEARCH"

執行此查詢以查看 10 個最新的記錄:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.SEARCH"
| take 10

執行此查詢,以便依 [資源] 將作業分組:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.SEARCH" |
summarize count() by Resource

執行此查詢以找出執行作業所需的平均時間:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.SEARCH"
| summarize avg(DurationMs)
by OperationName

執行此查詢,以檢視一段時間內依 OperationName 分割的作業量,每 10 秒計數一次。

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.SEARCH"
| summarize count()
by bin(TimeGenerated, 10s), OperationName
| render areachart kind=unstacked