跳到主要内容

同步外部业务链路

当业务拓扑由第三方系统维护时，可以通过外部数据同步将业务链路、节点、连线以及接口到服务的下钻关系导入 ONE，继续使用业务观测的监控和排障能力。

前提条件​

  • 第三方系统提供 ONE 可访问的 HTTP API。
  • 已准备同步地址；需要鉴权时，已按部署约定配置网络和鉴权。
  • 每条链路和每个节点都有稳定、可重复使用的唯一标识。
  • 需要从接口链路下钻到服务子图时，已准备成对的 interface 链路、service 链路和 relationBindings 数据。

接口实现必须符合外部同步 API 参考。

1. 准备外部接口​

  1. 提供支持 POST 的分页查询接口。
  2. 接收页码、每页条数、链路 ID 和链路名称等查询条件。
  3. 返回分页信息和 results 链路列表。
  4. 在 nodes 中返回节点，在 edges 中返回连接关系。
  5. 需要接口到服务下钻时，使用 relationBindings 建立绑定。

2. 配置数据源​

  1. 进入观测洞察 → 业务观测 → 业务链路。
  2. 点击外部数据同步。
  3. 首次使用时，点击提示窗口右上角的数据源配置。
  4. 填写外部同步地址，并按部署要求完成鉴权配置。
  5. 返回业务链路页面。

3. 启动同步​

  1. 再次点击外部数据同步。
  2. 检查提示信息后，点击确认并开始同步。
  3. 等待同步完成。

外部数据同步提示

注意

同步期间不要关闭或刷新页面。同一账号在同一时间只执行一个同步任务，以免无法准确判断任务状态。

4. 验证同步结果​

  1. 在业务链路首页搜索目标链路名称。
  2. 打开链路并检查节点数量、节点名称和连线方向。
  3. 确认链路更新时间符合本次同步。
  4. 如果提供了 relationBindings，从 interface 节点验证能否进入对应 service 子图。

常见问题​

现象检查项
同步后看不到链路检查响应 code、分页字段、results，以及链路唯一标识和名称。
节点存在但没有连线检查 edges 中的源节点和目标节点是否引用同一链路内有效节点。
无法从接口下钻到服务检查 interface/service 链路是否成对返回，以及 relationBindings 是否匹配。
多次同步产生重复对象确认同一链路和节点在每次同步中使用相同的稳定唯一标识。
接口数据无法解析按外部同步 API 参考检查字段类型、必填项和不支持的旧格式。

同步成功后，参见监控与排障使用导入的数据。