调用DescribeHotBigKeys接口实时获取当前内存中的热Key和大Key。

当Key的Size个数排名前3的会被记录为大Key;当某个Key的QPS大于3,000时会被记录为热点Key。

  • 在使用阿里云SDK时,需要保证aliyun-sdk-core的版本大于4.3.3,建议使用最新版本。
  • 使用DAS的SDK的版本为1.0.2或以上。
  • 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。
  • 本接口只适用于如下Redis实例:
    • 社区版4.0或5.0(0.4.0及以上)
    • 企业版5.0(1.5.1及以上)
说明 关于如何查询小版本、升级小版本,详情请参见 ModifyInstanceMinorVersionDescribeEngineVersion

请求参数

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

系统规定参数。取值:DescribeHotBigKeys

ConsoleContext String None

备用参数。

InstanceId String r-bp18ff4a195d****

Redis实例ID,您可以调用DescribeInstances接口获取。

NodeId String r-****-db-0

Redis实例的数据分片ID,您可以调用DescribeRoleZoneInfo接口获取。

返回数据

名称 类型 示例值 描述
Message String Successful

请求返回消息。

RequestId String B6D17591-B48B-4D31-9CD6-9B9796B2****

请求ID。

Data Object

详情信息列表。

HotKeys Array of HotKey

热键详细列表。

HotKey
Key String abc:def:eng

具体的Key。

Db Integer 0

Key所在的DB。

Hot String 5500~6000

Key的访问频次。

KeyType String zset

Key的类型。

Lfu Integer 253

LFU算法的统计值。

NodeId String r-x****-db-0

Redis实例的数据分片ID。

BigKeys Array of BigKey

大Key的详细列表。

BigKey
Db Integer 0

Key所在的DB。

Key String abc:def:eng

具体的Key。

KeyType String zset

Key类型。

Size Long 2

元素的个数。

NodeId String r-x****-db-0

Redis实例的数据分片ID。

HotKeyMsg String current version doesn't support

获取热Key失败的原因。

BigKeyMsg String current version doesn't support

获取大Key失败的原因。

Code String 200

返回的状态码。

Success String true

请求是否执行成功:

  • true:执行成功。
  • false:执行失败。

示例

请求示例

http(s)://das.cn-shanghai.aliyuncs.com/?Action=DescribeHotBigKeys
&ConsoleContext=6c2e064b-a45f-4bd0-8a80-*********
&InstanceId=r-bp18ff4a195d****
&NodeId=r-****-db-0
&公共请求参数

正常返回示例

XML格式

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

<DescribeHotBigKeysResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <HotKeys>
            <Key>abc:def:eng</Key>
            <Db>0</Db>
            <Hot>5500~6000</Hot>
            <KeyType>zset</KeyType>
            <Lfu>253</Lfu>
            <NodeId>r-x****-db-0</NodeId>
        </HotKeys>
        <BigKeys>
            <Db>0</Db>
            <Key>abc:def:eng</Key>
            <KeyType>zset</KeyType>
            <Size>2</Size>
            <NodeId>r-x****-db-0</NodeId>
        </BigKeys>
        <HotKeyMsg>current version doesn't support</HotKeyMsg>
        <BigKeyMsg>current version doesn't support</BigKeyMsg>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeHotBigKeysResponse>

JSON格式

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

{
  "Message" : "Successful",
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data" : {
    "HotKeys" : [ {
      "Key" : "abc:def:eng",
      "Db" : 0,
      "Hot" : "5500~6000",
      "KeyType" : "zset",
      "Lfu" : 253,
      "NodeId" : "r-x****-db-0"
    } ],
    "BigKeys" : [ {
      "Db" : 0,
      "Key" : "abc:def:eng",
      "KeyType" : "zset",
      "Size" : 2,
      "NodeId" : "r-x****-db-0"
    } ],
    "HotKeyMsg" : "current version doesn't support",
    "BigKeyMsg" : "current version doesn't support"
  },
  "Code" : "200",
  "Success" : "true"
}

错误码

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