查询执行计划的性能统计趋势

功能说明

查询指定 SQL 的关联的执行计划的性能趋势。

调用说明

接口约束

调用者需具备指定租户的读权限。

请求路径

GET /api/v2/ob/clusters/{clusterId}/tenants/{tenantId}/plans/{uid}/trends

请求参数

返回结果

• 基础数据结构

  参数	类型	说明
  data	Object	请求的数据。
  ├─ contents	Array	计划性能采样的数组，数据结构见下表。
  successful	Boolean	请求是否成功。
  timestamp	Datetime	服务端完成请求的时间戳。
  duration	Integer	服务端处理请求的时间（毫秒）。
  status	Integer	符合 HTTP Status 规范的编码。
  traceId	String	请求的 Trace Id，用于排查问题。
  server	String	响应请求的应用服务的地址。

• 计划性能采样的数据结构

  参数	类型	说明
  timestamp	Datetime	采样的时间戳
  executions	Integer	计划在期间内的执行次数
  execPs	Float	计划在期间内的平均每秒执行次数
  maxExecTime	Float	计划在期间内的最慢执行时间（毫秒）
  avgDiskReads	Float	计划在期间内的平均磁盘读次数
  avgDiskWrites	Float	计划在期间内的平均磁盘写次数
  avgBufferGets	Float	计划在期间内的平均缓存读次数
  avgApplicationWaitTime	Float	计划在期间内的平均 Application 类事件等待时间（毫秒）
  avgConcurrencyWaitTime	Float	计划在期间内的平均 Concurrency 类事件等待时间（毫秒）
  avgUserIoWaitTime	Float	计划在期间内的平均 UserIO 类事件等待时间（毫秒）
  avgRowProcessed	Float	计划在期间内的平均处理行数
  avgElapsedTime	Float	计划在期间内的平均响应时间
  avgCpuTime	Float	计划在期间内的平均 CPU 时间
  largeQueryPercentage	Float	计划在期间内的大查询百分比
  delayedLargeQueryPercentage	Float	计划在期间内被置入队列的大查询的百分比
  timeoutPercentage	Float	计划在期间内执行超时的百分比
  tableScan	Boolean	计划是否包含全表扫描

示例

请求示例

查询集群 Id 为 1 、租户 Id 为 1001、计划 Uids 为 AAAAAAAAAAEAAAAAAAAJ_AAFszE_cnfR 的性能趋势。时间范围为 2020-11-03T19:00:00+08:00 ～ 2020-11-03T20:00。

/api/v2/ob/clusters/1/tenants/1001/plans/AAAAAAAAAAEAAAAAAAAJ_AAFszE_cnfR/trends?startTime=2020-11-03T19%3A00%3A00%2B08%3A00&endTime=2020-11-03T20%3A00%3A00%2B08%3A00

返回示例

{
    "duration": 818,
    "server": "a83ad33525",
    "status": 200,
    "successful": true,
    "timestamp": "2020-11-03T21:21:49.554+08:00",
    "traceId": "ebb7f4eb8c984e12",
    "data": {
        "contents": [
            {
                "avgApplicationWaitTime": 0.00,
                "avgBufferGets": 0.00,
                "avgConcurrencyWaitTime": 0.00,
                "avgCpuTime": 0.00,
                "avgDiskReads": 0.00,
                "avgDiskWrites": 0.00,
                "avgElapsedTime": 1.11,
                "avgRowProcessed": 7.65,
                "avgUserIoWaitTime": 0.00,
                "execPs": 4.63,
                "executions": 3,
                "tableScan": false,
                "timestamp": "2020-11-03T19:00:00.00Z"
            },
            {
                "avgApplicationWaitTime": 0.00,
                "avgBufferGets": 0.00,
                "avgConcurrencyWaitTime": 0.00,
                "avgCpuTime": 0.00,
                "avgDiskReads": 0.00,
                "avgDiskWrites": 0.00,
                "avgElapsedTime": 1.09,
                "avgRowProcessed": 7.69,
                "avgUserIoWaitTime": 0.00,
                "execPs": 4.63,
                "executions": 4,
                "tableScan": false,
                "timestamp": "2020-11-03T19:00:30Z"
            }
        ]
    }
}