获取PostgreSQL慢日志模板
更新时间：2025-05-08
接口描述
获取PostgreSQL数据库指定时间范围内的慢日志模板统计数据，按SQL指纹进行聚合，包含执行次数、平均执行时间等统计信息。
权限说明
鉴权认证机制的详细内容请参见鉴权认证。
请求结构
Plain
1GET /api/v{version}/diagnosis/postgresql/slowlog/template?product=string&appId=string&nodeId=string&start=string&end=string&&dbNames=dbNames&clientIps=clientIps&fingerprintMd5=fingerprintMd5page=int&pageSize=int HTTP/1.1
2Host: dbsc.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | string | 是 | Path参数 | API版本号 |
| appId | string | 是 | Query参数 | 实例ID，例如：rdsmte2lk8ap0sl |
| nodeId | string | 是 | Query参数 | 节点ID |
| start | string | 是 | Query参数 | 查询开始时间，UTC格式，例如：2023-06-01T00:00:00Z |
| end | string | 是 | Query参数 | 查询结束时间，UTC格式，例如：2023-06-02T00:00:00Z |
| users | string | 否 | Query参数 | 数据库用户，多个以逗号分隔 |
| dbNames | string | 否 | Query参数 | 数据库，多个以逗号分隔 |
| clientIps | string | 否 | Query参数 | 客户端IP，多个以逗号分隔 |
| fingerprintMd5 | string | 否 | Query参数 | SQL的归一化指纹的MD5值 |
| page | int | 否 | Query参数 | 分页页码，默认值为1 |
| pageSize | int | 否 | Query参数 | 每页记录数，默认值为20 |
| orderBy | string | 否 | Query参数 | 排序字段，默认为durationCount。支持的排序字段：executeTimes：执行次数durationSum：总执行时间durationMax：最大执行时间durationMin：最小执行时间durationAvg：平均执行时间 |
| order | string | 否 | Query参数 | 排序方向，可选值为asc和desc，默认为desc |
响应头域
无。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| totalCount | int64 | 总记录数 |
| items | []APIPGSlowLogTemplateItem | 慢日志模板项 |
APIPGSlowLogTemplateItem结构
| 字段名 | 类型 | 说明 |
|---|---|---|
| fingerprintMD5 | string | SQL指纹的MD5值 |
| fingerprint | string | SQL指纹 |
| dbName | string | 数据库名称 |
| executeTimes | int64 | 执行次数 |
| durationSum | int64 | 总执行时间（毫秒） |
| durationMax | int64 | 最大执行时间（毫秒） |
| durationMin | int64 | 最小执行时间（毫秒） |
| durationAvg | int64 | 平均执行时间（毫秒） |
请求示例
Plain
1GET /api/v1/diagnosis/postgresql/slowlog/template?product=rds&appId=rdsmte2lk8ap0sl&nodeId=i-node1&start=2023-06-01T00:00:00Z&end=2023-06-02T00:00:00Z&page=1&pageSize=10 HTTP/1.1
2Host: dbsc.bj.baidu.com
3Content-Type: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2023-07-11T11:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de响应示例
JSON
1{
2 "totalCount": 50,
3 "items": [
4 {
5 "fingerprintMD5": "a1b2c3d4e5f6g7h8i9j0",
6 "fingerprint": "SELECT * FROM large_table WHERE id > ? ORDER BY created_at DESC",
7 "dbName": "test_db",
8 "executeTimes": 120,
9 "durationSum": 180000,
10 "durationMax": 3500,
11 "durationMin": 1000,
12 "durationAvg": 1500
13 },
14 {
15 "fingerprintMD5": "b2c3d4e5f6g7h8i9j0k1",
16 "fingerprint": "SELECT t1.*, t2.name FROM table1 t1 JOIN table2 t2 ON t1.id = t2.id WHERE t1.status = ?",
17 "dbName": "test_db",
18 "executeTimes": 85,
19 "durationSum": 272000,
20 "durationMax": 5000,
21 "durationMin": 2000,
22 "durationAvg": 3200
23 },
24 {
25 "fingerprintMD5": "c3d4e5f6g7h8i9j0k1l2",
26 "fingerprint": "INSERT INTO logs (user_id, action, created_at) VALUES (?, ?, ?)",
27 "dbName": "app_logs",
28 "executeTimes": 350,
29 "durationSum": 385000,
30 "durationMax": 2200,
31 "durationMin": 800,
32 "durationAvg": 1100
33 }
34 ]
35}