文档首页/ 云数据库 GeminiDB/ API参考/ API v3（推荐）/ 日志管理/ 查询数据库错误日志信息
更新时间：2025-09-09 GMT+08:00
查看PDF
分享

查询数据库错误日志信息

功能介绍

查询数据库错误日志，暂不支持关键字搜索。

接口约束

该接口支持GeminiDB Mongo数据库实例。

目前仅支持查询最近的2000条错误日志信息。

目前仅支持查询最近一个月内的错误日志信息。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v3/{project_id}/instances/{instance_id}/error-log

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

instance_id

是

String

实例ID，可以调用查询实例列表和详情接口获取。如果未申请实例，可以调用创建实例接口创建。
表2 Query参数

参数

是否必选

参数类型

描述

start_time

是

String

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

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

开始时间最多不能比当前时间早30天。

end_time

是

String

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

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

只能查询当前时间前一个月内的错误日志。

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

node_id

否

String

节点ID，取空值，表示查询实例下所有允许查询的节点。

type

否

String

语句类型，取空值，表示查询所有语句类型。也可指定如下日志类型：

  • Warning
  • Error

offset

否

Integer

索引位置，偏移量。

  • 取值范围为 [0, 1999]。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询）。
  • 必须为数字，不能为负数。

limit

否

Integer

查询记录数。

  • 取值范围[1, 100]，默认10 （表示默认返回10条数据）。
  • limit与offset的和需要满足小于等于2000的条件。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

响应参数

状态码： 202

表4 响应Body参数

参数

参数类型

描述

total_count

Integer

总记录数。

error_log_list

Array of 表5 objects

错误日志信息。
表5 ErrorLogList

参数

参数类型

描述

node_name

String

节点名称。

level

String

日志级别。

time

String

发生时间，UTC时间。

content

String

日志内容。

请求示例

  • URI样例 
    GET https://gaussdb-nosql.cn-north-7.myhuaweicloud.com/v3/375d8d8fad1f43039e23d3b6c0f60a19/instances/9136fd2a9fcd405ea4674276ce36dae8in10/error-log
  • 请求体样例

    无。

响应示例

状态码： 202

Success

{ 
  "error_log_list" : [ { 
    "node_name" : "Test_replica_node_2", 
    "level" : "WARNING", 
    "time" : "2020-12-15T08:53:01.868+0000", 
    "content" : "W NETWORK  [LogicalSessionCacheReap] Unable to reach primary for set replica" 
  } ], 
  "total_count" : 1 
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 日志管理

相关文档