创建和配置业务链路

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

前提条件

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

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

创建业务链路

1. 进入观测洞察 → 业务观测 → 业务链路。
2. 点击创建业务链路。
3. 输入易于识别的业务名称，并根据需要开启每日扫描拓扑变化。
4. 保存后，在链路编排页面继续添加和配置节点。

开启每日扫描后，系统会比较最近一次扫描结果与当前已保存拓扑。具体处理方法请参见发现并处理业务链路拓扑变化。

构建业务拓扑

添加节点

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

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

连接上下游节点

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

定义接口

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

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

设置入口节点

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

发现已有关系

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

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

复用相似节点

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

配置健康判断

配置节点关键指标

分组和系统节点都可以配置关键指标，用于在业务链路中持续判断对应业务范围的健康状态。

1. 编辑目标分组或系统节点并进入关键指标。
2. 按指标模块逐层展开并选择指标；指标较多时，使用分层结构缩小查找范围。
3. 需要组合或计算指标时，切换到表达式模式完成配置。
4. 保存后，在节点卡片中检查指标是否正确显示。

配置业务链路关键指标

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

关联告警规则

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

组织展示方式

使用卡片分组

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

添加自定义视图

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

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

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

配置纵向架构观测

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

验证配置

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

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

常见问题

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

下一步

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