Snooping on a Queue

About this task

Snooping on a queue in the Enterprise Manager enables you to view the contents of events published on the queue. You can view details about all events on the queue or about a specific set of events, based on their event IDs or additional filtering criteria.

To start snooping on a queue

Procedure

In the namespace tree of a realm, select the queue on which you want to snoop and click the Snoop tab.
Do any of the following:
- To snoop on all events published on the queue, click Start.
- To snoop on a range of events, in the From field, specify the ID of the first event in the range, and in the To field, specify the ID of the last event in the range. Click Start.
  Note: If you do not specify a value in the From field, the range of events starts with the first event on the queue and ends with the event specified in the To field. If you do not specify a value in the To field, the range of events starts with the event specified in the From field and ends with the last event on the queue.
- To snoop on events that match specific filtering criteria based on the properties of the event, in the Filter field, specify a selector string that will be used for filtering. Click Start.

Results

The Enterprise Manager populates the snooped events table with the events published on the queue. You can view details about the events.

You can pause the snoop temporarily or stop the snoop altogether. Stopping the queue snoop clears the snooped events table.

Viewing Details About Snooped Events on a Queue

Edit online

About this task

After you start snooping on a queue in the Enterprise Manager, any events published on the queue are added to the snooped events table on the Snoop tab. The table displays information about each event including the event ID, tag, time to live (TTL), and whether the event is persistent.

When you select an event in the table, you can view additional details about the event including a hexadecimal view of the event data and an ASCII representation of the event data, the header and properties of the event.

Purging Events from a Queue

Edit online

About this task

After you start snooping on a queue, you can purge snooped events from the queue. You can purge a single event, a range of events, or all events.

To purge events from a queue in the Enterprise Manager

Procedure

In the namespace tree of a realm, select the queue from which you want to purge events.
Perform any of the following actions:
- To purge all events, right-click the queue and select Purge All Events.
- To purge a range of events, right-click the queue and select Purge Events. In the Start EID field specify the ID of the first event in the range, and in the End EID field, specify the ID of the last event in the range. In addition, you can specify filtering criteria based on the properties of the event, so that only events that match these criteria are purged.
  Note: If you do not specify a value in the Start EID field, the range of events to purge starts with the first event on the queue and ends with the event specified in the End EID field. If you do not specify a value in the End EID field, the range of events starts with the event specified in the Start EID field and ends with the last event on the queue.
- To purge a single event, go to the Snoop tab and select the event in the snooped events table. Right-click the event and select Purge Event.