Die INUBIT Version 7.4 wird nicht mehr gewartet.

Sollten Sie diese INUBIT Version nutzen, empfehlen wir Ihnen eine Migration auf eine aktuelle Version. Die Dokumentation zur neusten INUBIT Version finden Sie hier. Sollten Sie Fragen haben, wenden Sie sich bitte an unseren Support.

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

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.

<html>

    <head>
        <title>Status page</title>
    </head>

    <body style="font-family: sans-serif;">
        <p style="font-size: 1.2em;font-weight: bold;margin: 1em 0px;">Unauthorized</p>
        <p>The request requires user authentication</p>
        <p>You can get technical details <a
                href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2">here</a>.<br>
            Please continue your visit at our <a href="/">home page</a>.
        </p>
    </body>
</html>
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.