Thread-Queues (System Monitoring)

Der Endpoint /dw/monitor/v1/monitorplain4 liefert die aktuelle Anzahl der Jobs pro Prioritätsstufe. Verwenden Sie ihn, um die Auslastung der Thread-Queues des Lobster Integration Servers zu überwachen.

Externe Monitoring-Tools können diesen Endpoint abfragen. Beispiele sind Nagios und PRTG. Diese Tools lösen Alarme aus, sobald die Queue-Werte einen Schwellenwert überschreiten.

Authentifizierung

Dieser Endpoint nutzt dieselbe Authentifizierung wie die anderen System-Monitoring-Endpoints. Details zur Einrichtung finden Sie unter System Monitoring (allgemein) (REST API).

Anfrage

Methode: GET

URL:

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

Query-Parameter

Mindestens ein Parameter ist erforderlich. Beide unten aufgeführten Parameter liefern die Anzahl der Jobs pro Thread Queue. Sie unterscheiden sich nur darin, welche weiteren Daten in der Antwort enthalten sind.

Parameter	Beschreibung
`dw=true`	Liefert die Standard-Monitoring-Daten des Integration Servers zusammen mit der Anzahl der Jobs pro Thread-Queue.
`all=true`	Liefert dieselben Daten wie `dw=true`. Zusätzlich enthält die Antwort alle weiteren Sektionen dieses Endpoints. Beispiele sind Festplattenauslastung und Reorganisationslauf.

Antwort

Die Antwort wird als Plaintext mit dem MIME-Typ text/plain ausgegeben. Die Thread-Queue-Sektion enthält eine Zeile pro Prioritätsstufe. Das folgende Beispiel zeigt nur die Queue-Zeilen. Die vollständige Antwort enthält zusätzliche Monitoring-Felder. Je nach Version, die genutzt wird, kann die Ausgabe variieren.

_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

Antwortfelder

In der Antwort steht prio als Kürzel für priority. Das Präfix _data bezieht sich auf die Komponente Lobster Data Platform / Integration.

Feld	Beschreibung
`_data lowest prio queued jobs`	Jobs in der Queue mit niedrigster Priorität.
`_data lower prio queued jobs`	Jobs in der Queue mit niedriger Priorität.
`_data normal prio queued jobs`	Jobs in der Queue mit normaler Priorität.
`_data higher prio queued jobs`	Jobs in der Queue mit höherer Priorität.
`_data highest prio queued jobs`	Jobs in der Queue mit höchster Priorität.

Ein konstant hoher Wert weist darauf hin, dass die Queue überlastet ist. Überprüfen Sie, ob die Werte zwischen den Abfragen nicht auf null zurückgehen.