查询数据库错误日志信息 - QueryingDatabaseErrorLogs

功能介绍

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

接口约束

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

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

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

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
gaussdbfornosql:instance:listErrorLog
List
instance *
g:ResourceTag/<tag-key>
g:EnterpriseProjectId
nosql:instance:list
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
gaussdbfornosql:instance:listErrorLog	List	instance *	g:ResourceTag/<tag-key> g:EnterpriseProjectId	nosql:instance:list	-

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	租户在某一Region下的Project ID。获取方法请参见获取项目ID。
instance_id	是	String	实例ID，可以调用查询实例列表和详情 - QueryingInstancesandDetails接口获取。如果未申请实例，可以调用创建实例 - CreatinganInstance接口创建。

表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 
}