Skip to Content

Changes for page Topic Browser

Last modified by Erik Bakker on 2025/09/15 10:00
From version 25.1
edited by Erik Bakker
on 2025/09/15 09:54
Change comment: There is no comment for this version
To version 18.5
edited by Danniar Firdausy
on 2024/09/04 15:40
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -Topic Browser
1 +Queue browser
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ebakker
1 +XWiki.dfirdausy
Content
... ... @@ -1,6 +1,6 @@
1 1  {{container}}{{container layoutStyle="columns"}}(((
2 2  
3 -In this microlearning, we will focus on the topic browser functionality. This powerful new feature within our [[current generation architecture>>doc:Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation3||target="blank"]] provides visibility into the data flowing through your system, offering the ability to monitor, analyze, and manage messages that utilize the [[event streaming>>doc:Main.eMagiz Academy.Fundamentals.fundamental-event-streaming-introduction||target="blank"]] functionality. Let's dive into the key concepts and features of this exciting addition!
3 +In this microlearning, we will focus on the queue browser functionality. This new feature within our current generation runtime architecture allows you to view data flowing through your system. On top of that, it enables you to wiretap information for analysis purposes and even delete messages that should not be in a specific queue.
4 4  
5 5  Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
6 6  
... ... @@ -11,54 +11,59 @@
11 11  
12 12  == 2. Key concepts ==
13 13  
14 -This microlearning centers around the topic browser.
14 +This microlearning centers around the queue browser.
15 15  
16 -* The topic browser can be used to view data on the topic.
16 +* The queue browser can be used to view data on the queue
17 +* The queue browser can be used to wiretap a queue to see all future messages (in the next five minutes)
18 +* Message payloads above 100KB are not shown
19 +* The queue browser allows you to delete one (or all) message(s) from the queue
17 17  
18 -== 3. Topic browser ==
21 +== 3. Queue browser ==
19 19  
20 -To enhance the observability of your integration landscape while running in the [[current generation architecture>>doc:Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation3||target="blank"]], we have added a new feature to our Manage phase called the "Topic browser." You can access this functionality via the "Explore" menu in Manage. Then, with the help of the topic browser, you can browse your topics as the name suggests.
23 +To enhance the observability of your integration landscape while running in the 3rd generation runtime 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.
21 21  
22 -To do so, we show a list of topics belonging to your model you can explore.
25 +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.
23 23  
24 -[[image:Main.Images.Release Blog.WebHome@intermediate-testing-in-emagiz-topic-browser--overview.png]]
25 -
26 -Per topic, you can zoom in on the partitions of each topic to check out the messages.
27 +[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-overview.png]]
27 27  
28 -[[image:Main.Images.Release Blog.WebHome@intermediate-testing-in-emagiz-topic-browser--topic-selected.png]]
29 +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.
29 29  
30 -After selecting the topic and choosing the partition, eMagiz will show you the list of messages (latest first) that are currently on the topic. These messages, including headers and envelope, can be viewed by clicking on the message.
31 -
32 -[[image:Main.Images.Release Blog.WebHome@intermediate-testing-in-emagiz-topic-browser--view-messages.png]]
33 -
34 -Apart from that we over the following options.
35 -
31 +* Delete the message from the queue (Explore option)
32 +** 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.
33 +* Clear message from the wiretap queue (Wiretap option)
34 +** 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
35 +* Refresh messages list (both options)
36 +** 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
36 36  * Save as test message
37 37  ** 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.
38 38  * Download
39 39  ** By pressing this button, you can download the message and use it outside of the tooling should that be needed.
40 40  
41 -[[image:Main.Images.Release Blog.WebHome@intermediate-testing-in-emagiz-topic-browser--topic-explorer-options.png]]
42 +[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-explore-overview.png]]
42 42  
44 +[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-wiretap-overview.png]]
45 +
43 43  {{info}}
44 -* The following restrictions apply to this functionality:
45 - ** Messages remain visible in the topic explorer as long as they are not yet deleted based on the retention policy (default of two days)
46 - ** To check for new messages please switch between pages in the message overview or go back to the topic overview and open the partition again.
47 +The following restrictions apply to this functionality:
48 + * Message payloads above 100KB are not shown in the queue browser as they constitute a "large message."
49 + * The wiretap functionality works for five minutes, during which you can use the refresh button to see new messages coming in.
50 + ** After five minutes, the wiretap functionality will be shut down automatically underwater.
51 + ** To see new messages after five minutes, you must access the wiretap functionality from scratch.
47 47  {{/info}}
48 48  
49 49  == 4. Key takeaways ==
50 50  
51 -* The topic browser provides a live view of data within a topic.
52 -* Messages remain visible in the topic explorer as long as they are not yet deleted based on the retention policy (default of two days)
56 +* The queue browser can be used to view data on the queue
57 +* The queue browser can be used to wiretap a queue to see all future messages (in the next five minutes)
58 +* Message payloads in excess of 100KB are not shown
59 +* The queue browser allows you to delete one (or all) message(s) from the queue
53 53  
54 54  == 5. Suggested Additional Readings ==
55 55  
56 -If you are interested in this topic and want more information, please read the help text provided by eMagiz and see the following links:
63 +If you are interested in this topic and want more information on it please read the following links:
57 57  
58 58  * [[Fundamentals (Navigation)>>doc:Main.eMagiz Academy.Fundamentals.WebHome||target="blank"]]
59 59  ** [[Traceability in eMagiz (Explanation)>>Main.eMagiz Academy.Fundamentals.fundamental-traceability-in-emagiz||target="blank"]]
60 -** [[Current Generation Architecture>>doc:Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation3||target="blank"]]
61 -** [[Event Streaming>>doc:Main.eMagiz Academy.Fundamentals.fundamental-event-streaming-introduction||target="blank"]]
62 -* [[Topic Browser (Search Results)>>url:https://docs.emagiz.com/bin/view/Main/Search?sort=score&sortOrder=desc&highlight=true&facet=true&r=1&f_space_facet=0%2FMain.&l_space_facet=10&f_type=DOCUMENT&f_locale=en&f_locale=&f_locale=en&text=%22topic+browser%22||target="blank"]]
67 +* [[Queue Browser (Search Results)>>url:https://docs.emagiz.com/bin/view/Main/Search?sort=score&sortOrder=desc&highlight=true&facet=true&r=1&f_space_facet=0%2FMain.&l_space_facet=10&f_type=DOCUMENT&f_locale=en&f_locale=&f_locale=en&text=%22queue+browser%22||target="blank"]]
63 63  
64 64  )))((({{toc/}}))){{/container}}{{/container}}