调用DescribeHistoryMonitorValues查看Redis实例的性能监控信息。

该API对应的控制台操作请参见性能监控

调试

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

请求参数

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

系统规定参数,取值:DescribeHistoryMonitorValues

EndTime String 2018-10-19T12:00:00Z

历史监控结束时间点,须晚于历史监控开始时间,格式为yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

InstanceId String r-bp1zxszhcgatnx****

实例ID。

IntervalForHistory String 01m

历史监控数据间隔,单位为分钟,取值固定为01m

StartTime String 2018-10-18T12:00:00Z

历史监控开始时间点,格式为yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

NodeId String r-bp1xxxxxxxxxxxxx-db-0

实例的中的节点ID。传入本参数可查询指定节点的监控信息。

说明
  • 当Redis实例的架构为读写分离或集群架构时,本参数才可用。
  • 您可以调用DescribeLogicInstanceTopology接口查询节点ID。
MonitorKeys String CpuUsage

监控指标,如需传入多个监控指标,需使用英文逗号(,)分隔。

说明
  • 为保障查询效率,查询单个节点的监控指标时,单次最多传入5个监控指标;查询聚合监控指标时,单次仅传入1个监控指标。
  • 关于Redis实例支持的监控指标及其详细说明,请参见监控指标(MonitorKeys)
RegionId String cn-hangzhou

实例所属的地域ID。

返回数据

名称 类型 示例值 描述
MonitorHistory String {\"2020-11-18T00:00:00Z\":{\"CpuUsage\":\"0.30\"},\"2020-11-18T00:02:00Z\":{\"CpuUsage\":\"0.60\"},\"2020-11-18T00:03:00Z\":{\"CpuUsage\":\"0.60\"}}

以JSON格式返回的监控信息,更多信息,请参见监控指标说明

说明 为提高数据传输效率,只有非0的监控数据才会返回,其余未显示的监控数据均为默认值0
RequestId String F0997EE8-F4C2-4503-9168-85177ED7****

请求ID。

示例

请求示例

https://r-kvstore.aliyuncs.com/?Action=DescribeHistoryMonitorValues
&InstanceId=r-bp1zxszhcgatnx****
&StartTime=2018-10-18T12:00:00Z
&EndTime=2018-10-18T12:03:00Z
&IntervalForHistory=01m
&MonitorKeys=CpuUsage
&<公共请求参数>

正常返回示例

XML 格式

<DescribeHistoryMonitorValuesResponse>
      <MonitorHistory>{"2020-11-18T00:00:00Z":{"CpuUsage":"0.30"},"2020-11-18T00:02:00Z":{"CpuUsage":"0.60"},"2020-11-18T00:03:00Z":{"CpuUsage":"0.60"}}</MonitorHistory>
      <RequestId>689E8093-3094-4DC2-A2A2-30D40097****</RequestId>
</DescribeHistoryMonitorValuesResponse>

JSON 格式

{
	"MonitorHistory": "{\"2020-11-18T00:00:00Z\":{\"CpuUsage\":\"0.30\"},\"2020-11-18T00:02:00Z\":{\"CpuUsage\":\"0.60\"},\"2020-11-18T00:03:00Z\":{\"CpuUsage\":\"0.60\"}}",
	"RequestId": "689E8093-3094-4DC2-A2A2-30D40097****"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidEndTime.Malformed The Specified parameter "EndTime" is not valid. 结束时间验证失败,时间格式应该为gmt时间例如,2011-06-11T16:00Z

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