... |
... |
@@ -4,15
+4,14 @@ |
4 |
4 |
|
5 |
5 |
{{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: |
6 |
6 |
|
7 |
|
-* {{litem title="{{fserver/~}~}"}}de.xima.fc:type=FSMonitor,qualifier=<Kontext-Name> {{/litem}} |
8 |
|
-* {{litem title="{{mserver/~}~}"}} de.xima.fc:type=MSMonitor,qualifier=<Kontext-Name> {{/litem}} |
|
7 |
+; Frontend-Server |
|
8 |
+: de.xima.fc:type=FSMonitor,qualifier=<Kontext-Name> |
|
9 |
+; Master-Server |
|
10 |
+: de.xima.fc:type=MSMonitor,qualifier=<Kontext-Name> |
9 |
9 |
|
10 |
|
-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: |
|
12 |
+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: |
11 |
11 |
|
12 |
|
- |
13 |
|
-=== {{mserver/}} (MSMonitor) === |
14 |
|
- |
15 |
|
-{{table caption="Übersicht über Eigenschaften MSMonitor" dataTypeAlpha="0" preSort="0-asc"}} |
|
14 |
+{{table caption="Übersicht über die Eigenschaften des MSMonitor (Master-Server)" dataTypeAlpha="0" preSort="0-asc"}} |
16 |
16 |
|= Attribut|=Bedeutung|= Mögliche Werte |
17 |
17 |
|running|Gibt an, ob der {{mserver/}} aktiv ist|true,false |
18 |
18 |
|db_connected|Gibt an, ob der {{mserver/}} erfolgreich eine Datenbankverbindung herstellen konnte.|true,false |
... |
... |
@@ -26,10
+26,10 @@ |
26 |
26 |
AUTHENTICATING, WAIT_FOR_CONNECTION |
27 |
27 |
|fs_disconnected_count| Gibt die Anzahl der nicht verbundenen {{fserver case="nom" number="plural"/}} an.|Zahlen größer/gleich 0 |
28 |
28 |
|fs_connected_count| Gibt die Anzahl der verbundenen {{fserver case="nom" number="plural"/}} an.|Zahlen größer/gleich 0 |
|
28 |
+|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. |
29 |
29 |
{{/table}} |
30 |
30 |
|
31 |
|
-=== {{fserver/}} (FSMonitor) === |
32 |
|
- |
|
31 |
+{{table dataTypeAlpha="0" preSort="0-asc" fullwidth="true" caption="Übersicht über die Eigenschaften des FSMonitor (frontend-Server)"}} |
33 |
33 |
|=Attribut|=Bedeutung|=Mögliche Werte |
34 |
34 |
|running|Gibt an, ob der {{fserver/}} erfolgreich gestartet wurde.|true,false |
35 |
35 |
|connected|Gibt an, ob der {{fserver/}} mit einem {{mserver/}} verbunden ist.|true,false |
... |
... |
@@ -36,6
+36,8 @@ |
36 |
36 |
|status|Gibt den konkreten Verbindungsstatus des {{fserver case="gen"/}} an.|CONNECTED,NOT_CONNECTED,ERROR, |
37 |
37 |
RECONNECTING,DISCONNECTING,CONNECTING, |
38 |
38 |
AUTHENTICATING, WAIT_FOR_CONNECTION |
|
38 |
+|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. |
|
39 |
+{{/table}} |
39 |
39 |
|
40 |
40 |
== JSON-REST-Schnittstelle == |
41 |
41 |
|
... |
... |
@@ -107,7
+107,7 @@ |
107 |
107 |
|
108 |
108 |
{{panel title="Service-Definitionen" fullwidth="true" initial="hidden" triggerable="true"}} |
109 |
109 |
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: |
110 |
|
- |
|
111 |
+<br> |
111 |
111 |
{{code}} |
112 |
112 |
define service{ |
113 |
113 |
use generic-service |
... |
... |
@@ -157,7
+157,7 @@ |
157 |
157 |
|
158 |
158 |
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"]]) |
159 |
159 |
|
160 |
|
-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"]]. |
|
161 |
+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"]]. |
161 |
161 |
|
162 |
162 |
Entsprechend des Betriebs einer parallelen Jolokia-Installation ändert sich beispielhaft die Überprüfung der Verbindung zum {{fserver case="dat"/}} //localhost //wie folgt: |
163 |
163 |
|
... |
... |
@@ -169,5
+169,3 @@ |
169 |
169 |
check_command check_jmx4perl!http://fc-test/jolokia/!de.xima.fc:type=MSMonitor,qualifier=formcycle!fs_connected!--path=localhost --string --critical 'false' |
170 |
170 |
} |
171 |
171 |
{{/code}} |
172 |
|
- |
173 |
|
- |