Queries the logs of an Elasticsearch cluster.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request headers

This operation uses only the common request header. For more information, see Common request parameters.

Request syntax


     GET /openapi/instances/[InstanceId]/search-log HTTP/1.1

Request parameters

Parameter Type Position Required Example Description
InstanceId String Path Yes es-cn-n6w1o1x0w001c****

The ID of the instance.

query String Query Yes host:172.16.**.** AND content:netty

The keyword used to match log entries.

type String Query Yes INSTANCELOG

The type of the logs. Valid values:

  • INSTANCELOG: master log
  • SEARCHSLOW:search slow logs
  • INDEXINGSLOW:indexing slow logs
  • JMVLOG:GC logs
  • ES_SEARCH_ACCESS_LOG:ES access logs
beginTime Long Query No 1531910852074

The beginning of the time range to query. Unit: milliseconds.

endTime Long Query No 1531910852074

The end of the time range to query. Unit: milliseconds.

page Integer Query No 1

The page number of the plug-in list. Pages start from page 1. Default value: 1.

size Integer Query No 20

The number of entries to return on each page. Default value: 20, minimum value: 1, maximum value: 50.

Response parameters

Parameter Type Example Description
Headers Struct

The header of the response.

X-Total-Count Integer 1000

The number of entries returned per page.

RequestId String 7F40EAA1-6F1D-4DD9-8DB8-C5F00C4E****

The ID of the request.

Result Array of Result

The list of logs returned by the request.

content String [GC (Allocation Failure) 2018-07-19T17:24:20.682+0800: 7516.513: [ParNew: 6604768K->81121K(7341504K), 0.0760606 secs] 7226662K->703015K(31813056K), 0.0762507 secs] [Times: user=0.52 sys=0.00, real=0.07 secs]

The content of the log entry. Migrated to contentCollection fields.

contentCollection Map {"level": "info", "host": "192.168.**.**", "time": "2019-03-18T08:16:12.741Z","content": "[o.e.c.r.a.AllocationService] [MnNASM_] Cluster health status changed from [YELLOW] to [GREEN] (reason: [shards started [[my_index][3]] ...])."}

The message of the log entry. Different log types return different content fields.

host String 192.168.**.**

The IP address of the node that generates the log entry.

instanceId String es-cn-n6w1o1x0w001c****

The ID of the Elasticsearch instance.

level String info

The level of the log entry. Valid values:

  • warn: warning logs
  • info: information logs
  • error: error log
  • trace: trace logs
  • debug: debug logs

Level information has been migrated to the contentCollection field.

timestamp Long 1531985112420

the timestamp of log generation, in ms.

The Result.contentCollection contains the following parameters.

Parameter

Type

Example

Description

time

String

2020-07-21T11:12:53.057Z

The time when the log entry was generated.

content

String

[o.e.c.r.a.AllocationService] [MnNASM_] Cluster health status changed from [YELLOW] to [GREEN] (reason: [shards started [[my_index][3]] ...]).

The content of the log entry.

host

String

192.168..

The IP of the node where the log is generated.

level

String

warn

The level of the log entry. value includes: warn (warning log), info (information log, error, error log), trace the trace log, the debug debug log)

Examples

Sample requests


     GET /openapi/instances/es-cn-n6w1o1x0w001c****/search-log?type=INSTANCELOG&query=host:172.16.\*\*.\*\* AND content:netty&beginTime=1531910852074&endTime=1531910852074&page=1&size=20 HTTP/1.1 public request header

Sample success responses

JSON format 


     { "Result": [ { "timestamp": 1552868172741, "host": "192.168.**.**", "contentCollection": { "level": "info", "host": "192.168.**.**", "time": "2019-03-18T08:16:12.741Z", "content": "[o.e.c.r.a.AllocationService] [MnNASM_] Cluster health status changed from [YELLOW] to [GREEN] (reason: [shards started [[my_index][3]] ...])." }, "instanceId": "es-cn-n6w1o1x0w001c****" }, { "timestamp": 1552838205462, "host": "192.168.**.**", "contentCollection": { "level": "info", "host": "192.168.**.**", "time": "2019-03-17T23:56:45.462Z", "content": "[o.e.c.r.a.AllocationService] [v4p9o7A] Cluster health status changed from [GREEN] to [YELLOW] (reason: [{MnNASM_}{MnNASM_OSR-2YgySSc****}{EvJHPrAOS_u8J3-6qZ****}{192.168.**.**}{192.168.**.**:9300}{ml.max_open_jobs=10, ml.enabled=true} transport disconnected])." }, "instanceId": "es-cn-n6w1o1x0w001c****" } ], "RequestId": "121753D9-744A-4203-9EC4-F29E628A****", "Headers": { "X-Total-Count": 2 } }

Error codes

HttpCode Error code Error message Description
400 InstanceNotFound The instanceId provided does not exist. The instance cannot be found. Please check the instance status.

For a list of error codes, visit the API Error Center.