文档首页/ 云数据库 GeminiDB/ API参考/ API v3(推荐)/ 日志管理/ 查询GeminiDB Redis数据库慢日志
更新时间:2024-10-28 GMT+08:00
分享

查询GeminiDB Redis数据库慢日志

功能介绍

查询GeminiDB Redis数据库慢日志信息,支持日志关键字搜索。

接口约束

  • 不支持使用 &&、||、AND、OR、NOT、*、?、:、>、<、=、>=、<= 这些关键字来搜索日志。
  • 查询到的慢日志数据在入参start_time和end_time的时间段内。
  • 当次查询的日志起始行号line_num须从上一次查询的日志返回信息中获取,第一次查询可不传。
  • 每页查询最大限制100条,慢日志最多保存30天。

URI

POST https://{Endpoint}/v3/{project_id}/redis/instances/{instance_id}/slow-logs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户在某一region下的project ID。获取方法请参见获取项目ID

instance_id

String

实例ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

表3 请求Body参数

参数

是否必选

参数类型

描述

start_time

String

开始时间,格式为“yyyy-mm-ddThh:mm:ssZ”。

其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。

注:开始时间不得早于当前时间30天。

end_time

String

结束时间,格式为“yyyy-mm-ddThh:mm:ssZ”。

其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。

注:结束时间不能晚于当前时间。

limit

Integer

表示每次查询的日志条数,最大限制100条。

line_num

String

日志单行序列号,第一次查询时不需要此参数,下一次查询时需要使用,可从上一次查询的返回信息中获取。说明:当次查询从line_num的下一条日志开始查询,不包含当前line_num日志。

operate_type

String

语句类型,取空值,表示查询所有语句类型。支持查询的所有语句类型如下(以“、”分隔):set、get、del、incr、incrby、incrbyfloat、decr、decrby、getset、append、mget、keys、setnx、setex、psetex、delvx、mset、 msetnx、getrange、substr、setrange、strlen、exists、expire、pexpire、expireat、pexpireat、ttl、pttl、persist、type、 scanx、pksetexat、sort、hdel、hset、hget、hgetall、hexists、hincrby、hincrbyfloat、hkeys、hlen、hmget、hmset、hsetnx、 hstrlen、hvals、hscan、hscanx、pkhscanrange、pkhrscanrange、lindex、linsert、llen、lpop、lpush、lpushx、lrange、lrem、 lset、ltrim、rpop、rpoplpush、rpush、rpushx、zadd、zcard、zscan、zincrby、zrange、zrevrange、zrangebyscore、 zrevrangebyscore、zcount、zrem、zunionstore、zinterstore、zrank、zrevrank、zscore、zrangebylex、zrevrangebylex、 zlexcount、zremrangebyrank、zremrangebyscore、zremrangebylex、zpopmax、zpopmin、sadd、spop、scard、smembers、sscan、 srem、sunion、sunionstore、sinter、sinterstore、sismember、sdiff、sdiffstore、smove、srandmember、bitset、bitget、 bitcount、bitpos、bitop、bitfield、pfadd、pfcount、pfmerge、geoadd、georadiusbymember、georadius、geohash、geodist、 geopos、xadd、xack、xgroup、xdel、xtrim、xlen、xrange、xrevrange、xclaim、xpending、xinfo、xread、xreadgroup。

node_id

String

节点ID,取空值,表示查询实例下所有允许查询的节点。具体取值请参考表10中的“id”。

keywords

Array of strings

根据多个关键字搜索日志全文,表示同时匹配所有关键字。

  • 最多支持10个关键字。
  • 每个关键字最大长度不超过512个字符。

max_cost_time

Double

支持根据最大执行时间范围查找日志。单位:ms。

min_cost_time

Double

支持根据最小执行时间范围查找日志。单位:ms。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

slow_logs

Array of objects

慢日志具体信息。详情请参考表5

表5 RedisSlowLogDetail

参数

参数类型

描述

node_name

String

节点名称。

node_id

String

节点ID。

whole_message

String

执行语句。

operate_type

String

语句类型。

cost_time

Double

执行时间。单位:ms。

log_time

String

日志产生时间,UTC时间。格式为“yyyy-mm-ddThh:mm:ssZ”。其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。

line_num

String

日志单行序列号。

请求示例

POST
https://{Endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/redis/instances/a6d3c8a9857b4c81b3c1fe4802dfa4d0in12/slow-logs
 
{ 
   "start_time" : "2022-09-06T10:41:14+0800", 
   "end_time" : "2022-09-16T10:41:14+0800", 
   "limit" : 100, 
   "line_num" : "1595659490239433658", 
   "operate_type" : "set", 
   "node_id" : "2997329fe3cb4b3faedcade16df6966eno12", 
   "keywords" : [ "log", "test" ], 
   "max_cost_time" : 100.12, 
   "min_cost_time" : 50.12 
 }

响应示例

状态码: 200

Success

{
	"slow_logs": [{
		"node_name": "test_worker_node_1",
		"node_id": "dbd0b65ed0c34125a0b04d4e5ba67e66no02",
		"whole_message": "testDb",
		"operate_type": "SET",
		"cost_time": 60.12,
		"log_time": "2022-09-15T22:49:38.643000Z",
		"line_num": "1595659490239433659"
	}]
}

状态码

请参见状态码

错误码

请参见错误码

相关文档