Users
Reference to Servoy Cloud Environment Users dashboard
Last updated
Reference to Servoy Cloud Environment Users dashboard
Last updated
The Users dashboard provides a visual representation of client sessions within a Servoy cloud environment, along with detailed insights into active sessions. It provides both a chart view of the session count and session-specific actions.
The "User Sessions Over Time" section features a chart displaying the number of user/client sessions over a selected time period. The data can be filtered using the available options for a customized view. You can also hide the chart to focus on other parts of the page.
The Active User Sessions overview is currently not supported for Remote Environments.
The Active User Sessions overview offers easy monitoring and management of user sessions within a Servoy cloud environment, ensuring both real-time insights and control over session activity.
Each active session is represented by a user card that contains the following information:
Username/Client Type: Displays the username if logged in, or the client type if not. If the session belongs to a Servoy Headless Client, it will display "Servoy Headless Client."
"Not signed in" badge: Emphasizes the difference between logged in clients and those still on the login page
Avatar: The user’s avatar from Gravatar is shown. For Servoy Headless Clients, the Servoy logo is displayed.
Solution: The Servoy solution being used (e.g., svyCloudSampleSolution).
Server: The server hosting the user session (e.g., dev-cloudSampleSolution-0-0).
Session Status: Indicates whether the user is online (green dot) or idle (yellow dot).
Last Active Timestamp: Shows the last time the user was active
Each active session has a detailed screen that provides in-depth information and management options for the user or client session. You can access this detail page by clicking on the respective user card from the Active User Sessions overview.
The user detail page is divided into the following main sections:
User Details
Additional Info
Locks
Transactions
Actions
This section provides key information about the active session, including:
Solution Name: The Servoy solution currently being used in the session (e.g., svyCloudSampleSolution).
Server Name: The server hosting the active session (e.g., dev-cloudSampleSolution-0-0).
Client Type: The type of client being used (e.g., Servoy NG Client, Servoy Headless Client etc.).
Session Status: Indicates whether the user is online (green dot) or idle (yellow dot) along with the last active timestamp
IP Address: The IP address of the user
Client UUID: A unique identifier assigned to the client session
The Additional Info tab contains a read-only table displaying user-specific properties that are defined programmatically from within the Servoy Application. Some properties may be, but not limited to:
Default:
User Agent: The browser or client information (e.g., Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.36 Edg/129.0.0.0).
Platform: The operating system (e.g., Win32).
Locale: The language and region setting (e.g., en_US).
Session Key: A unique key used to identify the session (e.g., 2B6980B:2).
Custom additional information can be added by using:
This data is typically used for troubleshooting or auditing purposes and is displayed in a table format for easy review.
The Locks tab displays a read-only table listing all locks acquired by the user during their session. This can be useful for tracking locked resources and debugging potential issues. Each lock entry includes the following details:
Table Name: The name of the database table where the lock was acquired.
Server Name: The server on which the lock was acquired.
Key Locked: The specific key or record that is locked.
Start Time: The timestamp when the lock was acquired.
This tab helps monitor resource access and ensure that locks are released properly to avoid conflicts.
Releasing locks isn't supported yet
The Transactions tab shows a read-only table of transactions started by the user. This information is crucial for managing database interactions and ensuring transactional integrity. Each transaction entry includes:
Transaction ID: A unique identifier for the transaction.
Server Name: The server where the transaction is taking place.
Start Time: The timestamp when the transaction was initiated.
Last Accessed: The most recent time the transaction was accessed or modified.
This section helps in tracking open transactions, diagnosing any potential issues, and ensuring that long-running transactions do not negatively impact performance.
Committing / Rollback of transactions isn't supported yet
In addition to viewing session details, the Actions button allows you to manage the session directly. You can:
Message User: Send a direct message to the user of the session. This is useful for notifying the user of upcoming system maintenance or other critical updates.
Shutdown Client: Forcefully terminate the user’s session, which may be necessary for troubleshooting or security purposes.
Refer to the Actions section below for detailed instructions on performing these tasks and understanding their associated restrictions.
In Production Environments, messaging and shutdown actions are restricted to users with Administrator permissions
Actions can be performed at two levels: user-level and overview-level.
These actions apply to individual user sessions:
Message User: Send a message directly to a specific user.
Shutdown Client: Forcefully terminate a user’s session
You can access user-level actions both from the user card on the main Active User Sessions page and from the User Detail screen of that session.
These actions apply to all active sessions in the environment:
Refresh Users: Refresh the list of active sessions
Send message to all users: Send a message to all currently active users
Shutdown all clients: Shut down all active user sessions in the list
You can send a message to a specific user from either the User Detail screen or the user card on the main page.
Note: Messaging Servoy Headless Clients is not supported.
In Production Environments, messaging and shutdown actions are restricted to users with Administrator permissions
Steps to Message a User:
From the Active User Sessions page:
Navigate to Environment Details -> User Count -> Active User Sessions.
Locate the desired user card.
Click the context menu (top-right corner of the user card).
Select Message User to open the message dialog.
Enter your message and click Send.
From the User Detail screen:
Access the User Detail screen by clicking on the user card.
Use the Actions button on the detail page.
Select Message User and follow the same steps to send a message.
You can shut down a specific user session from either the User Detail screen or directly from the user card.
Steps to Shutdown a Client:
From the Active User Sessions page:
Navigate to Environment Details -> User Count -> Active User Sessions.
Click the context menu (top-right corner of the user card) for the session you want to terminate.
Select Shutdown Client and confirm by clicking Shutdown client.
From the User Detail screen:
Access the User Detail screen by clicking on the user card.
Use the Actions button and select Shutdown Client to terminate the session.
In Production Environments, messaging and shutdown actions are restricted to users with Administrator permissions
The active session data is loaded when the page is displayed, but it is not updated in real-time.
To refresh the session list and bring it up to date:
Navigate to Active User Sessions:
Go to Environment Details -> User Count -> Active User Sessions
Refresh Users
Click the Actions button to open the actions menu.
Select Refresh Users to update the session list.
To broadcast a message to all active user sessions displayed in the list:
Navigate to Active User Sessions:
Go to Environment Details -> User Count -> Active User Sessions
Message User
Open the Actions menu by clicking the Actions button.
Select Send message to all users.
Enter your message in the dialog and click Send.
Note: Messaging Servoy Headless Clients is not supported.
In Production Environments, messaging and shutdown actions are restricted to users with Administrator permissions
To shut down all active user sessions displayed in the list:
Navigate to Active User Sessions:
Go to Environment Details -> User Count -> Active User Sessions
Shut down client
Open the Actions menu by clicking the Actions button.
Select Shutdown all clients and confirm your intent by clicking the Shutdown clients button.
In Production Environments, messaging and shutdown actions are restricted to users with Administrator permissions
