Changes for page Topic Browser

Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Title

...	...	@@ -1,1 +1,1 @@
1		-Queue browser
	1	+intermediate-testing-in-emagiz-topic-browser

Content

...	...	@@ -1,6 +1,6 @@
1	1	{{container}}{{container layoutStyle="columns"}}(((
2	2
3		-In this microlearning, we will focus on the queue 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. 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!
	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||target="blank"]] functionality. Let's dive into the key concepts and features of this exciting addition!
4	4
5	5	Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
6	6
...	...	@@ -11,52 +11,45 @@
11	11
12	12	== 2. Key concepts ==
13	13
14		-This microlearning centers around the queue browser.
	14	+This microlearning centers around the topic browser.
15	15
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 ten 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.
	16	+* The topic browser can be used to view data on the topic.
20	20
21		-== 3. Queue browser ==
	18	+== 3. Topic browser ==
22	22
23		-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 "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.
	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.
24	24
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.
	22	+To do so, we show a list of topics belonging to your model you can explore.
26	26
27		-[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-overview.png]]
	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.
28	28
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.
	28	+[[image:Main.Images.Release Blog.WebHome@intermediate-testing-in-emagiz-topic-browser--topic-selected.png]]
30	30
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
	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	+On top of that we over the following options.
	35	+
37	37	* Save as test message
38	38	** 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.
39	39	* Download
40	40	** By pressing this button, you can download the message and use it outside of the tooling should that be needed.
41	41
42		-[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-explore-overview.png]]
	41	+[[image:Main.Images.Release Blog.WebHome@intermediate-testing-in-emagiz-topic-browser--topic-explorer-options.png]]
43	43
44		-[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-wiretap-overview.png]]
45		-
46	46	{{info}}
47	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.
	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 refresh the page you need to go back to the topic overview and open the partition again.
52	52	{{/info}}
53	53
54	54	== 4. Key takeaways ==
55	55
56		-* The queue browser provides a live view of data within a queue.
57		-* You can use the wiretap functionality to monitor all future messages passing through a queue for a ten minute window.
58		-* Large message payloads over 100KB are not displayed in the queue browser.
59		-* The queue browser allows you to delete individual or all messages from a queue.
	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)
60	60
61	61	== 5. Suggested Additional Readings ==
62	62
...	...	@@ -65,9 +65,7 @@
65	65	* [[Fundamentals (Navigation)>>doc:Main.eMagiz Academy.Fundamentals.WebHome||target="blank"]]
66	66	** [[Traceability in eMagiz (Explanation)>>Main.eMagiz Academy.Fundamentals.fundamental-traceability-in-emagiz||target="blank"]]
67	67	** [[Current Generation Architecture>>doc:Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation3||target="blank"]]
68		-* [[Advanced Level (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Advanced Level.WebHome||target="blank"]]
69		-** [[Testing in eMagiz (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Advanced Level.Testing in eMagiz.WebHome||target="blank"]]
70		-*** [[eMagiz Debugger (Explanation)>>Main.eMagiz Academy.Microlearnings.Advanced Level.Testing in eMagiz.advanced-testing-in-emagiz-debugger-gen3||target="blank"]]
71		-* [[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"]]
	61	+** [[Event Streaming>>doc:Main.eMagiz Academy.Fundamentals.fundamental-event-streaming||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"]]
72	72
73	73	)))((({{toc/}}))){{/container}}{{/container}}