Realm Connections
When a Universal Messaging client connects to a realm server, the server maintains information about the connection. For more information, see
Connection Information), which is available through the Universal Messaging Administration API. The API also provides mechanisms for receiving notifications when connections are added and deleted. See the code example "Connection Watch" for an illustration of using this in the Administration API.
The Universal Messaging Enterprise Manager enables you to view the connections on a realm as well as to view specific information about each connection, such as the last event sent or received, and the rate of events sent and received from each connection.
To view the current realm connections, select a realm node from the namespace, and then click Monitoring > Connections. The Enterprise Manager displays a panel containing a table of connections, as shown in the image below. The table lists all the clients connected to the realm server
The connections table contains the following information:
protocol - The protocol used in the connection.
user - The name of the connected user.
host - The host machine from which the user is connecting.
connection - The local connection ID, defined as
hostname:local_port.
language - The language that the client application is using.
name - The name of the operating system on which the client application is running.
build number - the build number of the client API.
To disconnect a connection and then make the client reconnect again, select a connection in the table and click Bounce.
To view more details about a specific connection, double-click the connection in the table or click Show Details. The connection details panel is shown in the image below.
Connection Details
The Connection Details panel contains information about the user connection, such as user name, host, and protocol.
Client Environment
The Client Environment panel contains information about the client environment for this user. These include API language / Platform, Host OS, and Universal Messaging build number.
The Tx Event History and Rx Event History graphs show the total (yellow) and rates (red) for events received from the server (TX) and sent to the server (RX) for the selected connection.
Events Sent
The Events Sent section contains the following values:
Total - The total number of events sent by the realm server to this connection
Rate - The rate at which events are being sent by the realm server to this connection
Max - The maximum rate at which events have been sent by the realm server to this connection
Last Event Type - The type of the last event sent from the realm server
Bytes - Total bytes sent by the realm server to this connection
Events Received
The Events Received section contains the following values:
Total - The total number of events sent by this connection to the realm server
Rate - The rate at which events are being sent by connection to the realm server
Max - The maximum rate at which events have been sent by this connection to the realm server
Last Event Type - The type of the last event sent from the connection to the realm server
Bytes - Total bytes sent by this connection to the realm server
Status
The Status section contains the following values:
Connect Time - The amount of time this connection has been connected to the realm server
Queue Size - The number of events in the outbound queue of this connection (i.e. events waiting to be sent to the realm server)
Last Tx - The time since the last event was received by this connection from the realm server
Last Rx - The time since the last event was sent to the server from this connection
Click Show List to go back to the connections table.
