Spectra Logic

1-800-833-1132 : 1-303-449-6400

Verify System Health

Description

Verifies that the system appears to be online and functioning normally and that there is adequate free space for the database file system.

Requests

Syntax

GET http[s]://{datapathDNSname}/_rest_/system_health/

Responses

Response Elements

<Data>
   <DatabaseFilesystemFreeSpace>
      NORMAL|NEAR_LOW|LOW|CRITICAL
   </DatabaseFilesystemFreeSpace>
   <MsRequiredToVerifyDataPlannerHealth>
      {32‑bit integer}
   </MsRequiredToVerifyDataPlannerHealth>
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	The container for the response.
DatabaseFilesystem FreeSpace	The status of the file system free space. Values: § NORMAL — The BlackPearl system has enough free space for the file system to operate. § NEAR_LOW — Between 10% and 20% of the database file system is free. Purchase additional SSDs or delete objects to increase free space. § LOW — Between 5% and 10% of the database file system is free. Some operations are unavailable until additional SSDs are added. § CRITICAL — Less than 5% of the database file system is free. No operations are available until additional SSDs are added. Note: If you cannot add additional SSDs, contact Spectra Logic Technical Support (see Contacting Spectra Logic)
MsRequiredTo VerifyDataPlanner Health	The amount of time, in milliseconds, that it took the BlackPearl system to respond. If critical components in the data path between the client and the BlackPearl system are unresponsive, an error is generated.

Example

Sample Request

This request checks the system health of the BlackPearl system.

GET http://blackpearl-hostname/_rest_/system_health/ HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<Data>
   <DatabaseFilesystemFreeSpace>
      NORMAL
   </DatabaseFilesystemFreeSpace>
   <MsRequiredToVerifyDataPlannerHealth>
      0
   </MsRequiredToVerifyDataPlannerHealth>
</Data>