GridGain Developers Hub

GridGain Nebula REST API

GridGain Nebula provides a REST API for certain functionality. You can see the specification here or download it directly as a .yaml file.

Get Cluster Health Reports

Authenticate with your Nebula credentials (email and password) and specify the connectionId in the request.

GET /rest/v1/clusters/{connectionId}/health
Connection id GridGain 9 and GridGain 8

The endpoint returns the cluster health report in JSON format.

Example request:

curl -v \
  -u "username@example.com:password" \
  "https://portal.gridgain.com/rest/v1/clusters/{connectionId}/health" \
  -H "Accept: application/json"

Example response:

{
  "status": "GOOD",
  "reports": [
    {
      "reportName": "OfflineCmgNodes",
      "description": null,
      "status": "GOOD"
    },
    {
      "reportName": "OfflineMgNodes",
      "description": null,
      "status": "GOOD"
    },
    {
      "reportName": "Alerts",
      "description": null,
      "status": "GOOD"
    },
    {
      "reportName": "PartitionLoss",
      "description": null,
      "status": "GOOD"
    }
  ]
}

You can also view a specific report by passing reportName property to the endpoint:

/rest/v1/clusters/{connectionId}/health/{reportName}

Example response:

{
   "reportName": "PartitionLoss",
   "description": null,
   "status": "GOOD"
}