Änderungen von Dokument Monitoring

Von Version < 1.14 >

bearbeitet von awa
am 20.05.2019, 09:59

Auf Version < 3.1 >

bearbeitet von sas
am 01.06.2021, 13:52

< >

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (2 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Dokument-Autor

@@ -1,1
          +1,1 @@
--XWiki.awa
++XWiki.sas

Inhalt

@@ -5,43
          +5,52 @@
  {{formcycle/}} bietet für das Monitoring des Anwendungsstatus je Server-Typ eine entsprechende Monitoring-Bean an. Diese kann über JMX mit einem dazugehörigen Werkzeug (z.B. //JConsole//) angebunden und abgefragt werden. Die Namen unter der die entsprechenden Beans registriert sind lauten hierbei:
  ; Frontend-Server
--de.xima.fc:type=FSMonitor,qualifier=<Kontext-Name>
++: de.xima.fc:type=FSMonitor,qualifier=<Kontext-Name>
  ; Master-Server
  : de.xima.fc:type=MSMonitor,qualifier=<Kontext-Name>
--Der //qualifier// ist hierbei für eine Parallel-Installation der entsprechenden Server notwendig und entspricht dem Kontext-Namen der Anwendung. Dieser ist hierbei standardmäßig der Namen der *.war-Datei, kann jedoch über den Kontext-Parameter //XFC_CONTEXT_NAME// innerhalb der //web.xml// angepasst werden. Ebenfalls wird während des Starts des entsprechenden Servers der konkret verwendete Name ausgeloggt. Jede Bean besitzt zudem unterschiedliche Monitoring-Attribute welche in folgenden Übersichten dargstellt sind:
++Der //qualifier// ist hierbei für eine Parallel-Installation der entsprechenden Server notwendig und entspricht dem Kontext-Namen der Anwendung. Dieser ist hierbei standardmäßig der Namen der war-Datei, kann jedoch über den Kontext-Parameter //XFC_CONTEXT_NAME// innerhalb der //web.xml// angepasst werden. Ebenfalls wird während des Starts des entsprechenden Servers der konkret verwendete Name ausgeloggt. Hierfür kann es notwendig sein, die [[Logging-Einstellungen>>doc:.UserInterface.Logging]] anzupassen. Jede Bean besitzt zudem unterschiedliche Monitoring-Attribute, welche in folgenden Übersichten dargestellt sind:
--{{table caption="Übersicht über Eigenschaften MSMonitor (Master-Server)" dataTypeAlpha="0" preSort="0-asc"}}
++{{table dataTypeAlpha="0" preSort="0-asc" caption="Übersicht über die Eigenschaften des MSMonitor (Master-Server)"}}
  |= Attribut|=Bedeutung|= Mögliche Werte
--|running|Gibt an, ob der {{mserver/}} aktiv ist|true,false
--|db_connected|Gibt an, ob der {{mserver/}} erfolgreich eine Datenbankverbindung herstellen konnte.|true,false
++|running|Gibt an, ob der {{mserver/}} aktiv ist|true/false
++|db_connected|Gibt an, ob der {{mserver/}} erfolgreich eine Datenbankverbindung herstellen konnte.|true/false
  |fs_connected|Repräsentiert eine Map mit den Namen aller {{fserver case="nom" number="plural"/}} als Schlüssel und als Wert, ob diese mit dem {{mserver case="dat"/}} verbunden sind.|__Schlüssel:__ <Frontend-Server-Name>
--__Wert:__ true,false
++__Rückgabewert:__ true/false
  |fs_active|Repräsentiert eine Map mit den Namen aller {{fserver case="nom" number="plural"/}} als Schlüssel und als Wert ob diese automatisch verbunden werden soll.|__Schlüssel:__ <Frontend-Server-Name>
--__Wert:__ true,false
++__Rückgabewert:__ true/false
  |fs_status|Repräsentiert eine Map mit den Namen aller {{fserver case="nom" number="plural"/}} als Schlüssel und dem konkreten Verbindungsstatus als Wert.|__Schlüssel:__ <Frontend-Server-Name>
--__Wert:__ CONNECTED,NOT_CONNECTED,ERROR,
++__Rückgabewert:__ CONNECTED,NOT_CONNECTED,ERROR,
  RECONNECTING,DISCONNECTING,CONNECTING,
  AUTHENTICATING, WAIT_FOR_CONNECTION
  |fs_disconnected_count| Gibt die Anzahl der nicht verbundenen {{fserver case="nom" number="plural"/}} an.|Zahlen größer/gleich 0
  |fs_connected_count| Gibt die Anzahl der verbundenen {{fserver case="nom" number="plural"/}} an.|Zahlen größer/gleich 0
++|failed_login_count|Gibt die Anzahl der aktuell registrierten fehlerhaften Login-Versuche aus, also wie viele Login-Name sich Cache für die fehlerhaften Versuche befinden.|Eine Zahl größer oder gleich 0.
++|connect_frontendserver_by_name|Triggert eine Verbindung zum Frontend-Servers per Name an.|__Schlüssel:__ <Frontend-Server-Name>, true/false um Reconnect immer anzustoßen (egal ob Verbindung besteht)
++__Rückgabewert:__ true/false
++|connect_frontendserver_by_id|Triggert eine Verbindung zum Frontend-Servers per ID an.|__Schlüssel:__ <Frontend-Server-ID>, true/false um Reconnect immer anzustoßen (egal ob Verbindung besteht)
++__Rückgabewert:__ true/false
  {{/table}}
  {{table dataTypeAlpha="0" preSort="0-asc" fullwidth="true" caption="Übersicht über die Eigenschaften des FSMonitor (frontend-Server)"}}
  |=Attribut|=Bedeutung|=Mögliche Werte
--|running|Gibt an, ob der {{fserver/}} erfolgreich gestartet wurde.|true,false
--|connected|Gibt an, ob der {{fserver/}} mit einem {{mserver/}} verbunden ist.|true,false
++|running|Gibt an, ob der {{fserver/}} erfolgreich gestartet wurde.|true/false
++|connected|Gibt an, ob der {{fserver/}} mit einem {{mserver/}} verbunden ist.|true/false
  |status|Gibt den konkreten Verbindungsstatus des {{fserver case="gen"/}} an.|CONNECTED,NOT_CONNECTED,ERROR,
  RECONNECTING,DISCONNECTING,CONNECTING,
  AUTHENTICATING, WAIT_FOR_CONNECTION
++|failed_login_count|Gibt die Anzahl der aktuell registrierten fehlerhaften Login-Versuche aus, also wie viele Login-Name sich Cache für die fehlerhaften Versuche befinden.|Eine Zahl größer oder gleich 0.
++|restart|Triggert einen Neustart des Frontend-Servers an.|Keine
  {{/table}}
  == JSON-REST-Schnittstelle ==
--Die für das Monitoring verwendeten Beans sind ebenfalls über eine bereitgestellte JSON-Schnittstelle aufrufbar. Ein möglicher Aufruf sieht hierbei zum Beispiel wie folgt aus:
++Die JSON-Schnittstelle ist seit Version 6.0.0 zu Gunsten einer separaten Jolokia-Installation entfernt worden. Die für das Monitoring verwendeten Beans sind nachwievor verfügbar. Die JSON-Schnittstelle des Monitorings erlaubte nur lesende Zugriff und war nur über den Anwendungsserver aufrufbar (localhost/127.0.0.1). Falls dies gewünscht ist müsste der Zugriff innerhalb der Jolokia Anwendung konfiguriert werden, weiter Infomationen finden Sie [[hier>>https://jolokia.org/reference/html/security.html#d0e3128||rel="noopener noreferrer" target="_blank"]].
++Ein möglicher Aufruf, nach erfolgter Installation von Jolokia, sieht hierbei zum Beispiel wie folgt aus:
++
  {{info}}
--http://localhost/formcycle/monitoring/read/de.xima.fc:type=MSMonitor,qualifier=formcycle
++[[http:~~/~~/localhost/jolokia/read/de.xima.fc:type=MSMonitor,qualifier=formcycle>>http://localhost/formcycle/monitoring/read/de.xima.fc:type=MSMonitor,qualifier=formcycle]]
  {{/info}}
  JSON-Antwort:
@@ -48,43
          +48,33 @@
  {{code language="JSON"}}
  {
--"timestamp":1440603508,
--"status":200,
--"request":{
--   "mbean":"de.xima.fc:qualifier=formcycle,type=MSMonitor",
--   "type":"read"
--},
--"value":{
--   "fs_active":{
--      "sas":true,
--      "localhost":false,
--      "mko":true
--   },
--   "fs_connected":{
--      "sas":false,
--      "localhost":false,
--      "mko":false
--   },
--   "db_connected":true,"fs_status":{
--      "sas":"ERROR",
--      "localhost":"NOT_CONNECTED",
--      "mko":"ERROR"
--   },
--   "fs_disconnected_count":3,
--   "fs_connected_count":0,
--   "running":true
--   }
++  "request": {
++    "mbean": "de.xima.fc:qualifier=formcycle,type=MSMonitor",
++    "type": "read"
++  },
++  "value": {
++    "running": true,
++    "failed_login_count": 0,
++    "fs_active": {
++      "localhost": true
++    },
++    "db_connected": true,
++    "fs_connected_count": 1,
++    "fs_connected": {
++      "localhost": true
++    },
++    "fs_disconnected_count": 0,
++    "fs_status": {
++      "localhost": "CONNECTED"
++    }
++  },
++  "timestamp": 1579186291,
++  "status": 200
  }
  {{/code}}
++Weitere Informationen zur Abindung des Framework [[Jolokia>>url:https://jolokia.org/||rel="__blank"]] und eine genauere Dokumentation finden sie [[hier>>url:https://jolokia.org/reference/html/||rel="__blank"]].
--Wie erkennbar ist, befindet sich unter dem Kontext der Anwendung das Servlet //../monitoring// welches die eigentliche Interpretation der Beans und deren Aufbereitung in JSON realisiert. Hierfür kommt das Framework [[Jolokia>>url:https://jolokia.org/||rel="__blank"]] zum Einsatz, sodass dieses Servlet entsprechend konfigurierbar und über verschiedene Aufrufe benutzbar ist. Eine genauere Dokumentation hierfür finden sie [[hier>>url:https://jolokia.org/reference/html/||rel="__blank"]].
--
--{{warning}}
--Es ist zu beachten, dass die JSON-Schnittstelle des Monitorings nur lesende Zugriffe erlaubt und nur über den Anwendungsserver aufrufbar ist! (localhost/127.0.0.1)
--{{/warning}}
--
--
  == Nagios-Anbindung ==
  Eine Anbindung der Nagios-Monitoring-Anwendung erfolgt über die beschriebene JSON-Schnittstelle. Hierfür muss das Nagios-Plugin [[jmx4perl>>url:http://search.cpan.org/~~roland/jmx4perl/||rel="__blank"]] installiert werden. Dieses erlaubt es Nagios das JSON zu interpretieren und entsprechende Abfragen aufzubauen. Eine genauere Installations-Dokumentation hierfür finden Sie [[hier>>url:https://jolokia.org/tutorial.html||rel="__blank"]]. Anschließend ist es möglich mit dem entsprechenden command des Plugins die Abfragen an die JSON-Schnittstelle zu formulieren.
@@ -96,7
          +96,7 @@
  {{/warning}}
  {{panel title="Command" fullwidth="true" initial="hidden" triggerable="true"}}
--{{code}}
++{{code language="none"}}
  define command{
   command_name          check_jmx4perl
   command_line          check_jmx4perl --url $ARG1$ --mbean $ARG2$ --attribute $ARG3$ $ARG4$
@@ -105,9
          +105,9 @@
  {{/panel}}
  {{panel title="Service-Definitionen" fullwidth="true" initial="hidden" triggerable="true"}}
--Abfrage der Anzahl der am {{mserver case="dat"/}} nicht verbundenen {{fserver number="plural"/}}. Ist diese größer/gleich 1, erfolgt eine Warnung. Ist diese ferner größer/gleich 2, wird diese als kritisch im Nagios interpretiert:
++Abfrage der Anzahl der am {{mserver case="dat"/}} nicht verbundenen {{fserver number="plural"/}}. Ist diese größer/gleich 1, erfolgt eine Warnung. Ist diese ferner größer/gleich 2, wird diese als kritisch im Nagios interpretiert:<br>
  <br>
--{{code}}
++{{code language="none"}}
  define service{
   use                  generic-service
   host_name            localhost
@@ -118,7
          +118,7 @@
  {{/panel}}
  {{panel title="Abfrage des Datenbank-Verbindungsstatus des {{mserver case='gen'/~}~}" fullwidth="true" initial="hidden" triggerable="true"}}
--{{code}}
++{{code language="none"}}
  define service{
   use                  generic-service
   host_name            localhost
@@ -129,7
          +129,7 @@
  {{/panel}}
  {{panel title="Abfrage, ob {{fserver/~}~} localhost mit {{mserver case='dat'/~}~} verbunden ist" fullwidth="true" initial="hidden" triggerable="true"}}
--{{code}}
++{{code language="none"}}
  define service{
   use                  generic-service
   host_name            localhost
@@ -140,7
          +140,7 @@
  {{/panel}}
  {{panel title="Abfrage an {{fserver/~}~}, ob dieser erfolgreich mit einem {{mserver/~}~} verbunden ist" fullwidth="true" initial="hidden" triggerable="true"}}
--{{code}}
++{{code language="none"}}
  define service{
   use                  generic-service
   host_name            localhost
@@ -156,11
          +156,11 @@
  Eine weitere Möglichkeit um die Anbindung von Nagios von einem anderen Server aus zu ermöglichen, ist der parallele Betrieb von Jolokia und {{formcycle/}} bzw. dem {{fserver case="dat"/}}. Hierfür stellt Jolokia bereits einen in einer eigenen Anwendung gepackten //JavaEE-Agent// zur Verfügung. ([[Dokumentation>>url:https://jolokia.org/reference/html/agents.html#agents-war||rel="__blank"]], [[Download>>url:https://jolokia.org/download.html||rel="__blank"]])
--Dieser besitzt standardmäßig keine Limitierung von Lese-Operationen und Steueranweisungen und ist ebenso nicht bezüglich aufrufender Server bzw. IP-Adressen beschränkt. Da dies jedoch ein potentielles Sicherheitsrisiko darstellt, wird es ausdrücklich empfohlen, diese entsprechend der eigenen Server-Topologie und Anforderungen zu konfigurieren. Hierbei ist zum Beispiel anzuraten, den Zugriff lediglich auf den Nagios-Server zu beschränken. Eine ausführliche Dokumentation der Sicherheitsmechanismen von Jolokia finden Sie [[hier>>url:https://jolokia.org/reference/html/security.html||rel="__blank"]].
++Dieser besitzt standardmäßig keine Limitierung von Leseoperationen und Steueranweisungen und ist ebenso nicht bezüglich aufrufender Server bzw. IP-Adressen beschränkt. Da dies jedoch ein potentielles Sicherheitsrisiko darstellt, wird es ausdrücklich empfohlen, diese entsprechend der eigenen Server-Topologie und Anforderungen zu konfigurieren. Hierbei ist zum Beispiel anzuraten, den Zugriff lediglich auf den Nagios-Server zu beschränken. Eine ausführliche Dokumentation der Sicherheitsmechanismen von Jolokia finden Sie [[hier>>url:https://jolokia.org/reference/html/security.html||rel="__blank"]].
  Entsprechend des Betriebs einer parallelen Jolokia-Installation ändert sich beispielhaft die Überprüfung der Verbindung zum {{fserver case="dat"/}} //localhost //wie folgt:
--{{code}}
++{{code language="none"}}
  define service{
   use                  generic-service
   host_name            fc-test

Änderungen von Dokument Monitoring

Zusammenfassung

Details

Navigation