健康情況檢查
健康情況檢查會掃描您在沙箱中使用的結構描述和身分,並提供問題摘要,可用於探索和疑難排解AI Assistant。 未來可以掃描更多物件,以取得更完整的報告。
不良的結構描述和身分設定會導致嚴重的下游問題,包括不正確的設定檔建立、失敗的區段資格和不準確的啟用。 這些問題很難偵測,通常需要專業知識才能診斷。 健康狀態檢查將您的方式從被動式疑難排解轉變為主動預防性維護。
透過健康狀態檢查,您可以:
- 及早偵測設定問題:找出遺漏的最佳實務、設定錯誤和模式,導致個人化、啟動等作業效率低下。
- 接收引導式修正:取得每個問題的明確指引,以及處理該問題的方式。
- 持續監視:目前,健康情況檢查會執行每日自動掃描,以便在問題變成嚴重失敗之前先找出問題。 未來版本可能會變更排程。
先決條件 prerequisites
若要存取健康情況檢查,您需要View Health Checks 存取控制許可權。 請聯絡您的系統管理員,以確保您擁有適當的許可權。
存取健康狀態檢查 access-health-checks
若要從Experience Platform UI存取健康情況檢查:
- 從左側導覽中選取Run and Operate。
- 選擇「Health Checks」。
健康情況檢查儀表板會顯示您最近掃描結果的摘要。
瞭解儀表板 understanding-dashboard
健康情況檢查儀表板提供三個方面的資訊來協助您評估實作的狀態。
物件已評估 objects-evaluated
Objects evaluated區段顯示已掃描的結構描述和身分識別名稱空間總數,以及每個類別找到多少問題。 這可讓您快速檢視沙箱中設定問題的範圍和嚴重性。
掃描結果 scan-results
Scan results區段顯示失敗的檢查數目。 失敗的檢查表示一或多個健康狀態檢查偵測到需要注意的組態問題。 上次於 時間戳記完成之 每日健康情況掃描會顯示最近一次掃描的執行時間。
已識別的問題 identified-issues
Identified issues區段會顯示每個健康狀態檢查的卡片。 每個卡片都會顯示:
- 健康情況檢查名稱和問題的簡短說明。
- 發現的問題數,或不存在問題的確認。
- 顯示檢查通過或需要注意的狀態指示器。
選取任一卡片以探索該健康狀態檢查的詳細資訊。
可用的健康狀態檢查 available-health-checks
健康狀態檢查目前會評估架構和身分設定的五個基本區域。 這些檢查會針對整個平台中最具影響力的資料模型問題。
身分欄位驗證 identity-field-validation
掃描以確保識別欄位具有最小和最大長度限制,以及資料整合的規則運算式模式規則。
選取 Identity Field Validation 卡片時,右側會開啟詳細資料面板。 面板會顯示:
- Description:掃描以確保身分識別欄位具有最小/最大長度,以及資料完整性規則運算式模式規則。 列出受影響的方案和欄位。
- Impact:如果結構描述中的身分欄位沒有設定上下限長度和模式驗證,可能會導致資料不一致,進而影響資料的完整性和品質。
- General areas of impact: Identity Service中的低品質識別碼;不可靠的彙整。
- Experience League Documentation:資料模型最佳作法的連結。
- Affected Schemas:受影響的結構描述清單,每個結構描述都有一個擴充功能,可檢視更多詳細資料和開啟結構描述的連結。
如需詳細資訊,請參閱結構描述最佳實務檔案中的資料完整性提示。
身分識別圖連結規則 identity-graph-linking-rules
驗證身分圖表連結規則是否已針對沙箱進行設定,以防止摺疊的設定檔。
選取 Identity Graph Linking Rules 卡片時,右側會開啟詳細資料面板。 面板會顯示:
- Description:驗證是否已設定適當的連結規則,以防止摺疊的設定檔。 它會顯示目前的規則狀態和每個圖表的不重複身分。
- Impact:如果未設定身分圖表連結規則,某些資料可能會嘗試將多個不同的設定檔合併為單一設定檔。 若要防止不想要的合併,應使用透過身分圖表連結規則提供的設定。
- General areas of impact:摺疊或合併的設定檔。
- Experience League Documentation:身分圖表連結規則總覽的連結,以取得詳細資訊。
- Configure linking rules:檢查失敗時,會出現一個按鈕,讓您可直接從面板設定連結規則。
如需詳細資訊,請參閱身分圖表連結規則總覽和實作指南。
人員與非人員身分設定 people-non-people-identity
驗證結構描述類別中人員與非人員身分型別的正確使用。
選取 People & Non-People Identity Config 卡片時,右側會開啟詳細資料面板。 面板會顯示:
- Description:驗證跨結構描述類別正確使用了身分型別。 列出設定錯誤的結構描述,並醒目提示錯誤的指派。
- Impact:如果非人員實體獲得人員身分,將誇大設定檔計數,並使此資料不符合查閱資格。 如果以非人員身分識別個人實體,資料將無法用於串流或邊緣劃分。
- General areas of impact:不完整的身分圖表;膨脹的設定檔計數;查詢誤用。
- Affected Schemas:有問題的結構描述清單。 展開結構描述列,以檢視每個設定錯誤的路徑、身分名稱和結構描述型別。 使用連結圖示開啟方案。
自訂身分名稱空間說明 namespace-missing-description
掃描以確保自訂身分名稱空間中繼資料和說明完整。
選取 Custom Identity Namespace Description 卡片時,右側會開啟詳細資料面板。 面板會顯示:
- Description:掃描以確保名稱空間中繼資料和說明完整。 顯示具有空白說明欄位的名稱空間和擁有者。
- Impact:在自訂身分名稱空間上設定說明,可提供每個名稱空間用途的內容,進而提高清晰度。 這有助於團隊成員和利害關係人快速瞭解每個名稱空間的功能,而不會混淆。
- General areas of impact:偵錯或使用方式混淆;不清楚的驗證意圖。
- Experience League Documentation:建立自訂名稱空間的連結,以取得進一步資訊。
- Affected namespaces:遺失說明的自訂身分名稱空間清單。 使用每個名稱空間旁的連結圖示來檢視或編輯。
如需詳細資訊,請參閱有關建立自訂名稱空間的檔案。
已棄用的身分名稱空間 deprecated-namespace
偵測應標示為要清理的過時或未使用的身分名稱空間。
選取 Deprecated Identity Namespace 卡片時,右側會開啟詳細資料面板。 面板會顯示:
- Description:偵測過時或未使用的身分名稱空間以進行清除。 列出具有上次使用時間戳記或結構描述參考的未使用名稱空間。
- Impact:未在任何結構描述中使用的身分名稱空間應該標示為要移除,方法是在其名稱中新增「DEPRECATED」或「DO NOT USE」標籤。 目前不支援刪除身分名稱空間。
- General areas of impact:混淆和標籤錯誤的風險。
- Experience League Documentation:舊版身分識別名稱空間的連結,以取得進一步檔案。
- Affected namespaces:過時或未使用的身分名稱空間清單。 使用每個名稱空間旁的連結圖示來檢視或管理名稱空間。
如需詳細資訊,請參閱有關過時名稱空間的Experience Cloud知識庫文章。
後續步驟 next-steps
檢閱完健康情況檢查結果後,請探索下列資源,以加深您的瞭解:
- 瞭解設計可靠資料模型的結構描述最佳做法。
- 瞭解身分圖表連結規則以防止設定檔摺疊。
- 檢閱身分識別名稱空間檔案,以取得名稱空間管理的最佳實務。
- 探索其他執行及操作工具 (包括Job Schedules)以取得批次作業可見度。