本文以云监控 2.0 为例，带您为自定义数字员工连接可观测数据，并完成一次可验证的故障诊断。整个流程分为三步：创建云监控 2.0 连接器、验证数据接入、发起并验证故障诊断。完成后，您将得到一份基于实际接入数据的诊断结论。
前提条件
开始操作前，请确认以下条件：
准备项 | 要求 |
STAROps 和数字员工 | 已能够访问 STAROps，并已创建自定义数字员工。 |
云监控 2.0 工作空间 | 工作空间已创建，并且至少包含一种可用于诊断的实体、指标、日志或链路数据。 |
操作者权限 | 当前 RAM 用户或 RAM 角色可以操作目标数字员工并管理连接器；使用自定义运行时角色时，还需要具备把该角色传递给数字员工的 |
诊断时间范围 | 建议选择一个确定有数据的时间范围。已知异常时间和异常实体有助于验证诊断准确性，但不是必要条件。 |
本文使用员工角色访问工作空间，即由 STAROps 自动创建并维护的 AliyunServiceRoleForSTAROps，您无需额外创建或授权 RAM 角色。
如果当前身份无法添加或管理连接器，请联系管理员补充连接器管理权限。
操作者权限和数字员工运行时权限相互独立。RAM 用户能够操作数字员工或连接器，不代表数字员工能够读取业务数据；数字员工运行时角色能够读取数据，也不会自动把相同权限授予 RAM 用户。
步骤一：创建云监控 2.0 连接器
登录 STAROps 控制台，在数字员工列表中单击目标数字员工名称，然后选择设置 > 连接器 > 可观测。
单击添加可观测，选择云监控 2.0，然后单击下一步。
填写连接器 ID 和名称。
将访问角色选择为员工角色。
选择目标工作空间所在的地域和工作空间。
开启Agentic 建模。系统将在保存连接器后为数据源创建数据模型。
在检查并添加页面核对连接器 ID、名称、角色、地域、工作空间和建模开关，然后保存连接器。
保存后，新建的连接器出现在可观测连接器列表中，并自动开始检查连接状态。状态判断标准请参见步骤二。
一个连接器对应一个工作空间，同一工作空间不能被多个连接器绑定。连接器创建后，角色、地域和工作空间不能修改；如需更换，请删除连接器后重新创建。Agentic 建模开关不受此限制，可以在创建后开启。
工作空间与数字员工存储地域不同时，可能产生跨地域数据传输；涉及不同国家或地区时，还可能产生跨境数据传输。请根据数据合规要求选择地域。
步骤二：验证数据接入
按照以下层级逐层验证，避免把连接器状态“成功”等同于整个诊断链路可用：
验证层级 | 成功标准 | 失败时的处理 |
连接器 | 可观测连接器列表显示“成功”，角色、地域和工作空间与预期一致。 | 在连接器详情中查看失败原因并修正角色权限；需要更换角色、地域或工作空间时，删除后重新创建。 |
数据建模 | 数据建模任务已完成，并展示与工作空间实际数据类型对应的实体或模型信息。 | 打开建模会话查看失败信息，修正连接器或数据权限后，同一会话中重新发起建模。 |
运行时查询 | 会话能够查询目标时间范围内至少一种实际接入的数据。 | 如果错误信息给出缺失的 RAM Action（权限操作），为数字员工运行时角色补充对应权限。未给出具体 Action 时，依次检查角色、地域、工作空间、数据类型和时间范围。 |
步骤三：发起并验证故障诊断
探索式诊断
不知道具体异常实体时，可以先让数字员工识别指定时间范围内的异常对象。
在数字员工中单击新建会话，然后在会话页面顶部的时间选择器中选择一个确定有数据的时间范围。
输入诊断问题并发送。以下示例用于发现异常实体：
请使用云监控 2.0 连接器 <连接器名称> 中的数据，检查 <开始时间> 至 <结束时间> 的整体运行情况，识别存在异常的服务或实例，并给出判断依据。如果数据或权限不足，请明确说明缺少的信息。从数字员工返回的异常对象中选择需要继续分析的实体，然后执行定向式诊断。
定向式诊断
已经知道异常实体时，可以直接围绕该实体进行分析。
在对话框中输入
@，从列表中选择需要诊断的 Service、Pod 或其他实体。在问题中说明异常现象和时间范围，然后发送问题。以下示例用于分析已经通过
@选中的实体：请使用云监控 2.0 连接器 <连接器名称> 中的数据，分析我选择的实体在 <开始时间> 至 <结束时间> 出现的错误率升高问题。请定位可能原因，提供当前可用数据能够支持的证据，并说明建议操作及验证方法。如果数据或权限不足，请明确说明缺少的信息。
验收诊断结果
出现诊断结论或完整诊断报告入口后，按照以下标准检查结果：
分析对象、时间范围和工作空间与问题一致。
结论至少包含一种来自实际接入数据的可复核证据。
无法获得某类数据时，结果明确说明数据或权限限制，而不是补全不存在的证据。
建议操作包含风险说明和验证方法。
推测性结论被明确标记为待验证。
如果证据不足，可以根据具体缺口继续追问：
证据缺口 | 追问示例 |
缺少时间对比 |
|
缺少上下游影响分析 |
|
缺少变更关联 |
|
缺少修复验证 |
|
后续步骤
完成本文流程后，您可以按实际需要继续：
收敛权限范围：把员工角色替换为按最小权限配置的自定义角色，请参见STAROps 自定义权限策略最佳实践。
常见问题
工作空间列表中没有目标工作空间怎么办？
请按以下顺序排查：
确认目标工作空间存在，并检查所选地域是否与工作空间一致。
检查数字员工运行时角色是否具备访问目标工作空间的权限。
保存时提示工作空间已被绑定怎么办？
同一工作空间不能被多个连接器绑定。请联系管理员确认现有连接器所属的数字员工，继续使用已有连接器或选择其他工作空间。
连接器状态为失败怎么办？
请按以下顺序排查：
在连接器详情中查看失败原因。
核对角色、地域和工作空间是否仍然有效。
修正权限后刷新连接器状态；需要更换角色、地域或工作空间时，删除并重新创建连接器。
数据建模失败怎么办？
请按以下顺序排查：
打开数据建模页面，找到对应连接器的建模任务。
查看建模会话中的错误信息。
修正连接器或数据权限问题。
单击开始建模，重新发起建模任务。
输入 @ 符号后没有显示目标实体怎么办？
请按以下顺序排查：
确认对应连接器的数据建模已经完成。
确认工作空间中存在可建模的实体数据。
确认目标实体属于该连接器绑定的工作空间。
修正连接器、数据或建模问题后，重新输入
@选择实体。