创建和配置业务链路

创建业务链路的目标不是复刻所有技术依赖，而是把影响关键业务结果的节点、连接和健康指标组织成一条可监控、可下钻的业务路径。

前提条件

• 业务范围和关键路径已经明确。
• 所需实体和指标已通过 Agent 或数据集成接入。
• 你具有业务观测的编辑权限。

如果尚未创建过业务链路，请先完成落地步骤中的创建业务链路。

创建业务链路

1. 进入观测洞察 → 业务观测 → 业务链路。
2. 点击创建业务链路。
3. 输入易于识别的业务名称并保存。
4. 在链路编排页面继续添加和配置节点。

构建业务拓扑

添加节点

从左侧选择实体并添加到画布。业务链路支持以下实体：

实体类型	典型用途
系统、服务、接口	表达核心业务系统及其调用关系。
技术组件	表达数据库、中间件等基础技术依赖。
应用组件	表达数据库调用、消息队列、远程服务或关键方法。
第三方实体	表达外部系统或未直接纳管的依赖。

连接上下游节点

从上游节点的连接点拖动到下游节点，形成有方向的业务关系。连线方向应与真实业务请求方向一致。

定义接口

默认情况下，节点连线聚合上下游之间的全部调用。需要只观察特定接口时：

1. 将鼠标移到目标连线上。
2. 点击定义接口。
3. 添加需要纳入业务链路的接口并保存。

设置入口节点

将业务请求进入链路的位置设置为入口节点。入口节点的核心指标基于其下游第一层连线计算；其他节点的核心指标基于上游连线计算。入口节点设置错误会影响链路指标口径。

发现已有关系

当节点已存在可观测调用关系时，可以自动补充关联服务和连线：

1. 编辑目标节点并点击发现关系。
2. 选择时间范围。
3. 根据需要选择一个或多个接口。
4. 保存发现结果。

复用相似节点

编辑节点并点击克隆可创建一个独立副本。克隆后仍需根据实际业务关系手动连接上下游节点。

配置健康判断

配置节点关键指标

1. 编辑目标节点并进入关键指标。
2. 选择已有指标，或使用表达式定义指标。
3. 保存后，在节点卡片中检查指标是否正确显示。

配置业务链路关键指标

为整条业务链路选择能够代表业务结果的指标。保存后，这些指标会显示在业务健康大盘和链路详情中。

关联告警规则

根据需要为业务链路关联告警规则。规则触发后，业务健康大盘会显示告警数量，并可进入告警列表查看详情。

组织展示方式

使用卡片分组

新建业务链路默认归入“未分组”。按业务域、团队或值守范围创建分组，便于在首页筛选和比较相关链路。

添加自定义视图

可以将已有仪表盘或自定义视图添加到业务链路。添加后，生效范围不可修改：

• 当前实例
• 部分实例
• 全部实例

默认显示优先级为“当前实例 > 部分实例 > 全部实例”；相同优先级下，后添加的视图优先。

配置纵向架构观测

对于技术组件和第三方实体，可以补充纵向架构关系，用于从业务节点继续查看主机、进程、服务实例等关联资源。

验证配置

保存后返回业务链路首页，并检查：

• 业务链路名称和分组正确。
• 节点与连线符合真实业务方向。
• 入口节点和接口范围正确。
• 关键指标有数据，告警规则已生效。
• 节点详情可以进入预期的指标、日志或调用链页面。

常见问题

现象	处理建议
发现关系没有结果	扩大时间范围，并确认目标节点在该时间段内存在调用数据。
关键指标为空	确认指标选择和表达式正确，并检查数据接入和时间范围。
链路指标口径异常	检查入口节点、连线方向和接口定义。
自定义视图不是预期页面	检查视图生效范围和添加顺序。

下一步

• 日常查看业务状态或处理异常，请参见监控与排障。