调用DescribeCacheAnalysisReport查看Redis实例在指定日期中的缓存分析报告。
- Redis实例的引擎版本为4.0或以上；
- Redis实例的小版本为最新，小版本是否需要升级请参见如何确认Redis实例的小版本是不是最新版。
云数据库Redis版的缓存分析功能在每日全量备份数据时对缓存结构进行分析，找出每个数据节点中占用空间最大的80个Key，保存分析结果供您查看。
除了每天的自动分析，您还可以发起实时的缓存分析任务，可供选择的发起方法如下：
- 调用CreateCacheAnalysisTask创建缓存分析任务。
- 在Redis控制台发起实时分析，操作步骤请参见缓存分析。
说明
- 云数据库Redis版只会保存每天最新的一条分析结果，如您先通过手动操作进行了分析，当日稍晚时间系统进行了自动分析，系统会保留系统自动分析的结果，删除之前手动发起分析任务获得的结果。
- 系统自动进行缓存分析的时间由数据全量备份的时间决定，您可以在控制台的备份与恢复页修改该时间。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeCacheAnalysisReport |
系统规定参数，取值：DescribeCacheAnalysisReport。 |
| AnalysisType | String | 是 | BigKey |
分析类型，当前唯一值： |
| Date | String | 是 | 2019-08-05Z |
需要查询的日期，每次可查询一天的缓存分析结果，格式： |
| InstanceId | String | 是 | r-bp1xxxxxxxxxxxxx |
实例ID。 |
| PageSize | Integer | 否 | 30 |
每页返回的记录数，可选值：
默认值：30。 |
| PageNumbers | Integer | 否 | 1 |
需要返回的页码。 说明 如果该值大于返回结果的最大页数，则返回的大key结果为空。
|
| NodeId | String | 否 | r-bp1xxxxxxxxxxxxx-db-0 |
集群版Redis实例的子节点ID。 说明 如果不设置将返回所有子节点的分析结果。
|
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | A057C066-C3F5-4CC9-9FE4-A8D8B0DCBF19 |
请求ID。 |
| TotalRecordCount | Integer | 160 |
所有页的记录总数。 |
| PageSize | Integer | 30 |
每页显示的最大记录数。 |
| PageNumber | Integer | 1 |
当前页的页码。 |
| PageRecordCount | Integer | 30 |
当前页显示的记录数。 |
| HotKeys | String | [] |
热点key列表。 说明 暂不支持热点key分析，无返回值。
|
| BigKeys | String | [{"db": "0", "qps": 0, "keyType": "list", "isExpired": "no", "analysisType": "BIGKEY", "key": "mylist", "memory": 1005377, "size": 200000}] |
大key列表。 |
示例
请求示例
https://r-kvstore.aliyuncs.com/
?Action=DescribeCacheAnalysisReport
&InstanceId=r-bp1xxxxxxxxxxxxx
&Date=2019-08-05Z
&AnalysisType=BigKey
&<公共请求参数>正常返回示例
XML 格式
<DescribeCacheAnalysisReportResponse>
<PageNumber>1</PageNumber>
<TotalRecordCount>160</TotalRecordCount>
<PageSize>30</PageSize>
<RequestId>A057C066-C3F5-4CC9-9FE4-A8D8B0DCBF19</RequestId>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>list</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>mylist</key>
<memory>1005377</memory>
<size>200000</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:23124</key>
<memory>970</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:167541</key>
<memory>967</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:152015</key>
<memory>958</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:30883</key>
<memory>955</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:81031</key>
<memory>953</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:152007</key>
<memory>952</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:161880</key>
<memory>951</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:194610</key>
<memory>949</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:53620</key>
<memory>948</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:23525</key>
<memory>946</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:89333</key>
<memory>946</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:23687</key>
<memory>945</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:32653</key>
<memory>945</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:72166</key>
<memory>945</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:195881</key>
<memory>944</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:160121</key>
<memory>944</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:93626</key>
<memory>944</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:138451</key>
<memory>944</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:183732</key>
<memory>943</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:143393</key>
<memory>943</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:109289</key>
<memory>943</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:153637</key>
<memory>942</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:171049</key>
<memory>942</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:53013</key>
<memory>941</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:103664</key>
<memory>941</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:180733</key>
<memory>941</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:69766</key>
<memory>941</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:125910</key>
<memory>940</memory>
<size>11</size>
</BigKeys>
<BigKeys>
<db>0</db>
<qps>0</qps>
<keyType>hash</keyType>
<isExpired>no</isExpired>
<analysisType>BIGKEY</analysisType>
<key>customer:10653</key>
<memory>940</memory>
<size>11</size>
</BigKeys>
<PageRecordCount>30</PageRecordCount>
</DescribeCacheAnalysisReportResponse>JSON 格式
{
"PageNumber": 1,
"TotalRecordCount": 160,
"HotKeys": [],
"PageSize": 30,
"RequestId": "A057C066-C3F5-4CC9-9FE4-A8D8B0DCBF19",
"BigKeys": [
{
"db": "0",
"qps": 0,
"keyType": "list",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "mylist",
"memory": 1005377,
"size": 200000
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:23124",
"memory": 970,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:167541",
"memory": 967,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:152015",
"memory": 958,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:30883",
"memory": 955,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:81031",
"memory": 953,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:152007",
"memory": 952,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:161880",
"memory": 951,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:194610",
"memory": 949,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:53620",
"memory": 948,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:23525",
"memory": 946,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:89333",
"memory": 946,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:23687",
"memory": 945,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:32653",
"memory": 945,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:72166",
"memory": 945,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:195881",
"memory": 944,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:160121",
"memory": 944,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:93626",
"memory": 944,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:138451",
"memory": 944,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:183732",
"memory": 943,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:143393",
"memory": 943,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:109289",
"memory": 943,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:153637",
"memory": 942,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:171049",
"memory": 942,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:53013",
"memory": 941,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:103664",
"memory": 941,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:180733",
"memory": 941,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:69766",
"memory": 941,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:125910",
"memory": 940,
"size": 11
},
{
"db": "0",
"qps": 0,
"keyType": "hash",
"isExpired": "no",
"analysisType": "BIGKEY",
"key": "customer:10653",
"memory": 940,
"size": 11
}
],
"PageRecordCount": 30
}错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交