描述
导出多张表的分钟级读写次数等各种监控指标,
注意事项
统计数据是每5分钟上报一次数据的。拉取数据的时候注意拉取的时间范围,需要等数据上报完后再拉取。
例如,当前是2025-05-01 08:00, 只能拉取到 2025-05-01 07:55前的数据。
请求地址
/v2/webservice/report/table/minute-report-data
请求方法
Post
请求参数说明
| 字段名 | 字段说明 | 类型 | 是否必填 | 描述 | 参考值 |
|---|---|---|---|---|---|
| app_id | 项目ID | number | 是 | -- | 2 |
| zone_id | 区ID | number | 是 | 3 | |
| table_name | 表名 | string | 否,不填的时候表示全部 | user_info | |
| report_begin_time | 开始时间 | string | 是 | 开始时间和结束时间跨度不能超过7天 | 2024-07-08,2024-07-08 00:00:00 |
| report_end_time | 结束时间 | string | 是 | 开始时间和结束时间跨度不能超过7天 | 2024-07-09 |
| metrics | 导出指标 | string[] | 否 | 选择要查询的指标, | ["read_number"] |
metrics的可选值
| 字段名 | 字段说明 | 单位 |
|---|---|---|
| read_number | 读次数 | 次/s |
| write_number | 写次数 | 次/s |
| avg_queue_time | 平均排队时间 | 微秒 |
| avg_read_time | 读平均时延 | 微秒 |
| avg_write_time | 写平均时延 | 微秒 |
| slow_process_count | 慢读写次数 | 次/min |
| record_read_number | 读记录数 | 次/s |
| record_write_number | 写记录数 | 次/s |
| large_req_count | 大请求数 | 次/5min |
| req_bytes | 请求流量 | bytes/s |
| resp_bytes | 响应流量 | bytes/s |
| system_error_number | 系统错误数 | 个/5min |
请求示例, 查询从08:00分-08:05分的数据
{
"app_id": 5,
"zone_id": 1,
"table_name":"BattleStatTable",
"report_begin_time": "2024-07-08 08:00:00",
"report_end_time": "2024-07-08 08:05:00"
}
返回data.list参数说明
| 字段名 | 字段说明 | 类型 | 描述 |
|---|---|---|---|
| app_id | 项目ID | ||
| zone_id | |||
| table_name | |||
| update_time | |||
| read_number | 读次数 | 单位:5min/次 | |
| write_number | 写次数 | 单位:5min/次 | |
| …其他指标值 |
成功返回 (查询fake_table表,00:00 - 00:11的读写数据)
{
"code": 0,
"request_id": "e56732af-e71a-46ee-88ce-0135c34ad38b",
"data": {
"list": [
{
"app_id": 5,
"zone_id": 1,
"table_name": "fake_table",
"update_time": "2024-07-08 00:00:00",
"read_number": "0",
"write_number": "1"
},
{
"app_id": 5,
"zone_id": 1,
"table_name": "fake_table",
"update_time": "2024-07-08 00:05:00",
"read_number": "0",
"write_number": "1"
}
],
"total": 2
}
}
失败返回, 数据不存在
{
"request_id": "7caf2d3b-e668-4a10-9a2b-cc81eccc5e3b",
"code": 114,
"message": "没找到svr_rt表, 数据可能还没开始上报, 或上报程序出错",
"debug_message": null
}