全部产品
Search

搜索本产品

    云数据库 Tair（兼容 Redis®）：DescribeSlowLogRecords - 查看慢日志明细

    文档中心

    云数据库 Tair（兼容 Redis®）：DescribeSlowLogRecords - 查看慢日志明细

    更新时间：Nov 07, 2024

    查询云数据库 Tair（兼容 Redis）实例在指定时间内产生的慢日志。

    接口说明

    该 API 对应的控制台操作请参见查询慢日志。 DescribeSlowLogRecords 的调用频率上限为 100 次/分钟。

    调试

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

    授权信息

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

    • 操作：是指具体的权限点。
    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
      • 对于必选的资源类型，用背景高亮的方式表示。
      • 对于不支持资源级授权的操作，用全部资源表示。
    • 条件关键字：是指云产品自身定义的条件关键字。
    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
    操作访问级别资源类型条件关键字关联操作
    kvstore:DescribeSlowLogRecordsget
    • DBInstance
      acs:kvstore:{#regionId}:{#accountId}:dbinstance/{#dbInstanceId}
      无
    		无

    请求参数

    名称类型必填描述示例值
    InstanceIdstring是

    实例 ID。

    		r-bp1zxszhcgatnx****
    NodeIdstring否

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

    说明 当实例的架构为读写分离或集群架构时，本参数才可用。
    		r-bp1zxszhcgatnx****-db-0
    StartTimestring是

    查询开始时间，格式为yyyy-MM-ddTHH:mmZ（UTC 时间）。

    		2019-03-10T14:00Z
    EndTimestring是

    查询结束时间，必须晚于查询开始时间，且起止时间的范围不能超过 1 天（推荐范围为 1 小时），格式为yyyy-MM-ddTHH:mmZ（UTC 时间）。

    		2019-03-10T15:00Z
    DBNamestring否

    数据库名称。

    		0
    PageSizeinteger否

    每页可展示的最大记录数，取值：30、50、100，默认值为 30。

    		30
    PageNumberinteger否

    页码，取值为大于 0 且不超过 Integer 数据类型的最大值，默认值为 1。

    		1
    SlowLogRecordTypestring否

    慢日志类型，取值：

    • proxy：代理节点中的慢日志。
    • db：默认值，数据节点中的慢日志。
    		proxy
    QueryKeywordstring否

    可设置一个字符串类型的值，使用该值作为关键词对返回结果进行搜索。

    		keyword1
    OrderTypestring否

    返回结果的排序方式，取值：

    • ASC：升序。
    • DESC：默认值，降序。
    		ASC
    OrderBystring否

    返回结果的排序依据，取值：

    • execution_time：默认值，按照请求的执行开始时间排序。
    • latency：按照请求的执行耗时排序。
    		execution_time

    返回参数

    名称类型描述示例值
    object
    StartTimestring

    查询的开始时间。

    		2019-03-10T14:00Z
    RequestIdstring

    请求 ID。

    		686BB8A6-BBA5-47E5-8A75-D2ADE433****
    PageRecordCountinteger

    当前页显示的日志数。

    		1
    TotalRecordCountinteger

    日志条目总数。

    		1
    PageSizeinteger

    每页显示的日志数上限。

    		30
    InstanceIdstring

    实例 ID。

    		r-bp10n********
    Enginestring

    数据库类型。

    		Redis
    PageNumberinteger

    当前显示的页码。

    		1
    Itemsarray<object>

    由慢日志信息组成的集合。

    LogRecordsobject
    Accountstring

    账号 ID。

    		0
    ElapsedTimelong

    执行时长，单位为微秒。

    		248
    Commandstring

    慢查询语句。

    		KEYS *
    DBNamestring

    数据库名称。

    		0
    ExecuteTimestring

    执行开始时间，格式：YYYY-MM-DDTHH:mm:ssZ。

    		2019-03-12T09:18:41Z
    DataBaseNamestring

    数据库名称，与 DBName 作用一致，推荐使用 DBName 参数。

    		0
    NodeIdstring

    节点 ID。

    		r-bp1zxszhcgatnx****-db-0
    AccountNamestring

    账号名称。

    		demo
    IPAddressstring

    客户端的 IP 地址。

    		172.16.88.***

    示例

    正常返回示例

    JSON格式

    {
  "StartTime": "2019-03-10T14:00Z",
  "RequestId": "686BB8A6-BBA5-47E5-8A75-D2ADE433****",
  "PageRecordCount": 1,
  "TotalRecordCount": 1,
  "PageSize": 30,
  "InstanceId": "r-bp10n********",
  "Engine": "Redis",
  "PageNumber": 1,
  "Items": {
    "LogRecords": [
      {
        "Account": "0",
        "ElapsedTime": 248,
        "Command": "KEYS *",
        "DBName": "0",
        "ExecuteTime": "2019-03-12T09:18:41Z",
        "DataBaseName": "0",
        "NodeId": "r-bp1zxszhcgatnx****-db-0",
        "AccountName": "demo",
        "IPAddress": "172.16.88.***"
      }
    ]
  }
}

    错误码

    HTTP status code错误码错误信息描述
    400InvalidStartTime.MalformedThe Specified parameter StartTime is not valid.-
    400InvalidEndTime.MalformedThe Specified parameter EndTime is not valid.结束时间验证失败，时间格式应该为gmt时间例如2011-06-11T16:00Z
    400InvalidStartTimeAndEndTime.Malformed结束时间必须大于开始时间
    400InvalidPageSize.Malformed-
    403IncorrectEngineVersionCurrent engine version does not support operations.当前Redis版本不支持此操作。请查阅该操作的相关文档，了解该操作对于Redis版本的要求。
    403ServerBusyserver busy now, please retry later.-

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