Viewing Space Runtime Information

The Space Overview page has two tabs, one that shows all Spaces in the cluster, and one that shows only unhealthy Spaces. You can see your Spaces as cards that contain the following information:

• Name of the associated service
• Name of the Space
• Number of partitions
• Type of Space schema, indicated by an icon (for example, persistent or high availability)
• Current RAM utilization of the Space
• Maximum allocated RAM for the Space
• Number of object types in the Space
• Number of data entries to the Space

You can filter the view by cache ratio and RAM utilization, and you can sort by alert severity. You can also do a free text search by Space name.

Click a Space to drill through and see the following additional information for that Space in the Overview tab:

• Entries per object type
• Data distribution per partition (for the past 5 minutes)
• Reads by partition (for the past 5 minutes)

Data object types are listed in a table that contains the following information. You can do a free text search in the table.

Navigate to Object Type page

It is possible to drill down from the Space overview page to the Object Type level in two ways:

• Click on the Object Type line within the Object Types data table. In this scenario, the user drills down to the overview page of an Object Type.
• Click on the icon to the left of the Object Type name. It is possible to drill down to the Object Type SQL editor page with the Object Type context already selected within the sample query.

Viewing Data Types

Press Viewing Data Types for information about data type details in the Space.

Space

Command:

gs.{sh/bat} space list

Description:

This command lists all the Spaces in a table with their Space name, Processing Unit name, cluster topology, number of actual/planned Space instances, and Instance ID.

Input Example:

<GS_HOME>/bin/gs space list

<GS_HOME>/bin/gs.sh space list

Output Example:

Parameters and Options:

None.

Space Instance

Command:

gs.{sh/bat} space list-instances <name>

Description:

The Space instances for the given Space are listed with their Instance ID, Mode, Host ID, and Container ID.

Input Example:

<GS_HOME>/bin/gs space list-instances mySpace

<GS_HOME>/bin/gs.sh space list-instances mySpace

Output Example:

Parameters and Options:

All Spaces

Path

GET /spaces

Description:

The Spaces are listed with the Space name, Processing Unit name, cluster topology, number of Space instances, and Instance IDs.

Example Request:

curl -X GET --header 'Accept: application/json' 'http://localhost:8090/v2/spaces'

Example Response:

[
  {
    "name": "monitorSpace",
    "processingUnitName": "monitorSpace",
    "topology": {
      "instances": 1
    },
    "instancesIds": [
      "monitorSpace~1"
    ]
  },
  {
    "name": "alertSpace",
    "processingUnitName": "alertSpace",
    "topology": {
      "instances": 1
    },
    "instancesIds": [
      "alertSpace~1"
    ]
  },
  {
    "name": "mySpace",
    "processingUnitName": "mySpace",
    "topology": {
      "instances": 1
    },
    "instancesIds": [
      "mySpace~1"
    ]
  }
]

Options:

None

Specific Space

Path

GET /spaces/{id}/instances

Description:

The given Space is listed with the Space name, Processing Unit name, cluster topology, number of Space instances, and Instance ID.

Example Request:

curl -X GET --header 'Accept: application/json' 'http://localhost:8090/v2/spaces/alertSpace/instances'

Example Response:

[
  {
    "id": "alertSpace~1",
    "mode": "PRIMARY",
    "partitionId": 0,
    "backupId": 0,
    "hostId": "admin",
    "containerId": "admin~13972"
  }
] 

Options:

Specific Space Instance

Path

GET /spaces/{id}/instances{instanceId}

Description:

The given Space instance is listed with the Instance ID, Mode, Partition ID, Backup ID, Host ID, and Container ID.

Example Request:

curl -X GET --header 'Accept: application/json' 'http://localhost:8090/v2/spaces/alertSpace/instances/alertSpace~1'

Example Response:

{
  "id": "alertSpace~1",
  "mode": "PRIMARY",
  "partitionId": 0,
  "backupId": 0,
  "hostId": "admin",
  "containerId": "admin~13972"
}

Options:

You can see the following high-level Space details in the main Spaces view:

Click the arrow in the right-hand column of the Space entry to drill through to the following additional details:

Refer to the Admin API topics in the Developer Guide.