Thread queues (System monitoring)

The endpoint /dw/monitor/v1/monitorplain4 returns the current number of jobs per priority level. Use it to monitor the utilization of the Lobster Integration Server's thread queues.

External monitoring tools can query this endpoint. Examples include Nagios and PRTG. These tools trigger alerts as soon as the queue values exceed a threshold.

Authentication

This endpoint uses the same authentication as the other system monitoring endpoints. For setup details, see System monitoring (general) (REST API).

Anfrage

Method: GET

URL:

http(s)://<IP/URL Integration Server or DMZ>:<Port>/dw/monitor/v1/monitorplain4?<Parameter>

Query parameter

At least one parameter is required. Both parameters listed below return the number of jobs per thread queue. The only difference between them is the additional data included in the response.

Parameter	Beschreibung
`dw=true`	Returns the standard monitoring data for the Integration Server, along with the number of jobs per thread queue.
`all=true`	Returns the same data as `dw=true`. In addition, the response includes all other sections of this endpoint. Examples include disk usage and reorganization runs.

Response

The response is returned as plain text with the MIME type text/plain. The thread queue section contains one line per priority level. The following example shows only the queue lines. The complete response includes additional monitoring fields. The output may vary depending on the version being used.

_data lowest prio queued jobs = 0
_data lower prio queued jobs = 0
_data normal prio queued jobs = 0
_data higher prio queued jobs = 0
_data highest prio queued jobs = 0

Response fields

The response contains prio as an abbreviation for priority. The prefix _data refers to the component Lobster Data Platform/Integration.

Field	Description
`_data lowest prio queued jobs`	Jobs in the queue with the lowest priority.
`_data lower prio queued jobs`	Jobs in the queue with low priority.
`_data normal prio queued jobs`	Jobs in the queue with normal priority.
`_data higher prio queued jobs`	Jobs in the queue with higher priority.
`_data highest prio queued jobs`	Jobs in the queue with the highest priority.

A consistently high value indicates that the queue is overloaded. Check to see if the values return to zero between queries.