APM 服务拓扑跨空间配置说明¶
在部署版中,“应用性能监测 > 服务 > 服务拓扑”的跨空间页面入口和 Kodo 侧服务拓扑跨空间查询能力由两个独立配置控制。二者可以按场景分别配置,也可以配合使用,以同时提供页面入口和跨空间拓扑查询能力。
配置项说明¶
| 配置项 | 所属组件 | 作用 | 示例值 |
|---|---|---|---|
enableApmServiceTopology |
Studio 后端 | 控制部署版服务拓扑页面是否展示跨空间选择器 | true |
cross_workspace_on |
kodo-inner |
控制 Kodo 是否查询跨工作空间服务拓扑关系 | true |
功能说明¶
enableApmServiceTopology 是站点级页面入口开关。开启后,部署版工作空间在满足版本和权限条件时,可在服务拓扑页面看到空间范围选择器,并按当前选择的工作空间范围查询服务节点、调用关系和拓扑指标。
cross_workspace_on 是 Kodo 侧服务拓扑查询开关,配置在 kodo-inner 的 ConfigMap 中。开启后,Studio 后端查询服务拓扑时,会把用户已授权的目标工作空间转换为 Kodo 查询参数,由 Kodo 按对应空间范围返回服务节点和调用边。
配置位置¶
Studio 后端¶
在 Launcher 中找到 Studio 后端配置,对应配置文件中添加或修改:
该配置默认关闭。配置为 true 后,前端才会在部署版服务拓扑页展示跨空间选择入口。
kodo-inner¶
在 Launcher 中找到 KodoInner 配置,对应 Kubernetes ConfigMap 为 kodo-inner。在 servicemap 配置段中添加或修改:
生效范围¶
开启后,服务拓扑页面可按当前空间、全部可访问空间或指定授权空间查看 ServiceMap 数据。页面中的搜索、筛选、服务数量统计、节点颜色和拓扑指标均基于当前选择的空间范围计算。
未配置跨空间授权时,用户仍只能看到当前工作空间的数据,不会默认看到其他工作空间的服务节点、调用边或指标数据。
注意事项¶
enableApmServiceTopology和cross_workspace_on是两个独立开关。前者控制 Studio 页面入口,后者控制 Kodo 侧跨空间拓扑查询能力;二者可按部署场景分别配置,也可配合使用。- SaaS 商业版的数据可见范围以跨空间授权配置为准;部署版需要通过上述站点级配置开启能力。
- 跨站点查询时,一次查询中的目标工作空间必须属于同一个目标站点。
- 修改配置后,请按部署环境要求重启或滚动更新相关组件,使配置生效。
验证方式¶
- 进入“应用性能监测 > 服务 > 服务拓扑”。
- 确认页面顶部出现空间范围选择器。
- 选择已授权的其他工作空间或多个工作空间。
- 确认拓扑图、服务数量、调用关系和指标数据按所选空间范围刷新。
- 取消授权或关闭配置后,确认其他空间入口或数据不可继续访问。