Users
Reference to Servoy Cloud Environment Users dashboard
Last updated
Was this helpful?
Reference to Servoy Cloud Environment Users dashboard
Last updated
Was this helpful?
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 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
Query Performance
Log activity
App. Performance
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.
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.
The Query Performance tab provides insights into the execution time and details of SQL queries run in the environment. This feature helps identify slow-performing queries and optimize database performance.
Date: Displays the timestamp when the query was executed.
Time (ms): Indicates the query's execution duration in milliseconds, highlighting performance bottlenecks.
DB Name: Specifies the database where the query was executed.
Query Type: Categorizes the query (e.g., Custom, System).
Environment: Shows the environment where the query was run.
SQL Action: Displays the SQL query. Long queries are truncated, with an option to expand for full details.
The Log Activity tab provides a detailed record of system and user-generated logs, enabling efficient monitoring and debugging. Each log entry is categorized by severity and includes key metadata for analysis.
Columns Explained:
Date: Displays the timestamp when the log was generated.
Level: Categorizes the log severity, such as:
WARN: Indicates potential issues that may require attention.
INFO: General information about system activity.
ERROR: Highlights critical problems that need immediate resolution.
Message: Provides a brief summary of the log.
Hostname: Specifies the server or pod where the log was generated.
The App. Performance tab provides insights into the execution performance of methods executed by the client. It helps monitor average execution times, usage frequency, and potential performance bottlenecks.
Columns Explained:
AVG Time: Displays the average execution time (in milliseconds) for each method.
Count: Shows the total number of times the method was executed.
Method Name: Indicates the name of the method being tracked.
Environment: Specifies the environment where the method was executed (e.g., development, production).
In addition to viewing session details, the Actions button allows you to manage the session directly. You can:
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
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
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.
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.
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.
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.
The Active User Sessions overview is currently not supported for .
: 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.
: Forcefully terminate the user’s session, which may be necessary for troubleshooting or security purposes.
Refer to the below for detailed instructions on performing these tasks and understanding their associated restrictions.
You can access user-level actions both from the user card on the main Active User Sessions page and from the screen of that session.
You can send a message to a specific user from either the screen or the user card on the main page.
You can shut down a specific user session from either the screen or directly from the user card.
