Configuring user sessions
These settings are optional.
If you don’t do anything user session metrics are turned on by default.
A description of what user sessions are is available in the Concepts section.
Detailed user session metrics are retrieved for all virtual proxies specified in the
In other words: For each monitored Sense server it is possible to specify which of the server’s proxy service’s virtual proxies should be monitored with respect to per-user session metrics.
Right, that’s a long sentence…
Let’s try again: For each monitored Sense server, decide which virtual proxies should be monitored.
Enter those proxies in the
Butler-SOS.serversToMonitor.servers.userSessions.VirtualProxies array for the server in question.
In order to get detailed, per-user and virtual proxy session info you need to
- Configure the
Butler-SOS.userSessionssection of the config file with general parameters about how often sessions should be polled, user blacklist etc.
Don’t forget to set
- For each server then set
Butler-SOS.serversToMonitor.servers.userSessions.enableto true and specify which virtual proxies should be monitored.
You will only get user session info if you configure both the points above.
Settings in main config file
Butler-SOS: ... ... # Sessions per virtual proxy userSessions: enableSessionExtract: true # Query unique user IDs of what users have sessions open (true/false)? # Items below are mandatory if enableSessionExtract=true pollingInterval: 30000 # How often (milliseconds) should session data be polled? excludeUser: # Optional blacklist of users that should be disregarded when it comes to session monitoring. # Blacklist is only applied to data in InfluxDB. All session data will be sent to MQTT. - directory: LAB userId: testuser1 - directory: LAB userId: testuser2 ... ... serversToMonitor: ... ... # Sense Servers that should be queried for healthcheck data servers: - host: <server1.my.domain>:4747 serverName: <server1> serverDescription: <description> logDbHost: <host name as used in QLogs db> userSessions: enable: true # Items below are mandatory if userSessions.enable=true host: <server1.my.domain>:4243 virtualProxies: - virtualProxy: / # Default virtual proxy - virtualProxy: /hdr # "hdr" virtual proxy - virtualProxy: /sales # "sales" virtual proxy ... ...
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how Butler SOS can be improved.