Monitoring-Webseite
Seite "monitorplain"
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 kann Ihnen auf Anforderung ein Servlet bzw. eine Java Server Page (JSP) bereitgestellt werden. Bei Fragen hierzu wenden Sie sich bitte an unseren Support.
Im einfachsten Fall wird die JSP-Datei einfach in das Verzeichnis ./webapps/root kopiert. Der Zugriff per HTTP erfolgt dann über die folgende URL.
http://<server>:<port>/monitorplain.jsp |
Wobei für server und port dieselben Parameter verwendet werden, wie sie auch im Lobster_data-Client eingetragen werden.
Jeder HTTP-Zugriff auf monitorplain.jsp liefert eine Response als plain text (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. |
dw=true |
Status von Lobster_data anzeigen. |
max=true |
Wirkt nur zusammen mit all und dw. Dann wird die aktuell längste Profillaufzeit angezeigt. |
all=true |
Gleichbedeutend mit ftp=true&smtp=true&oftp=true&message=true&dw=true |
Hinweis: Die Query beginnt mit ?, die Parameter werden durch & getrennt.
Aufruf
Der folgende Aufruf zeigt z. B. den Status von Lobster_data an.
http://<server>:<port>/monitorplain.jsp?dw=true |
Die JSP-Datei wird beim ersten Aufruf in ein Servlet kompiliert, spätere Aufrufe antworten dann in wenigen Millisekunden. Nur der Parameter max=true (in Verbindung mit dw=true) verbraucht mehr Ressourcen und sollte daher nicht öfter als etwa alle 10 Sekunden aufgerufen werden. Falls die JSP-Datei beim ersten Aufruf nicht kompiliert werden kann, erscheint ein HTTP Error 500. Das hat für die restlichen Komponenten keine negativen Auswirkungen, und könnte daran liegen, dass die Datei nicht zur Version Ihres Systems passt. Wenden Sie sich dann bitte an unseren Support.
Ergebnis
Bei einem parameterlosen Aufruf
http://<server>:<port>/monitorplain.jsp |
wird der Status des Haupt-Webservers sowie des Speichers ausgegeben.
Server's local time = Wed Feb 06 10:17:42 CET 2008
HTTP status = Alive
Total memory = 438460 KB
Free memory = 260429 KB
Max memory = 914560 KB
Used memory = 40% used
Die meisten Informationen erhält man mit dem Parameter all.
http://<server>:<port>/monitorplain.jsp?all=true |
Das würde beispielsweise folgendes Ergebnis liefern.
Server's local time = Wed Feb 06 09:24:12 CET 2008
HTTP status = Alive
FTP status = Alive
SMTP status = Alive
OFTP TCP/IP status = Failed -> Connection refused: connect
Message remote interface = Alive
DataWizard status = Alive
DataWizard processed requests = 24657
DataWizard queued jobs = 0
DataWizard queued responses = 0
DataWizard total errors = 61
DataWizard running profiles = 0
Total memory = 438460 KB
Free memory = 283351 KB
Max memory = 914560 KB
Used memory = 35% used
Der Aufruf mit Parameter max (wirkt nur mit all oder dw)
http://<server>:<port>/monitorplain.jsp?dw=true&max=true |
liefert zusätzlich folgende Ergebniszeile.
DataWizard max job duration = 3203 ms for job 36757