All Products
Search
Document Center

Elasticsearch:ListDiagnoseReport

Last Updated:May 07, 2024

Queries the historical intelligent O&M reports 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 header

This operation does not have operation-specific request headers and uses only common request headers. For more information, see the "Common request parameters" section of the Common parameters topic.

Request syntax

GET /openapi/diagnosis/instances/{InstanceId}/reports HTTP/1.1

Request parameters

Parameter

Type

Position

Required

Example

Description

InstanceId String Path Yes es-cn-n6w1qu7ei000p****

The instance ID.

lang String Query No es

The language of the reports. The default is the browser language, which supports:

  • en: English
  • zh: simplified Chinese
  • zt: traditional Chinese
  • es: Spanish
  • fr: French
startTime Long Query Yes 1594569600000

The beginning of the time range to query. The value must be a UNIX timestamp. Unit: milliseconds.

  • Minimum value: 1000000000000
  • Maximum value: 2000000000000
endTime Long Query Yes 1595174399999

The end of the time range to query. The value must be a UNIX timestamp. Unit: milliseconds.

  • Minimum value: 1000000000000
  • Maximum value: 2000000000000
page Integer Query No 1

The number of the page to return. Valid values: 1 to 200. Default value: 1.

size Integer Query No 20

The number of reports per page. Valid values: 1 to 500. Default value: 10.

detail Boolean Query No true

Whether to show the details of diagnostic items.

trigger String Query No SYSTEM

The trigger mode of the health diagnosis. You can use the following methods:

  • SYSTEM (default): automatically triggered by the system
  • INNER: internal trigger
  • USER: manually triggered by the user

Response parameters

Parameter

Type

Example

Description

RequestId String 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****

The request ID.

Headers Object

The header of the response.

X-Total-Count Integer 15

The total number of entries returned.

Result Array of Result

The data returned.

trigger String USER

The trigger mode of the health diagnosis. Valid values:

  • SYSTEM: automatically triggered by the system
  • INNER: internal trigger
  • USER: manually triggered by the user
createTime Long 1535745731000

The timestamp when the report was created.

reportId String trigger__2020-08-17T17:09:02f

The ID of the report.

state String SUCCESS

The diagnosis status. Valid values: Supported: SUCCESS, FAILED, and RUNNING.

instanceId String es-cn-abc

The ID of the diagnostic instance.

health String YELLOW

The overall health of the cluster in the report. Supported: GREEN, YELLOW, RED, and UNKNOWN.

diagnoseItems Array of diagnoseItems

Reports the list of diagnostic item information.

item String IndexAliasUseDiagnostic

The name of the diagnostic item.

health String YELLOW

The health level of the diagnostic item. Supported: GREEN, YELLOW, RED, and UNKNOWN.

detail Object

The details of the diagnostic item.

type String ES_API

The type of the diagnostic result. Valid values:

  • TEXT: text description
  • CONSOLE_API: console-triggered
  • ES_API:API-triggered
name String Number of Replica Shards

The full name of the diagnostic item.

desc String Check whether the number of replica shards is optimal and easy to maintain

The description of the diagnostic item.

result String You may need to adjust the numbers of replica shards of some indices as follows: [geoname08 : 0 -> 1][geoname09 : 0 -> 1][geonametest01 : 0 -> 1]

The diagnosis.

suggest String You can call the following function in the Elasticsearch API....

The suggestion for the diagnosis.

Examples

Sample requests

GET /openapi/diagnosis/instances/es-cn-n6w1qu7ei000p****/reports?lang=es&startTime=1594569600000&endTime=1595174399999&page=1&size=20&detail=true&trigger=SYSTEM HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json

Sample success responses

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Result" : [ {
    "reportId" : "scheduled__2020-09-15T02:40:00",
    "instanceId" : "es-cn-09k1rocex0006****",
    "state" : "SUCCESS",
    "trigger" : "SYSTEM",
    "health" : "YELLOW",
    "createTime" : 1600108800000,
    "diagnoseItems" : [ {
      "item" : "IndexReplicaDiagnostic",
      "health" : "YELLOW",
      "detail" : {
        "name" : "Number of Replica Shards",
        "desc" : "Check whether the number of replica shards is optimal and easy to maintain.\nReplica shards can increase the index data reliability and improve the QPS if the resources are sufficient. However, too many replica shards may consume large amounts of disk space and memory. This reduces the performance of write operations.",
        "type" : "CONSOLE_API",
        "suggest" : "You can call the following function in the Elasticsearch API: \nPUT ${index}/_settings\n{\n    \"settings\": {\n        \"index.number_of_replicas\": \"${num}\"\n    }\n} \r\nSet the index and num parameters to the actual values.",
        "result" : "You may need to adjust the numbers of replica shards of some indices as follows: \n[geoname08 : 0 -> 1][geoname09 : 0 -> 1][geonametest01 : 0 -> 1]"
      }
    }, {
      "item" : "IndexShardsDiagnostic",
      "health" : "YELLOW",
      "detail" : {
        "name" : "Number and Sizes of Shards in Each Index",
        "desc" : "Check whether the number and sizes of shards in each index are optimal.\nA small number of shards may degrade the read and write performance of an index. A large number of shards consume a lot of system resources and degrade the read and write performance of an index.",
        "type" : "ES_API",
        "suggest" : "We recommend the following solution: \nhotmovies [size < 1 GB] [7 -> 1, 3]\ngeoname08 [2 GB] [5 -> 1, 3]\ngeoname09 [3 GB] [5 -> 1, 3]\ngeonametest01 [2 GB] [5 -> 1, 3]\n \r\nThis solution applies to the current index sizes. Adjust the number of shards based on the future indices and nodes.",
        "result" : "You may need to adjust the number of shards in some indices."
      }
    }, {
      "item" : "NodeLeftDiagnostic",
      "health" : "GREEN",
      "detail" : {
        "name" : "Missing Nodes",
        "desc" : "Check whether any node has not joined the cluster.\nMissing nodes may cause serious problems and requires immediate attention.",
        "type" : "TEXT",
        "result" : "All nodes have joined the cluster."
      }
    }, {
      "item" : "FullGcLogDiagnostic",
      "health" : "GREEN",
      "detail" : {
        "name" : "Full GC Activities",
        "desc" : "Check whether the full GC activities of the cluster are normal.",
        "type" : "TEXT",
        "result" : "The full GC activities of the cluster are normal."
      }
    }, {
      "item" : "ClusterMinMasterDiagnostic",
      "health" : "GREEN",
      "detail" : {
        "name" : "minimum_master_nodes Configuration",
        "desc" : "Check whether the discovery.zen.minimum_master_nodes configuration of the cluster is optimal.\nAn improper zen.min.master configuration may cause cluster instability and even cluster split-brain in the case of a high cluster load. Cluster split-brain may cause problems such as missing nodes, cluster jitter, and data exception, which require immediate attention.",
        "type" : "TEXT",
        "result" : "The  minMaster configuration is optimal. candidateMasterCount is set to 3, and discovery.zen.minimum_master_nodes is set to 2."
      }
    }, {
      "item" : "ClusterStateVersionDiagnostic",
      "health" : "GREEN",
      "detail" : {
        "name" : "Frequent Changes in Cluster Status",
        "desc" : "Check whether the cluster status changes frequently.\nFrequent changes in the cluster status can greatly increase the load of the master node, causing frequent GC activities, and may even degrade the cluster performance by blocking the reading and writing of index data.",
        "type" : "TEXT",
        "result" : "The cluster status changes at an optimal frequency."
      }
    }, {
      "item" : "ErrorLogDiagnostic",
      "health" : "GREEN",
      "detail" : {
        "name" : "Exceptions Log",
        "desc" : "Check for exceptions logs.",
        "type" : "TEXT",
        "result" : "No exceptions log has been detected."
      }
    } ]
  } ],
  "RequestId" : "40962041-2864-4877-81C7-9657FDA3****",
  "Headers" : {
    "X-Total-Count" : 1
  }
}

Error codes

For a list of error codes, see Service error codes.