Monitor INUBIT application

To use this endpoint an INUBIT monitoring license entry is required.

The metrics endpoint is designed to provide data about the internal server state such as:

Memory usage
Number processes currently running
Status of server’s maintenance mode

These data can be used to continuously monitor an INUBIT application, e.g. with prometheus.

Request

URL: /metrics

Method: GET

Authorization: required

GET /ibis/rest/metrics HTTP/1.1
Accept: application/json
Host: localhost:8080

Request Parameters

Name Description Required Allowed values

Name	Description	Required	Allowed values
`format`	Response output format	no (default: `json` )	`json` (default) - Response will be JSON formatted `xml` - Response will be XML formatted `prometheus` - Response will be formatted for prometheus

format

Response output format

no (default: json )

json (default) - Response will be JSON formatted
xml - Response will be XML formatted
prometheus - Response will be formatted for prometheus

Response

HTTP/1.1 200 OK
Content-Tye: application/json

{
  "serverName": "192.168.178.23",
  "serverId": "192.168.178.23",
  "maintenanceMode": 0,
  "blockingQueueEntries": 0,
  "maxBlockingQueueSize": 200000,
  "usedMemoryInMByte": 305.0,
  "freeMemoryInMByte": 462.0,
  "maxMemoryInMByte": 2048.0,
  "licensedThreads": 1500,
  "threadsInUse": 0,
  "maxThreadSize": 10,
  "privilegedThreadsInUse": 0,
  "maxPrivilegedThreads": 0,
  "users": {
    "root": {
      "WAITING": 0,
      "ERROR": 0,
      "OK": 2
    }
  },
  "groups": {}
}

Errors

Authorization Failed (401): Authorization with the given username and password failed. Please revisit both values and provide valid credentials.

{
    "statusCode": 401,
    "message": "Unauthorized access",
    "path": "/rest/<endpoint>",
    "timestamp": "2025-06-07T14:21:11.781"
}

Resource Not Found (404): The 404 (Not Found) status code indicates that the requested endpoint or resource is unavailable or does not exist on the server.
Invalid value (404): if format parameter value is invalid
Server Error (500): Execution on the INUBIT server failed. Have a look into the response message, otherwise access to the INUBIT log is required to retrieve further information.

{
  "statusCode": 500,
  "message": "Internal Server Error",
  "path": "/rest/<endpoint>",
  "timestamp": "2025-08-06T12:55:31.862"
}

Service Unavailable (503): In maintenance mode the INUBIT server endpoint will not respond to incoming requests but return this error response. Once the maintenance mode is switched off the endpoint will respond normally.

{
  "statusCode": 503,
  "message": "Service Unavailable",
  "path": "/rest/<endpoint>",
  "timestamp": "2025-08-06T12:58:06.688"
}