Queue browser

Last modified by Erik Bakker on 2024/11/24 09:36

In this microlearning, we will focus on the queue browser functionality. This powerful new feature within our current generation architecture provides visibility into the data flowing through your system, offering the ability to monitor, analyze, and manage messages. On top of that, this feature enables you to wiretap information for analysis purposes and even delete messages that should not be in a specific queue. Let's dive into the key concepts and features of this exciting addition!

Should you have any questions, please contact academy@emagiz.com.

1. Prerequisites

  • Basic knowledge of the eMagiz platform
  • Understanding of the flow testing functionality

2. Key concepts

This microlearning centers around the queue browser.

  • The queue browser can be used to view data on the queue.
  • The queue browser can be used to wiretap a queue to see all future messages (in the next ten minutes).
  • Message payloads above 100KB are not shown.
  • The queue browser allows you to delete one (or all) message(s) from the queue.

3. Queue browser

To enhance the observability of your integration landscape while running in the current generation architecture, we have added a new feature to our Manage phase called the "Queue browser." You can access this functionality via the "Explore" menu in Manage. Then, with the help of the queue browser, you can browse your queue as the name suggests.

To do so, we offer two options within this functionality. First, we have the Explore function, and we have the Wiretap function. When selecting a queue and opting for the Explore option, you get a live view of the current data in the queue. Then, when choosing the Wiretap functionality, you automatically wiretap your queue and are presented with copies (on a particular queue) of your actual message that passes through the queue from the moment you press the Wiretap button.

190-release-blog--queue-browser-overview.png

After selecting the queue and choosing the option, eMagiz will show you the list of messages (oldest first) that are currently on the queue (Explore option) or that have passed the queue since the moment you activate the option (Wiretap option). For each message, you have various options at your disposal.

  • Delete the message from the queue (Explore option)
    • This means throwing away live data, which can be helpful in a test or acceptance environment where you inadvertently put many messages on a queue.
  • Clear message from the wiretap queue (Wiretap option)
    • Once you are done with the analysis of a specific message in the wiretap functionality, you can clear it from the overview, so it does not clutter the view anymore
  • Refresh messages list (both options)
    • By pressing this button, you can refresh the list of messages displayed to you. Note that the list is sorted in such a way that the oldest messages are shown first
  • Save as test message
    • By pressing this button, you can save the message and use it in our flow testing functionality in Create. Note that we link the message to the corresponding flow if we can. Should we not be able to do so, we link the message to your model so you can still use it in the flow testing functionality.
  • Download
    • By pressing this button, you can download the message and use it outside of the tooling should that be needed.

190-release-blog--queue-browser-explore-overview.png

190-release-blog--queue-browser-wiretap-overview.png

Information
  • The following restrictions apply to this functionality:
    • Message payloads above 100KB are not shown in the queue browser as they constitute a "large message."
    • The wiretap functionality works for five minutes, during which you can use the refresh button to see new messages coming in.
      • After five minutes, the wiretap functionality will be shut down automatically underwater.
      • To see new messages after five minutes, you must access the wiretap functionality from scratch.

4. Key takeaways

  • The queue browser provides a live view of data within a queue.
  • You can use the wiretap functionality to monitor all future messages passing through a queue for a ten minute window.
  • Large message payloads over 100KB are not displayed in the queue browser.
  • The queue browser allows you to delete individual or all messages from a queue.

5. Suggested Additional Readings

If you are interested in this topic and want more information, please read the help text provided by eMagiz and see the following links: