System Monitoring (allgemein) (REST API)

images/download/thumbnails/62856659/arrow_up-version-1-modificationdate-1616640762036-api-v2.png Allgemein: System-Interaktion per HTTP (REST API).

Standard-Abfragen


Eventuell besteht die Absicht, Lobster_data und die Kommunikationsdienste des Lobster Integration Servers durch ein externes Tool (z. B. Nagios) zu überwachen.

Zu diesem Zweck steht die folgende URL zur Verfügung.


http(s)://<IP/URL Integration Server>:<Port>/dw/monitor/v1


Jeder HTTP-Zugriff liefert eine Response als Plaintext (MIME Type text/plain), in der tabellarisch die überwachten Eigenschaften gelistet werden. Durch zusätzliche Query-Parameter kann der Umfang der Ausgabe gesteuert werden.


Parameter

Beschreibung

ftp=true

Status des FTP-Dienstes anzeigen.

smtp=true

Status des SMTP-Dienstes anzeigen.

oftp=true

Status des OFTP-Dienstes anzeigen.

message=true

Status des Message-Dienstes anzeigen.

as2=true

Status des AS2-Dienstes anzeigen.

ssh=true

Status des SSH-Dienstes anzeigen.

dw=true

Status von Lobster_data anzeigen.

max=true

Wirkt nur zusammen mit all und dw. Dann wird die aktuell längste Profillaufzeit angezeigt. Hinweis: Der Parameter max=true (in Verbindung mit dw=true) verbraucht mehr Ressourcen und sollte daher nicht öfter als etwa alle 10 Sekunden aufgerufen werden.

all=true

Gleichbedeutend mit ftp=true&smtp=true&oftp=true&message=true&dw=true

Beispiel-Aufruf


http(s)://<IP/URL Integration Server>:<Port>/dw/monitor/v1?dw=true&as2=true

Ergebnis


Server's local time = Wed Sep 21 11:59:52 CEST 2022
HTTP status = Alive
AS2 status = Alive
startupservice status = Alive
startup applications = 3: [HubStartupConfiguration, DataWizardSetup, WebMonitor]
_data status = Alive
_data processed requests = 112449
_data queued jobs = 0
_data queued responses = 0
_data total errors = 63
_data running profiles = 0
Total memory = 12582912 KB
Free memory = 11551032 KB
Max memory = 12582912 KB
Used memory = 8% used
Number of Threads = 281
available Processors = 8
operating system = amd64
system load = 0.0
Lobster IS Version = IS/5.9.13_50428
Lobster_data Version = 4.5.0_50411
Emergency Mode active = false
Remaining Emergency Ticks = 1344

Weitere Abfragen


Zusätzlich zu den Abfragen oben, gibt es einen weiteren Unterpfad für weitergehende System-Informationen.

Lobster_data-Queues


Der folgende Aufruf zeigt auch die Anzahl der Jobs in den einzelnen Queues von Lobster_data.


http(s)://<IP/URL Integration Server>:<Port>/dw/monitor/v1/monitorplain4?dw=true

oder

http(s)://<IP/URL Integration Server>:<Port>/dw/monitor/v1/monitorplain4?all=true
_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

Reorganisationslauf


Der folgende Aufruf zeigt zusätzlich Informationen zum letzten Reorganisationslauf. Sehen Sie sich hierzu auch den Abschnitt System-Überwachung durch Profile.


http(s)://<IP/URL Integration Server>:<Port>/dw/monitor/v1/monitorplain4?dw=true&reorg=true

oder

http(s)://<IP/URL Integration Server>:<Port>/dw/monitor/v1/monitorplain4?all=true&reorg=true


Reorganisation sec ago = 23771
Reorganisation duration = 9


Der Wert sec ago zeigt an, vor wie vielen Sekunden der Reorganisationslauf beendet wurde. Der Wert duration zeigt die Dauer des Laufs in Sekunden an.

Sonderfälle


Wenn in den letzten 36 Stunden keine Reorganisation erfolgte:


Reorganisation sec ago = -1
Reorganisation duration =


Wenn die Reorganisation gestartet, aber nicht erfolgreich beendet wurde:


Reorganisation sec ago = 24491
Reorganisation duration = -1


Die Wert sec ago bezieht sich im letzten Fall auf den Start des Laufs, weil das Ende nicht festgestellt werden kann.

Status SAP


Der folgende Aufruf zeigt Informationen zu angebundenen SAP-Systemen. Hinweis: Der Parameter muss explizit angegeben werden und ist nicht in all=true enthalten.


http(s)://<IP/URL Integration Server>:<Port>/dw/monitor/v1/monitorplain4?sap=true


SAP status = Alive
SAP aliases = 0/1 [my_sap_alias/0] !


Die erste Zeile zeigt an, ob der SAP-Service läuft.

Läuft der Service, werden in der zweiten Zeile Informationen zu den Aliasen angezeigt. Format:


<Anzahl konfigurierter Aliase mit Verbindungen>/<Anzahl konfigurierter Aliase> [<Name Alias>/<Anzahl von Verbindungen>,<Name Alias>/<Anzahl von Verbindungen>, ...]


Am Ende der Zeile wird ein Ausrufezeichen angefügt, falls die Zahl der verbunden Aliase kleiner ist, als die Anzahl der konfigurierten Aliase, also wenigstens ein Alias keine Verbindung hat. Hinweis: Die Anzahl der Verbindungen entspricht der Gesamtzahl, die im SapConnectionService in der Admin-Konsole angezeigt wird.

Festplattenauslastung


Der folgende Aufruf zeigt zusätzlich Informationen zur Festplattenauslastung der Partition, in der Lobster_data installiert ist.


http(s)://<IP/URL Integration Server>:<Port>/dw/monitor/v1/monitorplain4?hdd=true

oder

http(s)://<IP/URL Integration Server>:<Port>/dw/monitor/v1/monitorplain4?all=true
HDD TotalMBytes = 61725
HDD FreeMBytes = 47638
HDD FreePercent = 77.18