Description of Monitor Topics


Table 51 describes each monitor topic.

Table 51 Monitor topics (Sheet 1 of 3)
Topic
Message Is Published When...
$sys.monitor.admin.change
The administrator has made a change to the configuration.
$sys.monitor.connection.connect
A user attempts to connect to the server.
$sys.monitor.connection.disconnect
A user connection is disconnected.
$sys.monitor.connection.error
An error occurs on a user connection.
$sys.monitor.consumer.create
A consumer is created.
$sys.monitor.consumer.destroy
A consumer is destroyed.
$sys.monitor.flow.engaged
Stored messages rise above a destination’s limit, engaging the flow control feature.
$sys.monitor.flow.disengaged
Stored messages fall below a destination’s limit, disengaging the flow control feature.
$sys.monitor.limits.connection
Maximum number of hosts or connections is reached.
$sys.monitor.limits.queue
Maximum bytes for queue storage is reached.
$sys.monitor.limits.server
Server memory limit is reached.
$sys.monitor.limits.topic
Maximum bytes for durable subscriptions is reached.
$sys.monitor.producer.create
A producer is created.
$sys.monitor.producer.destroy
A producer is destroyed.
$sys.monitor.queue.create
A dynamic queue is created.
$sys.monitor.route.connect
A route connection is attempted.
$sys.monitor.route.disconnect
A route connection is disconnected.
$sys.monitor.route.error
An error occurs on a route connection.
$sys.monitor.route.interest
A change in registered interest occurs on the route.
$sys.monitor.server.info
The server sends information about an event; for example, a log file is rotated.
$sys.monitor.server.state
The server state changes; for example, an administrator shuts down the server.
$sys.monitor.topic.create
A dynamic topic is created.
$sys.monitor.tx.action
A local transaction commits or rolls back.
$sys.monitor.xa.action
An XA transaction commits or rolls back.
$sys.monitor.<D>.<E>.<destination>
A message is handled by a destination. The name of this monitor topic includes two qualifiers (D and E) and the name of the destination you wish to monitor.
D signifies the type of destination and whether to include the entire message:
  • T — topic, include full message (as a byte array) into each event
  • t — topic, do not incude full message into each event
  • Q — queue, include full message (as a byte array) into each event
  • q — queue, do not incude full message into each event
E signifies the type of event:
  • r for receive
  • s for send
  • a for acknowlege
  • * for all event types
For example, $sys.monitor.T.r.corp.News is the topic for monitoring any received messages to the topic named corp.News. The message body of any received messages is included in monitor messages on this topic. The topic $sys.monitor.q.*.corp.* monitors all message events (send, receive, acknowledge) for all queues matching the name corp.*. The message body is not included in this topic’s messages.
The messages sent to this type of monitor topic include a description of the event, information about where the message came from (a producer, route, external system, and so on), and optionally the message body, depending upon the value of D.
See Monitoring Messages for more information about message monitoring.


TIBCO Enterprise Message Service™ User’s Guide
Software Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com