服务拓扑¶

在“服务拓扑”页面，您可以通过拓扑图直观查看各服务间的调用关系。

空间范围¶

进入服务拓扑页面，系统默认仅展示当前工作空间内的服务节点与调用关系。未配置跨空间授权时，其他工作空间的服务节点、调用边及指标数据均不可见。

若当前工作空间已被授权访问其他空间的数据，您可通过页面顶部的空间范围选择器切换查看维度：

页面中的搜索、筛选、服务数量统计、节点颜色及拓扑指标均基于当前选中的空间范围实时计算。若当前工作空间无跨空间授权，页面将不展示其他空间选项。

注意

当前服务拓扑数据默认延迟为 5 分钟。支持通过 max_delay 参数在 1 至 5 分钟（分钟粒度）范围内进行调整（❗️仅限部署版用户），您可根据业务实时性需求灵活设定。

SaaS 商业版通过跨空间授权配置数据可见范围，仅工作空间拥有者、管理员或具备跨空间授权管理权限的角色可进行配置。授权生效后，被授权空间即可在 ServiceMap 中查看对应数据；取消授权后，对应工作空间将立即不可继续查看该源空间的 ServiceMap 数据；
部署版通过站点维度配置数据可见范围。

hover 在单个服务节点，对应服务会高亮显示，其他无关联服务及连接线变灰。您可以查看该服务的请求数、错误率、平均响应时间、P99/P95 响应时间和最大响应时间等关键指标数据。

在默认打开页面，系统除了直观为您展示当前选中空间范围内服务间的调用关系外，点击任意服务节点，即可侧滑查看该服务的详情信息。主要包含以下要素：

放大、缩小或完整展示当前服务拓扑；
支持选择不同的性能指标来匹配服务节点颜色，包括请求数、P50/P75/P95/P99 响应时间、最大响应时间和错误率；
自定义颜色：为选择的“填充指标”设置服务节点颜色区间范围。
自定义区间：为选择的填充指标自定义服务节点颜色区间范围。系统将根据所选指标在该拓扑中的最大值和最小值，自动划分出 5 个数值区间，每个区间对应一种颜色；
- 节点尺寸：节点大小共有 3 种尺寸，对服务每秒请求数的最大值（Max）和最小值（Min）进行三等分，得出的三个区间对应 3 种图形尺寸。

注意

当每秒请求数小于 0.01 时，界面显示值将统一标注为 < 0.01。但请注意，节点尺寸的计算仍基于实际数值。

拓扑图配置：
- 区分环境和版本：基于服务（service）和服务环境版本（service+env+version）两种维度绘制链路拓扑图。开启后，系统将按照不同的环境版本绘制服务拓扑图；
- 是否按“请求数”计算节点大小；
- 选择悬浮高亮范围：直接关联节点（上下游）/全链路关联节点（多级上下游）。
- 仅显示匹配筛选条件的服务：开启后，服务拓扑将按当前筛选条件过滤服务节点，仅保留自身符合条件的服务节点，并隐藏不符合条件的节点。

前提

所有商业版工作空间归属于同一个组织 ID，即 organization 相同。

若同一个 Trace 数据存在分流情况，数据会归属于不同的工作空间，此时无法在同一个工作空间查看完整的链路数据。而跨工作空间 Service Map 查询可保证数据查询的连贯性，直接在当前工作空间点击按钮即可查看当前服务的上下游调用拓扑。

更多详情，可参考服务拓扑数据源定义。