Agent¶
Der Session Monitor Agent ist ein Service, der in jeder Session gestartet wird. Der Service baut eine Verbindung zum Session Monitor Server auf und liefert Nachrichten an den Benutzer der Session aus.
Zudem kann der Service die Prozesse des Nutzers überwachen und ihm bei Bedarf anbieten problematische zu beenden.
Features¶
Nachrichten an Benutzer: Zeigt dem Benutzer Nachrichten an.
Feedback von des Benutzers: Ein optionales Feedback System erlaubt dem Benutzer eine kurze Rückmeldung zu geben.
Erkennt Problematische Prozesse: Überwacht problematische Prozesse.
Minimale Ressourcenverbrauch: Der Agent braucht nur minimale Ressourcen.
Sichere Verbindungen: Sichere, vollständig SSL verschlüsselte Kommunikation.
Zentrale Konfiguration: Der Agent holt sich seine Konfiguration direkt vom Server.
Konfiguration¶
Die Konfiguration des Agent Services basiert auf unserem Konfigurationssystem. Im einfachsten Fall schreibst du dabei deine Konfiguration in die Datei configuration.xml welche du im Verzeichnis der Anwendung platzierst. Die genauen Details zum Konfigurationssystem findest du im Kapitel Konfigurationssystem.
Schema der Konfiguration¶
Das folgende Schema zeigt die Struktur der Konfiguration:
Module
Application
Must not be empty.
Must not be empty.
Must not be empty.
Der Wert host¶
Mit dem Wert host konfigurierst du den Hostnamen oder die IP-Adresse des Session Monitor Servers.
<Module name="Application">
<Value name="host">server1.example.com</Value>
<Value name="apiKey">tB*Os(...)T40v</Value>
<Value name="apiSecret">rbD(...)/j5Fm</Value>
</Module>
Der Wert port¶
Mit dem optionalen Wert port gibst du einen eigenen Port für die Verbindung zum Session Monitor Server an. Lässt du diesen Wert weg, wird der Default 17671 verwendet.
<Module name="Application">
<Value name="host">server1.example.com</Value>
<Value name="port">12345</Value>
<Value name="apiKey">tB*Os(...)T40v</Value>
<Value name="apiSecret">rbD(...)/j5Fm</Value>
</Module>
Der Wert apiKey¶
Der Wert apiKey konfiguriert den Schlüssel des Schlüsselpaars für die Authentifizierung am Session Monitor Server.
Das Schlüsselpaar wird mit dem Secret Generator erstellt. Siehe dazu Das Secret System.
<Module name="Application">
<Value name="host">server1.example.com</Value>
<Value name="apiKey">tB*Os(...)T40v</Value>
<Value name="apiSecret">rbD(...)/j5Fm</Value>
</Module>
Der Wert apiSecret¶
Der Wert apiSecret konfiguriert das Secret des Schlüsselpaars für die Authentifizierung am Session Monitor Server.
Das Schlüsselpaar wird mit dem Secret Generator erstellt. Siehe dazu Das Secret System.
<Module name="Application">
<Value name="host">server1.example.com</Value>
<Value name="apiKey">tB*Os(...)T40v</Value>
<Value name="apiSecret">rbD(...)/j5Fm</Value>
</Module>
Der Wert retryDelay¶
Mit dem optionalen Wert retryDelay konfiguriert die Verzögerung zwischen zwei Versuchen eine Verbindung zum Session Monitor Server herzustellen. Lässt du diesen Wert weg, wird der Default von 20 Sekunden verwendet.
In grossen Installationen kann der Netzwerkverkehr von vielen Agents zu einem Problem werden, falls der Server nicht mehr verfügbar ist. Hier macht es Sinn die Verzögerung auf einen höheren Wert zu setzen.
Der Nachteil einer grösseren Verzögerung ist der längere Zeitraum bis alle Agents nach einem Neustart des Servers wieder verbunden sind.
<Module name="Application">
<Value name="host">server1.example.com</Value>
<Value name="apiKey">tB*Os(...)T40v</Value>
<Value name="apiSecret">rbD(...)/j5Fm</Value>
<Value name="retryDelay">60</Value>
</Module>
Beispielkonfiguration¶
Die folgende Beispielkonfiguration verbindet den Agent mit dem Server server1.example.com.
<Module name="Application">
<Value name="host">server1.example.com</Value>
<Value name="apiKey">tB*Os(...)T40v</Value>
<Value name="apiSecret">rbD(...)/j5Fm</Value>
</Module>
