從串連資料到完成一次診斷 - STAROps

本文以CloudMonitor 2.0 為例，帶您為自訂數字員工串連可觀測資料，並完成一次可驗證的故障診斷。整個流程分為三步：建立CloudMonitor 2.0 連接器、驗證資料接入、發起並驗證故障診斷。完成後，您將得到一份基於實際接入資料的診斷結論。

前提條件

開始操作前，請確認以下條件：

準備項	要求
STAROps 和數字員工	已能夠訪問 STAROps，並已建立自訂數字員工。
CloudMonitor 2.0 工作空間	工作空間已建立，並且至少包含一種可用於診斷的實體、指標、日誌或鏈路資料。
操作者許可權	當前 RAM 使用者或 RAM 角色可以操作目標數字員工並管理連接器；使用自訂運行時角色時，還需要具備把該角色傳遞給數字員工的 `ram:PassRole`（角色傳遞）許可權。
診斷時間範圍	建議選擇一個確定有資料的時間範圍。已知異常時間和異常實體有助於驗證診斷準確性，但不是必要條件。

本文使用員工角色訪問工作空間，即由 STAROps 自動建立並維護的 AliyunServiceRoleForSTAROps，您無需額外建立或授權 RAM 角色。

如果當前身份無法添加或管理連接器，請聯絡管理員補充連接器系統管理權限。

重要

操作者許可權和數字員工運行時許可權相互獨立。RAM 使用者能夠運算元字員工或連接器，不代表數字員工能夠讀取業務資料；數字員工運行時角色能夠讀取資料，也不會自動把相同許可權授予 RAM 使用者。

步驟一：建立CloudMonitor 2.0 連接器

登入 STAROps 控制台，在數字員工列表中單擊目標數字員工名稱，然後選擇設定 > 連接器 > 可觀測。
單擊添加可觀測，選擇CloudMonitor 2.0，然後單擊下一步。
填寫連接器 ID 和名稱。
將訪問角色選擇為員工角色。
選擇目標工作空間所在的地區和工作空間。
開啟Agentic 建模。系統將在儲存連接器後為資料來源建立資料模型。
在檢查並添加頁面核對連接器 ID、名稱、角色、地區、工作空間和建模開關，然後儲存連接器。

儲存後，建立的連接器出現在可觀測連接器列表中，並自動開始檢查串連狀態。狀態判斷標準請參見步驟二。

說明

一個連接器對應一個工作空間，同一工作空間不能被多個連接器綁定。連接器建立後，角色、地區和工作空間不能修改；如需更換，請刪除連接器後重新建立。Agentic 建模開關不受此限制，可以在建立後開啟。
工作空間與數字員工儲存地區不同時，可能產生跨地區資料轉送；涉及不同國家或地區時，還可能產生跨境資料轉送。請根據資料合規要求選擇地區。

步驟二：驗證資料接入

按照以下層級逐層驗證，避免把連接器狀態“成功”等同於整個診斷鏈路可用：

驗證層級	成功標準	失敗時的處理
連接器	可觀測連接器列表顯示“成功”，角色、地區和工作空間與預期一致。	在連接器詳情中查看失敗原因並修正角色許可權；需要更換角色、地區或工作空間時，刪除後重新建立。
資料建模	資料建模任務已完成，並展示與工作空間實際資料類型對應的實體或模型資訊。	開啟建模會話查看失敗資訊，修正連接器或資料許可權後，同一會話中重新發起建模。
運行時查詢	會話能夠查詢目標時間範圍內至少一種實際接入的資料。	如果錯誤資訊給出缺失的 RAM Action（許可權操作），為數字員工運行時角色補充對應許可權。未給出具體 Action 時，依次檢查角色、地區、工作空間、資料類型和時間範圍。

步驟三：發起並驗證故障診斷

探索式診斷

不知道具體異常實體時，可以先讓數字員工識別指定時間範圍內的異常對象。

在數字員工中單擊建立會話，然後在會話頁面頂部的時間選取器中選擇一個確定有資料的時間範圍。

輸入診斷問題並發送。以下樣本用於發現異常實體：

請使用CloudMonitor 2.0 連接器 <連接器名稱> 中的資料，檢查 <開始時間> 至 <結束時間> 的整體運行情況，識別存在異常的服務或執行個體，並給出判斷依據。如果資料或許可權不足，請明確說明缺少的資訊。

從數字員工返回的異常對象中選擇需要繼續分析的實體，然後執行定向式診斷。

定向式診斷

已經知道異常實體時，可以直接圍繞該實體進行分析。

在對話方塊中輸入 @，從列表中選擇需要診斷的 Service、Pod 或其他實體。

在問題中說明異常現象和時間範圍，然後發送問題。以下樣本用於分析已經通過 @ 選中的實體：

請使用CloudMonitor 2.0 連接器 <連接器名稱> 中的資料，分析我選擇的實體在 <開始時間> 至 <結束時間> 出現的錯誤率升高問題。請定位可能原因，提供當前可用資料能夠支援的證據，並說明建議操作及驗證方法。如果資料或許可權不足，請明確說明缺少的資訊。

驗收診斷結果

出現診斷結論或完整診斷報告入口後，按照以下標準檢查結果：

分析對象、時間範圍和工作空間與問題一致。
結論至少包含一種來自實際接入資料的可複核證據。
無法獲得某類資料時，結果明確說明資料或許可權限制，而不是補全不存在的證據。
建議操作包含風險說明和驗證方法。
推測性結論被明確標記為待驗證。

如果證據不足，可以根據具體缺口繼續追問：

證據缺口	追問樣本
缺少時間對比	`請對比異常時段與前一天同時段的錯誤率和延遲。`
缺少上下遊影響分析	`請檢查該服務的上遊入口和下遊依賴是否存在關聯異常。`
缺少變更關聯	`請結合異常發生前的發布、配置或擴縮容記錄重新分析。`
缺少修複驗證	`修複操作已完成，請對比修複前後的核心指標並確認是否恢複。`

後續步驟

完成本文流程後，您可以按實際需要繼續：

收斂許可權範圍：把員工角色替換為按最小許可權配置的自訂角色，請參見STAROps 自訂權限原則最佳實務。

常見問題

工作空間列表中沒有目標工作空間怎麼辦？

請按以下順序排查：

確認目標工作空間存在，並檢查所選地區是否與工作空間一致。
檢查數字員工運行時角色是否具備訪問目標工作空間的許可權。

儲存時提示工作空間已被綁定怎麼辦？

同一工作空間不能被多個連接器綁定。請聯絡管理員確認現有連接器所屬的數字員工，繼續使用已有連接器或選擇其他工作空間。

連接器狀態為失敗怎麼辦？

請按以下順序排查：

在連接器詳情中查看失敗原因。
核對角色、地區和工作空間是否仍然有效。
修正許可權後重新整理連接器狀態；需要更換角色、地區或工作空間時，刪除並重新建立連接器。

資料建模失敗怎麼辦？

請按以下順序排查：

開啟資料建模頁面，找到對應連接器的建模任務。
查看建模會話中的錯誤資訊。
修正連接器或資料許可權問題。
單擊開始建模，重新發起建模任務。

輸入 @ 符號後沒有顯示目標實體怎麼辦？

請按以下順序排查：

確認對應連接器的資料建模已經完成。
確認工作空間中存在可建模的實體資料。
確認目標實體屬於該連接器綁定的工作空間。
修正連接器、資料或建模問題後，重新輸入 @ 選擇實體。