Note

This documentation is for a prior release of Kinetica. For the latest documentation, click here.

/admin/show/alerts

URL: https://<aws.fqdn>/<aws.cluster.name>/gpudb-host-manager/admin/show/alerts

Requests a list of the most recent alerts. Returns lists of alert data, including timestamp and type.

NOTE: This endpoint is serviced by the host manager, not the database cluster itself, so the port specified needs to be the host manager port instead. The default host manager port can be found under Default Ports. For more information on the host manager, see Host Manager.

Input Parameter Description

NameTypeDescription
num_alertsintNumber of most recent alerts to request. The response will include up to input parameter num_alerts depending on how many alerts there are in the system. A value of 0 returns all stored alerts.
optionsmap of string to stringsOptional parameters. The default value is an empty map ( {} ).

Output Parameter Description

The GPUdb server embeds the endpoint response inside a standard response structure which contains status information and the actual response to the query. Here is a description of the various fields of the wrapper:

NameTypeDescription
statusString'OK' or 'ERROR'
messageStringEmpty if success or an error message
data_typeString'admin_show_alerts_response' or 'none' in case of an error
dataStringEmpty string
data_strJSON or String

This embedded JSON represents the result of the /admin/show/alerts endpoint:

NameTypeDescription
timestampsarray of stringsTimestamp for when the alert occurred, sorted from most recent to least recent. Each array entry corresponds with the entries at the same index in output parameter types and output parameter params.
typesarray of stringsType of system alert, sorted from most recent to least recent. Each array entry corresponds with the entries at the same index in output parameter timestamps and output parameter params.
paramsarray of maps of string to stringsParameters for each alert, sorted from most recent to least recent. Each array entry corresponds with the entries at the same index in output parameter timestamps and output parameter types.
infomap of string to stringsAdditional information.

Empty string in case of an error.