Managing
the Data Server Using JMX
The Data Server is instrumented
with JMX to allow you to manage and monitor the clients and application
settings. To enable JMX, you must run the Data Server in socket mode and
using the -jmxport command line option:
-jmxport:(port number)
The JMX
Monitor demo, located in demos\jmxmonitor in your Enterprise
RTView installation, shows how to use Enterprise RTView to monitor the
Data Server using JMX.
The Data Server contains
one MBean named RTViewDataServer:name=Manager with the following
methods:
| Method/Attribute |
Type |
Description |
| ClientData |
TabularData |
For
each client connection, the table contains the following columns.
| Client
ID - A unique number assigned by the Data Server to this client connection.
The first client connection is assigned an ID of 1, the second is assigned
an ID of 2, etc. The ID for an HTTP/HTTPS client will contain extra digits,
starting with the ID of the Data Servlet's connection. For example, if
the servlet is assigned a client ID of 1, then the first HTTP/HTTPS client
will be assigned an ID of 10001, the next will be 10002, etc. ID numbers
will not be reused during a Data Server session. |
| Address
- IP address of the client. Clients running on the same host as the Data
Server will display the IP address 127.0.0.1. |
| Host
- Name of the host on which the client is running. Clients running
on the same host as the Data Server will display the host name
localhost.
If a client's host cannot be determined, the IP address will be shown instead. |
| Duration
- Time elapsed in this client's session with the Data Server. |
| Last
Data Sent - Number of characters of XML data contained in this client's
most recent update. |
| Total
Data Sent - Number of characters of XML data contained in all updates
during this client's session with the Data Server. |
|
| NumberOfClients |
int |
Number of currently connected
clients. |
| ServingData |
boolean |
True if the Data Server
is currently serving data, false otherwise. |
The RTViewDataServer:name=Manager
MBean
also supports the following commands:
| Method/Attribute |
Description |
| startServingData |
Start serving data. |
| stopServingData |
Stop serving data. |
|
