在 Azure Data Lake Storage 中設定錯誤記錄
本文告訴您如何設定 Azure Data Lake Storage 帳戶,以允許智慧建議將錯誤記錄資料寫入其中。
客戶目前可以查看與資料擷取程序相關的錯誤記錄,以及可讓您分析模型效能的模型評估記錄。
若要啟用智慧建議記錄功能,您必須先將智慧建議寫入權限授與您在 Data Lake Storage 帳戶上的容器。
選取容器和根資料夾
若要選取智慧建議用來記錄回報的容器和資料夾:
登入 Azure 入口網站並選取儲存體區段。
選擇用於建立智慧建議帳戶的訂閱、選擇 Data Lake Storage 帳戶,然後選取容器。
選擇容器,也就是您用作智慧建議根資料夾的那個容器。 在此範例中,容器是 ircontainer,而根資料夾是 ir_root。
然後選取或建立目的地資料夾以供智慧建議寫入記錄。 在此範例中,已建立名為 ir_logs 的資料夾。
注意
在您已使用同一個容器將資料與智慧建議共用,並將資料記錄回 Data Lake Store 的情況下,強烈建議您使用不同於與智慧建議共用資料所用之根資料夾的其他資料夾,將錯誤記錄寫入 Data Lake Store。
設定容器的安全性
若要設定容器的安全性,並允許將記錄寫入您專用存儲體帳戶的記錄檔資料夾,您必須使用系統指派或使用者指派的受控識別來授與智慧建議寫入記錄檔的存取權限。 這些步驟會使用系統指派的受控識別。 若要深入了解如何使用使用者指派的受控識別來設定安全性,請移至智慧建議的使用者指派的識別。
繼續之前,請確定您有業務要用來與智慧建議共用資料的訂閱和儲存體帳戶。
系統指派的受控識別方法
若要使用系統指派的受控識別來設定安全性:
- 開啟智慧建議帳戶。
- 在左窗格上,選取身分識別。
- 在系統指派索引標籤下,將狀態變成開啟,然後選取儲存。
- 返回儲存體帳戶,並選取左導覽窗格中的容器,然後選取 ircontainer (或您為容器指定的任何名稱)。
- 在左窗格中,選取存取控制 (IAM)。
若要允許智慧建議服務寫入記錄資料,請指派儲存體 Blob 資料參與者權限:
- 在授與此資源的存取權下方,選取新增角色指派。
- 在角色中,選取儲存體 Blob 資料參與者,然後選取下一步。
- 在下一個畫面的存取權指派對象區段底下,選取受控識別,然後選取 + 選取成員。
- 在受控識別底下,選取智慧建議帳戶類別。
- 接下來,您會看到智慧建議帳戶的清單。 選擇可存取此儲存體帳戶的相關帳戶,然後選擇選取。
- 選取 [檢閱 + 指派] 按鈕,完成您的決定。
確認您的角色指派
返回儲存體帳戶和 ircontainer,確認您是否有正確的權限集。
- 在 ircontainer 中,從左窗格選取存取控制 (IAM)。
- 從檢視此資源的存取權區段選取檢視。
- 搜尋智慧建議服務,並確認此服務已在角色指派區段中與 儲存 Blob 資料參與者一起列出。 如果遺失此角色,請返回,並使用先前所述步驟將角色重新加入。
注意
您也可以在資料夾層級上設定權限 (ACL 權限)。 如需 ACL 權限的詳細資訊,請移至 Azure Data Lake Storage Gen2 中的存取控制清單。
設定報表功能
下一個步驟是將您指定的根資料夾設定為要將回報記錄到的位置。
- 移至智慧建議帳戶。
- 選取報表索引標籤。
- 輸入記錄檔資料夾的 URL。 如果您在此 IR 帳戶上已有模型元件,則會在此階段看到模型元件的清單。 選取其中一個元件時,系統會自動在模型元件連接字串所定義的容器中建立名為 "root_reports" 的記錄檔資料夾,並在其中寫入此 IR 帳戶的記錄檔。
- 您可選取 [檢查存取] 按鈕,以便確認 IR 帳戶是否有權限可以將記錄檔寫入記錄檔資料夾所在的容器。
- 選取更新。
注意
此資料夾不需要存在。 若未在此處張貼任何連結,則會在第一次嘗試寫入資料時建立資料夾。
存取記錄
現已成功設定回寫,接下來就會將記錄寫入您在每個調製週期所選擇的目的地資料夾。 調製週期會在每個預先決定的時間範圍內執行一次,但也可以手動觸發。 如需詳細資訊,請移至手動觸發建立模型週期。
在資料夾中,您會找到每個模型元件的子資料夾。 在每個子資料夾中,您會找到兩個資料夾:
- 資料擷取:包含與資料擷取相關的記錄
- 統計資料:包含與模型效能相關的記錄。
如需有關分析這些記錄的詳細資訊,請移至錯誤記錄。
另請參閱
智慧建議 API 參考
快速入門手冊:使用範例資料設定並執行智慧建議
快速入手冊:進行經過驗證的 API 呼叫
Deployment overview
使用資料合約來共用資料