You need to enable JavaScript to run this app.
导航
GetAppCPUTrend
最近更新时间:2024.04.25 17:57:50首次发布时间:2024.04.25 17:57:50

调用GetAppCPUTrend获取CPU各项指标趋势。

请求说明

  • 请求方式:POST
  • 请求地址:?Action=GetAppCPUTrend&Version=2024-04-09

ServiceName : apmplus_openapi
Region : cn-beijing
X-App-Ids : xxx
Content-Type : application/json

请求参数

Query

参数

类型

是否必选

示例值

描述

Action

String

GetAppCPUTrend

接口名称。当前 API 的名称为 GetAppCPUTrend

Version

String

2024-04-09

接口版本。当前 API 的版本为 2024-04-09

Body

参数

类型

是否必选

示例值

描述

start_time

Integer

1619827200

起始时间(Unix时间戳)。

end_time

Integer

1619913600

结束时间(Unix时间戳)。

filters

Object of Condition

-

筛选条件,可以指定多个键值对来筛选数据。

granularity

Integer

60

数据粒度。例如 '60' 表示分钟级粒度。

biz_type

String

cpu

业务类型。

  • cpu:CPU指标
  • cpu_thread:CPU异常

metric

String

crash_count

CPU指标。

scales

Array of String

["avg", "pct95", "pct95"]

统计度量。

  • avg:平均值
  • pct25:25分位值
  • pct50:50分位值
  • pct70:70分位值
  • pct90:90分位值
  • pct95:95分位值

Condition

参数

类型

是否必选

示例值

描述

op

String

in

操作符。

  • gt:大于
  • gte:大于等于
  • lt:小于
  • lte:小于等于
  • eq:等于
  • neq:不等于
  • in:包含
  • not_in:不包含
  • lk:like
  • nlk:not like
  • regex:正则匹配
  • not_null:非正则匹配

type

String

expression

筛选条件类型。

  • expression:当前condition是一个表达式
  • and:当前condition是一个复合表达式,多个sub_condition的逻辑关系是and
  • or:当前condition是一个复合表达式,多个sub_condition的逻辑关系是or
  • map:当前condition是map类型

value

String

123456

筛选值。

values

Array of String

[123456]

筛选值,支持多个。

map_key

String

key_1

map类型key,当type为map时必填。

dimension

String

aid

条件的名称。

sub_conditions

Array of Condition

-

子条件。

返回参数

参数

类型

示例值

描述

data

Object of MultiTrendResponseData

-

返回数据。

error_msg

String

-

错误信息。

error_no

Integer

0

错误码。

MultiTrendResponseData

参数

类型

示例值

描述

use_rate

JSON Map

-

用户使用率。

sample_cnt

Object of TrendLine

-

指标趋势。

sample_total

Integer

100

样本总量。

use_rate_avg

Double

0.5

平均值。

Use_rate

参数

类型

示例值

描述

key

String

metric

指标key。

value

Object of TrendLine

-

样本量。

TrendLine

参数

类型

示例值

描述

name

String

test123

线的名称,在分组的情况下,name应该是分组维度的取值,比如用来显示曲线的图标。

points

Array of TrendPoint

-

曲线上的点。

TrendPoint

参数

类型

示例值

描述

alert

Object of AlertPoint

-

提示信息。

value

Double

123

指标值。

timestamp

Long

1665417600

指标发生时间(Unix时间戳)。

readable_timestamp

String

2022-10-11

指标发生时间(自然时间)。

AlertPoint

参数

类型

示例值

描述

msg

String

No error

提示信息。

alert

Boolean

true

是否需要提示。

请求示例

POST ?Action=GetAppCPUTrend&Version=2024-04-09
{
    "start_time": 1619827200,
    "end_time": 1619913600,
    "filters": {
        "type": "and",
        "sub_conditions": [
            {
                "dimension": "apm_version",
                "type": "expression",
                "op": "in",
                "values": [
                    "1.4.5"
                ]
            },
            {
                "dimension": "device_model",
                "type": "expression",
                "op": "in",
                "values": [
                    "MI 5X"
                ]
            }
        ]
    },
    "granularity": 60,
    "biz_type": "cpu",
    "metric": "crash_count",
    "scales": [
        "avg"
    ]
}

返回示例

{
    "data": {
        "use_rate": {
            "key": "avg"
        },
        "sample_cnt": {
            "name": "test123",
            "points": [
                {
                    "alert": "-",
                    "value": 123,
                    "timestamp": 1665417600,
                    "readable_timestamp": "2022-10-11"
                }
            ]
        },
        "sample_total": 100,
        "use_rate_avg": 0.5
    },
    "error_msg": "",
    "error_no": 0
}