全部产品
Search
文档中心

应用实时监控服务ARMS:QueryMetric - 查询监控指标

更新时间:Aug 27, 2026

调用QueryMetric查询相关监控指标。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

xtrace:SearchTrace

get

*全部资源

*

无 无

请求参数

名称

类型

必填

描述

示例值

IntervalInSec

integer

否

数据片的时间间隔,单位为毫秒,最小值为 60000。

100000

StartTime

integer

是

开始时间,精确到毫秒(ms)。

重要 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。

1575561600000

EndTime

integer

是

结束时间,精确到毫秒(ms)。

重要 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。

1575622455686

OrderBy

string

否

排序字段,根据查询返回字段中的某个字段排序。

count

Limit

integer

否

返回数据条数。

100

Metric

string

是

指标名称,取值:

  • appstat.incall:接口统计。

  • appstat.sql:SQL 统计。

appstat.incall

Order

string

否

排序,取值:

  • ASC:升序。

  • DESC:降序。

ASC

ProxyUserId

string

否

代理用户 ID。

testefgag12

Filters

array<object>

否

过滤字段列表。

object

否

过滤字段列表

Key

string

否

过滤字段的 Key。

service

Value

string

否

过滤字段的 Value。

service-test

Dimensions

array

否

维度,即 GroupBy 分组。

RT

string

否

指标对应的维度。

pid

Measures

array

是

查询字段。

count

string

否

Metric 取值为appstat.incall时,Measures 取值:

  • rt:响应时间。

  • count:总数。

  • error:错误数。

  • exception:异常。

  • errorrate:错误率。

  • qps:每秒请求数。

Metric 取值为appstat.sql时,Measures 取值:

  • rt:响应时间。

  • count:总数。

  • error:错误数。

  • slowcount:慢调用次数。

rt

返回参数

名称

类型

描述

示例值

object

Data

string

返回统计信息。

{ "Data": "{\"data\":[{\"date\":1583686800000,\"count\":0,\"rt\":0,\"rpc\":\"childSpan3\"}]}}

RequestId

string

请求 ID。

1E2B6A4C-6B83-4062-8B6F-AEEC1F******

示例

正常返回示例

JSON格式

{
  "Data": "{ \"Data\": \"{\\\"data\\\":[{\\\"date\\\":1583686800000,\\\"count\\\":0,\\\"rt\\\":0,\\\"rpc\\\":\\\"childSpan3\\\"}]}}",
  "RequestId": "1E2B6A4C-6B83-4062-8B6F-AEEC1F******"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。