Wiki source code of Message Redelivery in Manage
Version 10.1 by Erik Bakker on 2023/01/26 10:54
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | {{container}} | ||
2 | {{container layoutStyle="columns"}} | ||
3 | ((( | ||
4 | {{warning}} | ||
5 | Please note that this microlearning is for the new monitoring stack only. | ||
6 | {{/warning}} | ||
7 | |||
8 | In this microlearning, we will learn how you can view the messages that are currently waiting for message redelivery. On top of that, we will learn how you can perform actions on these messages. The primary step we will be focusing on is the redelivery of the message itself. | ||
9 | |||
10 | Should you have any questions, please get in touch with academy@emagiz.com. | ||
11 | |||
12 | == 1. Prerequisites== | ||
13 | * Basic knowledge of the eMagiz platform | ||
14 | |||
15 | == 2. Key concepts== | ||
16 | This microlearning is about redelivering messages from the message redelivery overview in Manage. | ||
17 | |||
18 | * The message redelivery overview shows the following: | ||
19 | ** The queue on which the error occurred. | ||
20 | ** The payload of the message as it arrived on this queue | ||
21 | ** The header information of the message as it arrived on this queue | ||
22 | ** Metadata about the message | ||
23 | * Via the "Show error message" button you can see the accompanying error for a period of four weeks | ||
24 | * With the help of the "Retry" button you can redeliver a specific message | ||
25 | * With the help of the "Delete message" button you can remove a specific message | ||
26 | * With the help of the "Retry all" button you can redeliver all messages | ||
27 | * With the help of the "Delete all" button you can remove all messages waiting to be redelivered | ||
28 | * With the help of the "Save as test message" button you can save the test message and link it to the flow in which error occurred. | ||
29 | * You can access this overview in two ways: | ||
30 | ** Via Manage -> Explore -> Redelivery | ||
31 | ** Via Manage -> Dashboard -> Select Flow -> Select Error -> "Redelivery" button | ||
32 | |||
33 | == 3. Message Redelivery in Manage == | ||
34 | |||
35 | In this microlearning, we will learn how you can view the messages that are currently waiting for message redelivery. On top of that, we will learn how you can perform actions on these messages. The primary step we will be focusing on is the redelivery of the message itself. | ||
36 | |||
37 | The message redelivery overview can be found in the Manage phase of eMagiz. Within Manage you can navigate to Error Message -> Message Redelivery to access the overview. | ||
38 | |||
39 | [[image:Main.Images.Microlearning.WebHome@intermediate-message-redelivery-redelivery-in-manage--message-redelivery-overview-empty.png]] | ||
40 | |||
41 | Once the overview contains messages it will look something as follows. For each message we have a timestamp and two IDs. | ||
42 | |||
43 | [[image:Main.Images.Microlearning.WebHome@intermediate-message-redelivery-redelivery-in-manage--message-redelivery-overview-filled-in.png]] | ||
44 | |||
45 | By selecting a specific message and pressing the Details button eMagiz will search for the accompanying error message from the error message dashboard. If eMagiz can find the accompanying error message eMagiz will show you the error message details. | ||
46 | |||
47 | [[image:Main.Images.Microlearning.WebHome@intermediate-message-redelivery-redelivery-in-manage--error-message-details.png]] | ||
48 | |||
49 | Note that there is not always an accompanying error message to be found. In those cases eMagiz will show you an empty error messages pop-up. | ||
50 | |||
51 | === 3.1 Redeliver Message(s) === | ||
52 | |||
53 | When you want to redeliver a message you simply select the message and press the button Redeliver. In case all errors originate from the same cause and the cause is resolved you could opt for the option "Redeliver All". This will redeliver all messages at once. | ||
54 | |||
55 | [[image:Main.Images.Microlearning.WebHome@intermediate-message-redelivery-redelivery-in-manage--redeliver-options.png]] | ||
56 | |||
57 | Note that when the message could not be redelivered after you press the redeliver button the old message will disappear from the screen and a new message corresponding to the new error will appear again in your list. | ||
58 | |||
59 | === 3.2 Remove Message(s)=== | ||
60 | |||
61 | When you determine that it is not relevant anymore to redeliver a certain message you can have the option to remove a message by selecting it and pressing the button "Remove". On top of that you have the option to "Remove All". This will remove all messages at once. | ||
62 | |||
63 | [[image:Main.Images.Microlearning.WebHome@intermediate-message-redelivery-redelivery-in-manage--remove-options.png]] | ||
64 | |||
65 | == 4. Assignment == | ||
66 | |||
67 | As this is a feature flagged functionality, no assignment will be associated with this microlearning. | ||
68 | |||
69 | == 5. Key takeaways== | ||
70 | |||
71 | * The message redelivery overview shows the following: | ||
72 | ** The queue on which the error occurred. | ||
73 | ** The payload of the message as it arrived on this queue | ||
74 | ** The header information of the message as it arrived on this queue | ||
75 | ** Metadata about the message | ||
76 | * Via the "Show error message" button you can see the accompanying error for a period of four weeks | ||
77 | * With the help of the "Retry" button you can redeliver a specific message | ||
78 | * With the help of the "Delete message" button you can remove a specific message | ||
79 | * With the help of the "Retry all" button you can redeliver all messages | ||
80 | * With the help of the "Delete all" button you can remove all messages waiting to be redelivered | ||
81 | * With the help of the "Save as test message" button you can save the test message and link it to the flow in which error occurred. | ||
82 | * You can access this overview in two ways: | ||
83 | ** Via Manage -> Explore -> Redelivery | ||
84 | ** Via Manage -> Dashboard -> Select Flow -> Select Error -> "Redelivery" button | ||
85 | |||
86 | == 6. Suggested Additional Readings == | ||
87 | |||
88 | There are no suggested additional readings on this topic. | ||
89 | |||
90 | == 7. Silent demonstration video == | ||
91 | |||
92 | This video demonstrates how you could have handled the assignment and gives you some context on what you have just learned. | ||
93 | |||
94 | {{video attachment="intermediate-message-redelivery-redelivery-in-manage.mp4" reference="Main.Videos.Microlearning.WebHome"/}}))) | ||
95 | ((({{toc/}}))){{/container}} | ||
96 | {{/container}} |