本文涉及模块属于「实验性功能」，此类功能使用门槛较高，功能仍在进行打磨优化中。
若您有相关实际使用场景，建议添加微信群，向运营人员获取使用帮助、反馈功能相关建议和评价。
1. 概述编辑
1.1 版本
| 运维平台版本 | 功能变更 |
|---|---|
| V1.5.5 | - |
| V1.5.7 | 1）查询界面新增「重置」按钮，方便重置查询 2）调用链路列表展示优化，支持展开收起，方便放大记录明细区 |
| V1.6.0 | 1）优化「收起侧边列表」按钮交互 2）支持点击复制traceID |
| V1.7.0 | 对于使用elasticsearch套件获取和存储日志的运维项目，在查看链路详情时，支持获取日志到本地 |
| V1.8.0 | 查询界面新增筛选项：端点、状态、实例 |
1.2 功能简介
运维平台提供「调用链路」功能，帮助用户对查询请求中的链路明细进行采集和分析。
支持根据ID、时间等，筛选请求，界面化展示相关链路，帮助管理员监控系统性能异常点。
2. 使用前提编辑
2.1 工程JDK版本
使用链路追踪功能，必须确保FR/BI项目使用JDK8u211及以上版本。
2.2 启用运维组件
链路追踪功能，由这些运维组件提供：elasticSearch、skywalking_oap。
1.5.7及之后版本，这些组件默认启动，用户可手动关闭组件。1.5.6及之前版本，这些组件默认不启动。
如需使用「链路追踪」功能，必须先确保已启动这些组件。否则提示「链路追踪组件未启用，请在运维组件目录中启动elasticsearch以及skywalking_oap」。如下图所示：
管理员登录运维平台，点击「运维管理>运维组件」，先启动elasticSearch组件，再启动skywalking_oap组件。
2.3 工程部署方式
1）非容器化部署的运维项目默认不支持启用链路追踪，如需使用，请先参考该文档调整：非finekey部署应用接入链路追踪 。
2）运维项目与运维平台，是同一个容器化部署工具finekey进行部署的。该运维项目可默认启用链路追踪。
3）运维项目是容器化部署的，但与运维平台并非同一容器化部署工具finekey部署的。
该运维项目需要手动「启用链路追踪」，启用链路追踪时提醒「启用链路追踪需要重启应用，是否启用」。
点击「重启项目并继续」按钮，即会自动重启项目并启用链路追踪功能。
2.4 全局设置
管理员登录运维平台，点击「实验室功能>链路追踪>全局设置」，支持对链路追踪功能进行配置。
建议在使用链路追踪相关功能前，配置好全局设置项。
| 设置项 | 说明 |
|---|---|
| 采集次数上限 | 3秒内同一端点的采集次数限制 默认值-1，表示不限制 输入范围为-1～10000 |
| 不采集的端点 | 不进行采集的端点，如有多个端点，使用逗号分割 默认不进行采集的端点包括： /webroot/decision/metrics/schedule /webroot/decision/system/health /webroot/decision/metrics/once |
| 最大跨度限制 | 采集单个端点的最大跨度（span）数量，超出的将被舍弃 默认值300 输入范围为0～10000 |
| 冗余数据过滤 | 对部分异常概率较低的信息提高采集门槛，如连接前校验，有助于凸显关键信息 默认值5ms -1表示不限制 |
3. 使用示例编辑
3.1 配置查询条件
1）管理员登录运维平台，点击「实验性功能>链路追踪>调用链路」，选择需要进行查询的运维项目和项目组件。
2）配置查询条件，点击「查询」。支持的查询条件如下表所示：
| 查询条件 | 简介 |
|---|---|
| 查询时间 | 说明：筛选所有在此时间范围内开始的查询 可选项：支持选择当前日期过去5天范围内，但查询区间跨度不得大于3天 默认值：当前时间前半小时内 |
| 查询ID | 说明：查找对应session相关记录 可选项：时间范围内的所有sessionID 默认值：为空，即展示全部 |
| 调用链路ID | 说明：查找对应traceID的调用链路 可选项：时间范围内的所有traceID 默认值：为空，即展示全部 |
| 用户 | 说明：筛选该用户触发的所有查询 可选项：所有有记录的用户 默认值：为空，即展示全部 |
| 访问内容 | 说明：筛选查询对象对应的查询记录 可选项：
默认值：为空，即展示全部 |
| 端点耗时 | 说明：筛选调用链路耗时在区间内的查询记录 可选项：非负整数，为空则表示不限制上限/下限 默认值：为空，即展示全部 |
| 端点 | 说明：筛选调用链路类型 可选项：时间范围内的所有端点 默认值：为空，即展示全部 |
| 状态 | 说明：筛选调用链路成功/失败的情况 可选项：
默认值：为空，即展示全部 |
| 实例 | 说明：筛选运维项目中的节点对应的链路，仅集群工程支持该筛选项 可选项：选择集群中的各个节点 默认值：为空，即展示全部 |
| 更多 | 说明：筛选所有标签等于所选值条件的查询 可选项：sessionId、reportId、dec.user.name、fr.domain、fr.cmd、db.type、http.method、http.status_code、db.instance（后五项不可同时选中） 默认值：为空，即展示全部 |
| 重置 | 说明：点击该按钮，即可一键清空以上所有查询条件 |
3.2 链路结果展示
查询后的界面如下图所示：
| 序号 | 说明 | |
|---|---|---|
| 1 | 调用链路排序方式 | 1）支持两种排序方法： 按耗时排序：按照查询的首屏耗时时间排序 按开始时间排序：按照查询触发的时间排序 2）支持两种排序方式：降序/升序 |
| 2 | 调用链路列表 | 展示每一条调用链路的访问内容、链路耗时、开始查询时间 该区域支持收缩展开 |
| 3 | 折叠按钮 | 点击该按钮，支持折叠展开左侧调用链路列表区域 |
| 4 | 调用链路明细 | 以甘特图展示选中的调用链路详细信息 右上角显示链路ID |
| 5 | 耗时查询控件 | 支持使用控件筛选满足耗时范围的链路 |
| 6 | traceID复制按钮 | 点击即可复制traceID |
| 7 | 获取日志 | 使用前提：该运维项目使用elasticsearch套件获取和存储日志 使用说明：点击按钮将下载包含对应TraceID的运维日志到本地 |
鼠标点击可展示每条链路的更详细信息，如下图所示：
