7.2 Event Monitoring

Event Monitoring includes three different sections:

  • EventServerQueue - which shows information about all the events in the system

  • EventListenerQueue - which shows information about the different listeners in the system

  • ECEventSenderQueue - which shows information about the events that the Execution Context will try to send to the Platform. If the connection with the Platform is broken, the Execution Context will cache the events and then try to send them again once the connection is back up.


Monitoring the EventServerQueue

If you want to monitor the EventServerQueue:
 

  1. Select the codeserver process when starting the JMX client, see 7.1 Starting the Jconsole Client for further information.

    The Java Monitoring & Management Console will open and display the Overview tab.
     

  2. Click on the MBeans tab to display the different beans.
     

  3. Expand the tree in the left section by clicking on the plus sign for com.digitalroute.event, then on the plus sign for EventServerQueue.
     

  4. Click on Attributes in the tree to display the different attribute values in the right section of the JConsole window.

    JConsole displaying the attributes for EventServerQueue

For the EventServerQueue, you can see the following information:


AttributeDescription

EventLoad

This attribute value shows the current load of the EventServerQueue, i e the amount of the queue's maximum size that is occupied with events, where 0.75 equals 75 %, 0.5 equals 50 %, etc.

NoOfListeners

This attribute value shows the total number of listeners within the system. If you want to view information about a specific listener, see the section below, Monitoring the EventListenerQueue.

QueueSize

This attribute value shows the total number of events in the queue.

TotalEvents

This attribute value shows the total number of events logged since the Platform was started.

Monitoring the EventListenerQueue

The EventListenerQueue contains a list of all the listeners to which the Event Server is about to dispatch events.

To view the different listeners, follow the same procedure as for the EventServerQueue, see the section above, Monitoring the EventServerQueue, but click on the plus sign for EventListenerQueue instead.

Expand the tree for the listener that you want to view attributes for by clicking on the plus signs for the EventListener you want to view and for Listener. Click on on Attributes to display the different attribute values in the right section of the JConsole window.



JConsole displaying the attributes for EventListenerQueue

For each listener in the EventListenerQueue you can see the following information:


AttributeDescription

EventLoad

This attribute value shows the current load of the EventListenerQueue, i e the amount of the queue's maximum size that is occupied with events, where 0.75 equals 75 %, 0.5 equals 50 %, etc.

QueueSize

This attribute value shows the total number of events in the listener's queue.

TotalEvents

This attribute value shows the total number of events logged for the listener since the Platform was started.

Monitoring the ECEventSenderQueue

If you want to monitor the ECEventSenderQueue:
 

  1. Select the picostart process for the Execution Context you want to monitor when starting the JMX client, see 7.1 Starting the Jconsole Client for further information.

    The Java Monitoring & Management Console will open and display the Overview tab.
     

  2. Click on the MBeans tab to display the different beans.
     

  3. Expand the tree in the left section by clicking the plus sign for com.digitalroute.event , then the plus sign for ECEventSenderQueue.
     

  4. Click on Attributes in the tree to display the different attribute values in the right section of the JConsole window.

    JConsole displaying the attributes for ECEventSenderQueue

For the ECEventSenderQueue you can see the following information:


AttributeDescription

ConnectedToPlatform

This attribute value shows whether the Execution Context (ECSA) is connected to the Platform (true) or not (false).

ConnectionDownTime

This attribute value shows for how long the connection with the Platform has been down. This value is displayed in seconds.

EventLoad

This attribute value shows the current event load of the EventSender queue, i e the amount of the queue's maximum size that is occupied with events, where 0.75 equals 75 %, 0.5 equals 50 %, etc.

PersistentQueueSize

This attribute value shows the number of events that the Execution Context has not been able to send to the Platform due to broken connection.

QueueSize

This attribute value shows the total number of events in the queue.

TotalEvents

This attribute value shows the total number of events logged since the Execution Context was started.