调用DescribeHybridMonitorDataList接口查询指定指标仓库中的监控数据。

前提条件

请确保您已开通企业云监控。具体操作，请参见开通企业云监控。

使用限制

单次最多返回监控数据1.5 MB。如果返回数据过大，则查询失败，请您重新设置查询条件。

使用说明

本文将提供一个示例，查询指标仓库default-aliyun中监控指标AliyunEcs_cpu_total在指定时间1653804865（2022-05-29 14:14:25）至1653805225（2022-05-29 14:20:25）内的监控数据。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeHybridMonitorDataList

要执行的操作，取值：DescribeHybridMonitorDataList。

Namespace String 是 default-aliyun

指标仓库名称。

关于如何获取指标仓库名称，请参见DescribeHybridMonitorNamespaceList。

PromSQL String 是 AliyunEcs_cpu_total

监控指标。

说明 支持PromQL查询语句。
Start Long 是 1653804865

开始时间戳。

单位：秒。
End Long 是 1653805225

结束时间戳。

单位：秒。
Period String 否 60

监控数据的统计周期。

单位：秒。

关于公共请求参数的详情，请参见公共参数。

返回数据

名称 类型 示例值 描述
Code String 200

状态码。

说明 200表示成功。
Message String end timestamp must not be before start time.

错误信息。
RequestId String C240412F-3F5F-50E2-ACEC-DE808EF9C4BE

请求ID。
Success String true

操作是否成功。取值：

  • true：成功。
  • false：失败。
TimeSeries Array of TimeSeries

监控指标的时间线列表。
MetricName String AliyunEcs_cpu_total

监控指标名称。
Labels Array of Label

时间维度的标签。
K String instanceId

标签键。
V String i-rj99xc6cptkk64ml****

标签值。
Values Array of Value

时间点的值。
V String 0.13

监控指标的值。
Ts String 1653804865

监控指标值对应的时间戳。

单位：秒。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeHybridMonitorDataList
&Namespace=default-aliyun
&PromSQL=AliyunEcs_cpu_total
&Start=1653804865
&End=1653805225
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeHybridMonitorDataList>
	<TimeSeries>
		<MetricName>AliyunEcs_cpu_total</MetricName>
		<Values>
			<V>0.13</V>
			<Ts>1653804865</Ts>
		</Values>
		<Values>
			<V>0.13</V>
			<Ts>1653804925</Ts>
		</Values>
		<Values>
			<V>0.13</V>
			<Ts>1653804985</Ts>
		</Values>
		<Values>
			<V>0.17</V>
			<Ts>1653805045</Ts>
		</Values>
		<Values>
			<V>0.23</V>
			<Ts>1653805105</Ts>
		</Values>
		<Values>
			<V>0.2</V>
			<Ts>1653805165</Ts>
		</Values>
		<Values>
			<V>0.13</V>
			<Ts>1653805225</Ts>
		</Values>
		<Labels>
			<V>rg-acfmw3ty5y7****</V>
			<K>rmgroup_id</K>
		</Labels>
		<Labels>
			<V>ESS</V>
			<K>tag_ess</K>
		</Labels>
		<Labels>
			<V>hostname1</V>
			<K>hostname</K>
		</Labels>
		<Labels>
			<V>i-rj99xc6cptkk64ml****</V>
			<K>instanceId</K>
		</Labels>
		<Labels>
			<V>cn-hangzhou</V>
			<K>regionId</K>
		</Labels>
		<Labels>
			<V>192.168.XX.XX</V>
			<K>ipgroup</K>
		</Labels>
		<Labels>
			<V>120886317861****</V>
			<K>userId</K>
		</Labels>
	</TimeSeries>
	<RequestId>C240412F-3F5F-50E2-ACEC-DE808EF9C4BE</RequestId>
	<Code>200</Code>
	<Success>true</Success>
</DescribeHybridMonitorDataList>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TimeSeries" : [ {
    "MetricName" : "AliyunEcs_cpu_total",
    "Values" : [ {
      "V" : "0.13",
      "Ts" : 1653804865
    }, {
      "V" : "0.13",
      "Ts" : 1653804925
    }, {
      "V" : "0.13",
      "Ts" : 1653804985
    }, {
      "V" : "0.17",
      "Ts" : 1653805045
    }, {
      "V" : "0.23",
      "Ts" : 1653805105
    }, {
      "V" : "0.2",
      "Ts" : 1653805165
    }, {
      "V" : "0.13",
      "Ts" : 1653805225
    } ],
    "Labels" : [ {
      "V" : "rg-acfmw3ty5y7****",
      "K" : "rmgroup_id"
    }, {
      "V" : "ESS",
      "K" : "tag_ess"
    }, {
      "V" : "hostname1",
      "K" : "hostname"
    }, {
      "V" : "i-rj99xc6cptkk64ml****",
      "K" : "instanceId"
    }, {
      "V" : "cn-hangzhou",
      "K" : "regionId"
    }, {
      "V" : "192.168.XX.XX",
      "K" : "ipgroup"
    }, {
      "V" : "120886317861****",
      "K" : "userId"
    } ]
  } ],
  "RequestId" : "C240412F-3F5F-50E2-ACEC-DE808EF9C4BE",
  "Code" : "200",
  "Success" : true
}

错误码

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