Basic REST API monitoring

The Access Gateway Monitoring REST API endpoint can be used to determine the current health of an Access Gateway cluster or stand alone instance.

Request

You make a GET request to a node's /basic_status endpoint to retrieve basic monitoring information.

Include the following in your request:

• Host: Always monitoring.rest.service.oag.

The following curl example requests the node's status using the default endpoint:

curl -k -X GET -H "Host:monitoring.rest.service.oag" https://gw.{gateway.tld}/basic_status

On success

On success, the following results are returned:

Active connections: {total active and waiting connections} server accepts handled requests {server accepts} {handled accepts} {total requests} Reading: {reads} Writing: {writes} Waiting: {waits}

Defined as:

Field	Value
Active connections	The current number of active client connections including Waiting connections.
server accepts	The total number of accepted client connections.
handled	The total number of handled connections. Generally, this parameter value is the same number of connections that the server handles, unless some resource limits have been reached.
requests	The total number of client requests
Reading	The current number of connections where Access Gateway is reading the request header.
Writing	The current number of connections where nginx is writing the response back to the client.
Waiting	The current number of idle client connections waiting for a request.

For example:

Active connections: 291 server accepts handled requests 16630948 16630948 31070465 Reading: 6 Writing: 179 Waiting: 106

Other return results

Related topics