本文涉及模块属于「实验性功能」,此类功能使用门槛较高,功能仍在进行打磨优化中。
若您有相关实际使用场景,建议添加微信群,向运营人员获取使用帮助、反馈功能相关建议和评价。
1. 概述编辑
1.1 版本
运维平台版本 | 功能变更 |
---|---|
V1.5.5 | - |
V1.5.7 | 1)查询界面新增「重置」按钮,方便重置查询 2)调用链路列表展示优化,支持展开收起,方便放大记录明细区 |
V1.6.0 | 1)优化「收起侧边列表」按钮交互 2)支持点击复制traceID |
V1.7.0 | 对于使用elasticsearch套件获取和存储日志的运维项目,在查看链路详情时,支持获取日志到本地 |
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的运维日志到本地 |
鼠标点击可展示每条链路的更详细信息,如下图所示: