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,11 +1,7 @@
1	1	{{container}}{{container layoutStyle="columns"}}(((
2	2
3		-{{warning}}
4		-Please note that this microlearning is for the new monitoring stack only.
5		-{{/warning}}
	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!
6	6
7		-In this microlearning, we will focus on the queue browser functionality. This new feature within our 3rd generation runtime 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.
8		-
9	9	Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
10	10
11	11	== 1. Prerequisites ==
...	...	@@ -15,56 +15,54 @@
15	15
16	16	== 2. Key concepts ==
17	17
18		-This microlearning centers around the queue browser.
	14	+This microlearning centers around the topic browser.
19	19
20		-* The queue browser can be used to view data on the queue
21		-* The queue browser can be used to wiretap a queue to see all future messages (in the next five minutes)
22		-* Message payloads above 100KB are not shown
23		-* 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.
24	24
25		-== 3. Queue browser ==
	18	+== 3. Topic browser ==
26	26
27		-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.
	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.
28	28
29		-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.
30	30
31		-[[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.
32	32
33		-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]]
34	34
35		-* Delete the message from the queue (Explore option)
36		-** 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.
37		-* Clear message from the wiretap queue (Wiretap option)
38		-** 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
39		-* Refresh messages list (both options)
40		-** 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	+
41	41	* Save as test message
42	42	** 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.
43	43	* Download
44	44	** By pressing this button, you can download the message and use it outside of the tooling should that be needed.
45	45
46		-[[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]]
47	47
48		-[[image:Main.Images.Release Blog.WebHome@190-release-blog--queue-browser-wiretap-overview.png]]
49		-
50	50	{{info}}
51		-The following restrictions apply to this functionality:
52		- * Message payloads above 100KB are not shown in the queue browser as they constitute a "large message."
53		- * The wiretap functionality works for five minutes, during which you can use the refresh button to see new messages coming in.
54		- ** After five minutes, the wiretap functionality will be shut down automatically underwater.
55		- ** To see new messages after five minutes, you must access the wiretap functionality from scratch.
	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 refresh the page you need to go back to the topic overview and open the partition again.
56	56	{{/info}}
57	57
58	58	== 4. Key takeaways ==
59	59
60		-* The queue browser can be used to view data on the queue
61		-* The queue browser can be used to wiretap a queue to see all future messages (in the next five minutes)
62		-* Message payloads in excess of 100KB are not shown
63		-* The queue browser allows you to delete one (or all) message(s) from the 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)
64	64
65	65	== 5. Suggested Additional Readings ==
66	66
67		-If you are interested in this topic and want more information, please read the help texts in eMagiz.
	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:
68	68
	58	+* [[Fundamentals (Navigation)>>doc:Main.eMagiz Academy.Fundamentals.WebHome||target="blank"]]
	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"]]
69	69
70	70	)))((({{toc/}}))){{/container}}{{/container}}