notes/work/移动杭研/开发记录/7.12.0/20250729102850.md

网关转发记录曲线图接口说明

接口概述

新增了一个高效的曲线图数据查询接口，用于展示网关转发记录的统计数据。该接口支持多种时间粒度的聚合查询，并提供丰富的过滤条件。

接口信息

• 接口路径: POST /gateway/record/chart
• 请求方式: POST
• Content-Type: application/json

请求参数

必填参数

参数名	类型	说明	示例
startTime	LocalDateTime	查询开始时间	"2024-01-01 00:00:00"
endTime	LocalDateTime	查询结束时间	"2024-01-01 23:59:59"
timeGranularity	String	时间粒度	"5MIN"

时间粒度选项

值	说明	聚合方式
5MIN	5分钟	按5分钟间隔聚合（00:00-00:04, 00:05-00:09…）
1HOUR	1小时	按小时聚合
1DAY	1天	按天聚合
1WEEK	1周	按周聚合（周一为起始）
1MONTH	1月	按月聚合

可选过滤参数

参数名	类型	说明	是否支持模糊查询
requestUrl	String	接口路径	✅
method	String	请求方法	❌
targetEndpoint	String	目的地址	✅
httpCode	Integer	HTTP状态码	❌
gatewayEndpoint	String	网关地址	✅
minCostTime	Integer	最小耗时(ms)	❌
maxCostTime	Integer	最大耗时(ms)	❌
routeId	Long	路由ID	❌
routeName	String	路由名称	✅

请求示例

{  
    "startTime": "2024-01-01 00:00:00",    "endTime": "2024-01-01 23:59:59",    "timeGranularity": "1HOUR",    "requestUrl": "/api/user",    "method": "GET",    "minCostTime": 100,    "maxCostTime": 5000}  

响应数据结构

{  
    "code": 200,    "msg": "操作成功",  
    "data": {        "dataPoints": [            {                "timePoint": "2024-01-01 00:00:00",                "count2xx": 150,                "count4xx": 10,                "count5xx": 2,                "countOther": 1,                "avgCostTime": 245.67            },            {                "timePoint": "2024-01-01 01:00:00",                "count2xx": 200,                "count4xx": 15,                "count5xx": 3,                "countOther": 0,                "avgCostTime": 198.34            }        ]    }}  

响应字段说明

dataPoints 数组中每个元素的字段

字段名	类型	说明
timePoint	LocalDateTime	时间点（X轴）
count2xx	Long	2xx状态码请求次数（左Y轴）
count4xx	Long	4xx状态码请求次数（左Y轴）
count5xx	Long	5xx状态码请求次数（左Y轴）
countOther	Long	其他状态码请求次数（左Y轴）
avgCostTime	BigDecimal	平均耗时ms，保留2位小数（右Y轴）

性能优化说明

1. 索引优化: 建议在 request_time 字段上创建索引以提高查询效率
2. 模糊查询: 仅在 requestUrl、targetEndpoint、gatewayEndpoint、routeName 字段支持模糊查询
3. 时间范围: 建议查询时间范围不要过大，以保证响应速度
4. 聚合查询: 使用数据库层面的聚合查询，减少内存占用

前端图表建议

• 左Y轴: 显示请求次数（count2xx, count4xx, count5xx, countOther）
• 右Y轴: 显示平均耗时（avgCostTime）
• X轴: 显示时间（timePoint）
• 图表类型: 建议使用折线图或柱状图
• 颜色建议:
  • 2xx: 绿色（成功）
  • 4xx: 橙色（客户端错误）
  • 5xx: 红色（服务器错误）
  • 其他: 灰色
  • 平均耗时: 蓝色

注意事项

1. 时间粒度为左闭右开区间
2. 大数据量查询时建议适当限制时间范围
3. 模糊查询会影响性能，请谨慎使用
4. 平均耗时为0表示该时间段内没有有效的耗时数据