业务观测落地步骤

按照以下步骤建立第一条可用的业务链路。完成后，你可以在业务链路首页看到目标业务的状态和关键指标，并能够从链路图进入节点详情。

开始前

• 确认你具有业务观测的查看和编辑权限。
• 明确需要持续观察的关键业务路径，以及业务请求的入口。
• 确认关键业务实体已通过以下任一方式接入：

数据来源	适用数据	开始前检查
Agent	主机、进程、服务、应用运行时数据及其关系	目标实体已出现，并在预期时间范围内持续上报。
数据集成	外部系统、组件、云服务或监控平台中的指标、告警、日志和调用链	集成已启用，目标数据可以查询。

有关接入方式，请参见 SmartAgent 和数据集成。

1. 确定最小业务范围

先选择一条可以用业务结果验证的关键路径：

1. 确认业务请求从哪个系统或服务进入。
2. 识别直接影响业务结果的关键节点和上下游方向。
3. 选择请求量、响应时间、错误率或其他能够代表业务结果的指标。
4. 明确哪些异常需要通过告警状态体现。

第一版链路只保留必要节点。数据和指标口径验证完成后，再补充接口、技术组件和纵向架构。

2. 创建业务链路

1. 进入观测洞察 → 业务观测 → 业务链路。
2. 点击创建业务链路，输入可识别的业务名称并保存。
3. 从左侧添加系统、服务或其他关键节点。
4. 从上游节点拖动连线到下游节点，确保方向与真实请求方向一致。
5. 将业务请求进入的位置设置为入口节点。

如果节点已有可观测调用关系，可以使用发现关系按时间范围和接口补充关联服务与连线。只需要观察部分接口时，在连线上使用定义接口限制聚合范围。

3. 配置健康判断依据

配置项	使用方式	结果
节点关键指标	为关键节点选择指标或使用表达式定义指标	指标显示在节点卡片中。
业务链路关键指标	选择能够代表整条业务结果的指标	指标显示在健康大盘和链路详情中。
告警规则	按需要关联已有告警规则	规则触发后显示告警数量和对应状态。
纵向架构	为技术组件或第三方实体补充资源关系	可以继续查看主机、进程和服务实例。

入口节点会影响核心指标的计算口径：入口节点基于下游第一层连线计算，其他节点基于上游连线计算。

有关完整配置选项，请参见创建和配置业务链路。

4. 验证落地结果

保存后返回业务链路首页，并确认：

1. 可以按名称或分组找到目标业务链路。
2. 卡片显示预期的节点、健康状态和关键指标。
3. 节点和连线方向符合真实业务路径。
4. 打开链路后，可以从节点进入所需的指标、告警、日志或调用链页面。

如果业务拓扑由第三方系统统一维护，请使用外部数据同步指南导入链路；开发同步接口时参见外部同步 API 参考。

下一步

• 使用最佳实践优化链路范围、指标和日常监控方式。
• 发现异常时，按照业务链路排障实践完成定位和恢复验证。