| ... |
... |
@@ -11,25 +11,21 @@ |
| 11 |
11 |
|
| 12 |
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: |
| 13 |
13 |
|
| 14 |
|
-{{table dataTypeAlpha="0" preSort="0-asc" caption="Übersicht über die Eigenschaften des MSMonitor (Master-Server)"}} |
|
14 |
+{{table caption="Übersicht über die Eigenschaften des MSMonitor (Master-Server)" dataTypeAlpha="0" preSort="0-asc"}} |
| 15 |
15 |
|= Attribut|=Bedeutung|= Mögliche Werte |
| 16 |
16 |
|running|Gibt an, ob der {{mserver/}} aktiv ist|true,false |
| 17 |
17 |
|db_connected|Gibt an, ob der {{mserver/}} erfolgreich eine Datenbankverbindung herstellen konnte.|true,false |
| 18 |
|
-|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> |
| 19 |
|
-__Wert__: true,false |
| 20 |
|
-|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> |
| 21 |
|
-__Wert__: true,false |
| 22 |
|
-|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> |
| 23 |
|
-__Wert__: CONNECTED,NOT_CONNECTED,ERROR, |
|
18 |
+|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> |
|
19 |
+__Wert:__ true,false |
|
20 |
+|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> |
|
21 |
+__Wert:__ true,false |
|
22 |
+|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> |
|
23 |
+__Wert:__ CONNECTED,NOT_CONNECTED,ERROR, |
| 24 |
24 |
RECONNECTING,DISCONNECTING,CONNECTING, |
| 25 |
25 |
AUTHENTICATING, WAIT_FOR_CONNECTION |
| 26 |
26 |
|fs_disconnected_count| Gibt die Anzahl der nicht verbundenen {{fserver case="nom" number="plural"/}} an.|Zahlen größer/gleich 0 |
| 27 |
27 |
|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 |
|
-|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) |
| 30 |
|
-__Rückgabewert__: true/false |
| 31 |
|
-|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) |
| 32 |
|
-__Rückgabewert__: true/false |
|
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. |
| 33 |
33 |
{{/table}} |
| 34 |
34 |
|
| 35 |
35 |
{{table dataTypeAlpha="0" preSort="0-asc" fullwidth="true" caption="Übersicht über die Eigenschaften des FSMonitor (frontend-Server)"}} |
| ... |
... |
@@ -40,12 +40,11 @@ |
| 40 |
40 |
RECONNECTING,DISCONNECTING,CONNECTING, |
| 41 |
41 |
AUTHENTICATING, WAIT_FOR_CONNECTION |
| 42 |
42 |
|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. |
| 43 |
|
-|restart|Triggert einen Neustart des Frontend-Servers an.|Keine |
| 44 |
44 |
{{/table}} |
| 45 |
45 |
|
| 46 |
46 |
== JSON-REST-Schnittstelle == |
| 47 |
47 |
|
| 48 |
|
-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"]]. |
|
43 |
+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"]]. |
| 49 |
49 |
|
| 50 |
50 |
Ein möglicher Aufruf, nach erfolgter Installation von Jolokia, sieht hierbei zum Beispiel wie folgt aus: |
| 51 |
51 |
|
| ... |
... |
@@ -167,39 +167,3 @@ |
| 167 |
167 |
check_command check_jmx4perl!http://fc-test/jolokia/!de.xima.fc:type=MSMonitor,qualifier=formcycle!fs_connected!--path=localhost --string --critical 'false' |
| 168 |
168 |
} |
| 169 |
169 |
{{/code}} |
| 170 |
|
- |
| 171 |
|
-== Frontend-Server-Monitoring-URL == |
| 172 |
|
- |
| 173 |
|
-{{version major="7" minor="1" /}} Die Funktionalität steht ab {{formcycle/}} 7.1 zur Verfügung. |
| 174 |
|
- |
| 175 |
|
-Es steht auch eine URL zur Verfügung, über die ein Monitoring des Frontend-Servers möglich ist. Diese ist nur auf der Master-Server verfügbar und lautet: |
| 176 |
|
- |
| 177 |
|
-{{code language="text"}} |
| 178 |
|
- https://<domain>/<context>/monitor/fs/connection |
| 179 |
|
-{{/code}} |
| 180 |
|
- |
| 181 |
|
-Aus Sicherheitsgründen ist diese URL standardmäßig deaktiviert. Zum Aktivieren müssen die [[Anwendungseinstellungen>>doc:Formcycle.SystemSettings.ConfigFiles.ApplicationProperties]] //monitoring.enabled// und //monitoring.allowed.hosts// entsprechend konfiguriert werden. |
| 182 |
|
- |
| 183 |
|
-Läuft der {{formcycle/}}-Server als etwa unter der Domain //demo.firma.de// im Kontext //formcycle//, dann lautet die URL //https://demo.firma.de/formcycle/monitor/fs/connection//. |
| 184 |
|
- |
| 185 |
|
-Als Parameter muss immer entweder der Name des System-Frontend-Servers über den Parameter //name// oder die interne Datenbank-ID über den Parameter //id// angegeben werden: |
| 186 |
|
- |
| 187 |
|
-{{code language="text"}} |
| 188 |
|
- https://<domain>/<context>/monitor/fs/connection?name=MeinFrontendServer |
| 189 |
|
- https://<domain>/<context>/monitor/fs/connection?id=5963 |
| 190 |
|
-{{/code}} |
| 191 |
|
- |
| 192 |
|
-Folgende Möglichkeiten zum Monitoring stehen zur Verfügung: |
| 193 |
|
- |
| 194 |
|
-* {{code language="plain"}}https://<domain>/<context>/monitor/fs/connection?name=<Name>{{/code}} |
| 195 |
|
- |
| 196 |
|
-Prüft, ob eine Verbindung mit dem Frontend-Server besteht. Liefert den HTTP-Statuscode //200// zurück, falls eine Verbindung besteht, ansonsten //500//. |
| 197 |
|
- |
| 198 |
|
-* {{code language="plain"}}https://<domain>/<context>/monitor/fs/connection?name=<Name>&action=connect{{/code}} |
| 199 |
|
- |
| 200 |
|
-Versucht, eine Verbindung zum Frontend-Server herzustellen. Besteht bereits eine Verbindung, wird nichts getan. Liefert den HTTP-Statuscode //200// zurück, wenn bereits eine Verbindung besteht oder die Verbindung erfolgreich hergestellt werden konnte. Falls der Verbindungsaufbau fehlgeschlagen ist, wird der HTTP-Statuscode //500// zurückgeliefert. |
| 201 |
|
- |
| 202 |
|
-* {{code language="plain"}}https://<domain>/<context>/monitor/fs/connection?name=<Name>&action=connect&force=true{{/code}} |
| 203 |
|
- |
| 204 |
|
-Versucht, eine Verbindung zum Frontend-Server herzustellen. Besteht bereits eine Verbindung, wird die Verbindung getrennt und versucht, erneut eine Verbindung aufzubauen. Liefert den HTTP-Statuscode //200// zurück, wenn Verbindung erfolgreich hergestellt werden konnte. Falls der Verbindungsaufbau fehlgeschlagen ist, wird der HTTP-Statuscode //500// zurückgeliefert. |
| 205 |
|
- |
