This is archived documentation for an older version of Nirvana (v3.1). Please refer to documentation for the latest version if required.

Nirvana Enterprise Manager - Channel Connections

Channel Connections

When a Nirvana client connects to a Realm Server, the server maintains information on the connection that is available through the Nirvana Administration API. The API also provides mechanisms for receiving notification when connections are added and deleted. Click here for an example of connection listening using the Administration API.

Connection information is also maintained when Nirvana clients subscribe to channels. This section guides you through channel connection information.

The Nirvana Enterprise Manager allows you to view the connections (channel subscriptions) on a realm and drilldown to view more detailed 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 connections for a channel, select a channel node from the namespace, and select the 'Connections' tab. This will display a panel containing a table of connections, as shown in the image below.

The connections table has 6columns:

Protocol - The protocol used in the connection
User - The name of the user connected
Host - The host machine that the user is connecting from
Connection - The local connection id, defined as hostname:local_port
Sub-Name- The named object reference if one has been provided
Filter - The filter string for the subscription if one has been provided

The highlighted connection above shows that the user has subscriber to the /customer/sales channel using the nhp protocol, to localhost. The user has also provided a named object called 'johnsmith' and a filter of "REGION='UK'" which will ensure the user only consumes events with the value 'UK' in the REGION property of the event properties.

When a connection is highlighted, there a number of things that can be shown for a the connection.

Firstly, connections can be disconnected by clicking on the 'Disconnect' button.

Secondly, by double-clicking on a connection from the table, or by clicking on the 'Show Details' button, you are presented with a panel that contains a more detailed look at the activity for the selected connection. The connection details panel is shown in the image below.

The two graphs, labelled 'Tx Event History' and 'Rx Event History' show the total (yellow) and rates (red) for events received from the server (TX) and sent to the server (RX) for the selected connection.

The bottom of the connection details panel shows 3 sections of information for the selected connection, 'Events Sent', 'Events Received' and 'Status'. Each of these are described below.

Events Sent

The Events Sent section shows 5 values:

Total - The total number of events sent by the realm server to this conneciton
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 shows 5 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 Events Sent section shows 4values:

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

Clicking on the 'Show List' button will take you back to the connections table.