服务拓扑¶
在“服务拓扑”页面,您可以通过拓扑图直观查看各服务间的调用关系。
空间范围¶
进入服务拓扑页面后,默认查询当前工作空间的服务数据。查询其他工作空间的服务详情及指标需要相应的数据授权。如果拓扑关系中出现未授权空间的服务节点,不能继续查看该服务的受限详情和关联数据。
若当前工作空间已被授权访问其他空间的数据,您可通过页面顶部的空间范围选择器切换查看维度:
- 当前空间:仅展示当前工作空间的服务拓扑(默认选项);
- 全部空间:展示当前空间及所有可访问空间的服务拓扑;
- 授权空间:多选指定已授权的工作空间,查看对应空间的服务拓扑。
页面中的搜索、筛选、服务数量统计、节点颜色及拓扑指标均基于当前选中的空间范围实时计算。若当前工作空间无跨空间授权,页面将不展示其他空间选项。
一次查询只能包含同一站点的工作空间。不同空间的同名服务按各自来源区分;点击节点、查看上下游或关联数据时,使用被选中节点的来源空间,不以当前登录空间或第一个选中空间代替。通用条件参见APM 与 RUM 同站点跨空间查询。
注意
当前服务拓扑数据默认延迟为 5 分钟。支持通过 max_delay 参数在 1 至 5 分钟(分钟粒度)范围内进行调整(❗️仅限部署版用户),您可根据业务实时性需求灵活设定。
-
SaaS 商业版通过跨空间授权配置数据可见范围,仅工作空间拥有者、管理员或具备跨空间授权管理权限的角色可进行配置。授权生效后,被授权空间即可在 ServiceMap 中查看对应数据;取消授权后,对应工作空间将立即不可继续查看该源空间的 ServiceMap 数据;
-
部署版通过站点维度配置数据可见范围。
单个服务¶
将鼠标悬浮在单个服务节点上,对应服务及关联节点会高亮显示,无关联服务及连接线变灰。悬浮指标卡展示该服务的请求数、错误率、平均响应时间、P99/P95 响应时间和最大响应时间等数据。
查看服务详情¶
在默认打开页面,系统除了直观为您展示当前选中空间范围内服务间的调用关系外,点击具有相应数据访问权限的服务节点,可侧滑查看其详情信息。
| 服务所属空间的授权状态 | 下钻行为 |
|---|---|
| 已授权给当前空间 | 按该服务所属空间查询详情;切换下钻角度时,保持该服务的来源空间。 |
| 未授权给当前空间 | 保持当前空间选择,不展示受限图表;查看上下游等相关操作置灰,悬浮提示说明所属空间尚未授权。 |
服务详情主要包含以下要素:
- 服务名称等,以及其对应的团队、联系方式、告警数量等;
- 当前服务的基础指标:请求数、错误率、平均响应时间和 P99/P95 响应时间和最大响应时间;
- 点击查看当前服务的上下游、服务概览、关联的日志和链路;
- 指标(服务请求响应时间、错误请求分布)和日志(错误日志数)的异常趋势图。
在会话重放页面打开详情,并继续进入关联的 Profile 详情后,可使用详情页的返回入口回到上一级,继续查看关联数据。
管理拓扑¶
-
放大、缩小或完整展示当前服务拓扑;
-
支持选择不同的性能指标来匹配服务节点颜色,包括请求数、P50/P75/P95/P99 响应时间、最大响应时间和错误率;
-
自定义颜色:为选择的“填充指标”设置服务节点颜色区间范围。
-
自定义区间:为选择的填充指标自定义服务节点颜色区间范围。系统将根据所选指标在该拓扑中的最大值和最小值,自动划分出 5 个数值区间,每个区间对应一种颜色;
- 节点尺寸:节点大小共有 3 种尺寸,对服务每秒请求数的最大值(Max)和最小值(Min)进行三等分,得出的三个区间对应 3 种图形尺寸。
注意
当每秒请求数小于 0.01 时,界面显示值将统一标注为 < 0.01。但请注意,节点尺寸的计算仍基于实际数值。
-
拓扑图配置:
- 区分环境和版本:基于服务(
service)和服务环境版本(service+env+version)两种维度绘制链路拓扑图。开启后,系统将按照不同的环境版本绘制服务拓扑图; - 服务分组:支持按照 Kubernetes 集群、环境或服务标签对拓扑节点进行分组。不同分组以独立区域展示,跨分组调用仍通过连线表示。
在服务详情的“服务拓扑 > 全路径”视图中,也可使用分组功能查看调用关系。
- 按项目区分同名服务:开启后,系统会根据
project属性拆分同名服务。服务名称相同但project不同的数据会展示为不同节点;未设置project的数据归入“未设置项目”。 - 是否按“请求数”计算节点大小;
- 选择悬浮高亮范围:直接关联节点(上下游)/全链路关联节点(多级上下游)。
- 仅显示匹配筛选条件的服务:开启后,服务拓扑将按当前筛选条件过滤服务节点,仅保留自身符合条件的服务节点,并隐藏不符合条件的节点。
- 区分环境和版本:基于服务(
跨空间查询¶
跨空间下钻使用被选中服务的来源空间;返回列表时保留原查询范围。数据授权配置参见跨工作空间授权。
前提
所有商业版工作空间归属于同一个组织 ID,即 organization 相同。
若同一个 Trace 数据存在分流情况,数据会归属于不同的工作空间,此时无法在同一个工作空间查看完整的链路数据。而跨工作空间 Service Map 查询可保证数据查询的连贯性,直接在当前工作空间点击按钮即可查看当前服务的上下游调用拓扑。
数据源定义及 DQL 查询¶
更多详情,可参考 服务拓扑数据源定义。


