Changes for page Dynamic Alerting
Last modified by Danniar Firdausy on 2024/11/19 11:08
From version 39.21
edited by Danniar Firdausy
on 2024/07/29 15:20
on 2024/07/29 15:20
Change comment:
There is no comment for this version
To version 37.1
edited by Erik Bakker
on 2023/05/27 13:58
on 2023/05/27 13:58
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. dfirdausy1 +XWiki.ebakker - Content
-
... ... @@ -9,11 +9,9 @@ 9 9 10 10 == 2. Key concepts == 11 11 12 -This microlearning centers onconfiguring dynamic alerting based on triggers you can define as a user.12 +This microlearning centers configuring dynamic alerting based on triggers you can define as a user. 13 13 By defining, we mean: Specifying based on what triggers an alert needs to be raised. 14 14 15 -{{html}} 16 -<!-- 17 17 * There are five trigger options 18 18 ** Error message 19 19 ** Log message ... ... @@ -20,33 +20,25 @@ 20 20 ** Queue consumers 21 21 ** Messages in queue 22 22 ** Queue throughput 23 ---> 24 -{{/html}} 25 -* There are four trigger options 26 -** Error message 27 -** Log message 28 -** Messages added to topic 29 -** Topic consumer messages behind 30 30 * On the trigger level, the recipients are defined 31 31 * On the trigger level, the congestion control is defined 32 32 33 33 == 3. Dynamic Alerting == 34 34 35 -To enhance the observability of your integration landscape while running in the currentgeneration runtime architecture, weprovide afunctionalityin the Manage phase called "Dynamic Alerts." You can access this functionality via the "Alerting" menu in Manage. Then, with the help of the "Trigger" overview, you can view all triggers in your environment.Fromthereon, you can navigateto the "Other"tab.26 +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 "Dynamic Alerts." You can access this functionality via the "Alerting" menu in Manage. Then, with the help of the "Trigger" overview, you can view all triggers in your environment. On the top of the list, you will see all [["static" alerts>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.crashcourse-platform-manage-alerting-gen3||target="blank"]] as defined by eMagiz below that you will see all "dynamic" alerts that you and your fellow team members (with sufficient rights) can view, edit and delete. 36 36 37 - Here,on the top ofthelist, you will see all [["static" alerts>>doc:Main.eMagizAcademy.Microlearnings.Crash Course.Crash Course Platform.crashcourse-platform-manage-alerting-gen3||target="blank"]]that are defined by eMagiz (alerts that are non-editable)and below that (alertsthat areditable), you will see all "dynamic"alerts thatyou and your fellow team members(with sufficient rights) can view, edit and delete.28 +We offer alerting on seven types. 38 38 39 -In this page, we offer alerting on four types. 40 - 41 41 * Error message 42 42 * Log message 32 +* Queue consumers 33 +* Messages in queue 34 +* Queue throughput 43 43 * Messages added to topic 44 44 * Topic consumer messages behind 45 45 46 46 [[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-trigger-options.png]] 47 47 48 -{{info}}As of the recent eMagiz release, we have moved the configurations for queue triggers (i.e., Queue consumers, Messages in queue, Queue throughput) to the "Queues" tab. Please refer to the [[Customize Queue alerting>>doc:Main.eMagiz Academy.Microlearnings.Novice.Alerting.novice-alerting-customize-queue-alerting.WebHome||target="blank"]] microlearning to learn more on how to customize the triggers or the default values for these queues.{{/info}} 49 - 50 50 First, we will discuss the configuration of each trigger type. Subsequently, we will discuss defining which recipients will be notified and how to alter the default congestion control settings (as this is the same for each trigger type). 51 51 52 52 === 3.1 Error message === ... ... @@ -65,57 +65,57 @@ 65 65 66 66 [[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-log-message-configuration.png]] 67 67 68 -=== 3.3 Messagesadded to topic===58 +=== 3.3 Queue consumers === 69 69 70 - For thiscategory, you can add additional "dynamic" alerts.Thesealertsonly trigger when themessages added to one or more topic is less than X messages per Y minutes. On top of the number ofmessages (X) and the timeframe (Y), you can define whether to validate this on a specific topicoralltopics.Notethatthe defaultconfigurationisthat the alert appliestoall topics.60 +On top of the "static" alert that is autogenerated by eMagiz on Queue consumers, you can add additional "dynamic" alerts that only trigger when the number of consumers on a (specific) set of queues is below a certain threshold. 71 71 72 - [[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-messages-added-to-topic-all-topics.png]]62 +To define the trigger, determine the threshold you want to check (i.e., 2). Subsequently, specify whether on which queues (or all queues) you want eMagiz to check for this condition. No further action is needed if you want to check on all queues. 73 73 74 - You can uncheck the checkbox to check onspecific (set of) topic(s). As aresult, the"Add"and "Remove" buttonsare displayedbyeMagiz, through whichyou canddandremovetopics tothetrigger.64 +[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-queue-consumers-all-queues.png]] 75 75 76 - {{info}}Thisprocessofaddingandremovingspecific topicsworksidentically, as explained inthesectiononQueueconsumers.[[Queueconsumers.>>||anchor="H3.3Queueconsumers"]]{{/info}}66 +You can uncheck the checkbox if you want to check on a specific (set of) queue(s). As a result, the "Add" and "Remove" buttons are displayed by eMagiz, through which you can add and remove queues to the trigger. 77 77 78 - For this trigger,additionalcriteria canbeconfigured that allow you to define when eMagiz needs to validatehis configuration (i.e., Occurence). With thehelp of thisconfiguration option, you canspecify when the trigger needs to be evaluated.An example could be only on Monday between 04:00 AM and 05:00 AM.68 +[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-queue-consumers-specific-queues.png]] 79 79 80 - ===3.4Topic consumer lag===70 +When you press the "Add" button, a new pop-up will appear through which you can select the queues for which you want the trigger to be activated. In this pop-up, you can choose one (or more) queues and press the "Select" button to add them to the trigger. 81 81 82 - For this category, you can add additional "dynamic"alerts.These alerts only trigger when one (or more)consumergroupslag by X messages onone(ormore) topic(s). Notethat the default configurationis thatyou,asauser, needto specifyfor which topic(s) thealertapplies, asconsumers' behavior canvary widely.72 +[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-queue-consumers-queue-selection.png]] 83 83 84 -{{info}} Thisprocessofaddingand removingspecifictopicsworksidentically,asexplainedin the sectiononQueueconsumers.[[Queueconsumers.>>||anchor="H3.3Queueconsumers"]]{{/info}}74 +{{info}}Note that when you want to select multiple queues at once, you cannot press "Enter" to Save your selection. In this case, you need to press the "Select" button to save your choice.{{/info}} 85 85 86 -Once filledin,thesolution should looksimilarasfollows.76 +Once you have selected the queue(s) and pressed "Select," eMagiz will close the pop-up and add the queues to the trigger. 87 87 88 -[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert- topic-consumer-lag-selected-topics.png]]78 +[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-queue-consumers-queue-selection-result.png]] 89 89 90 -=== 3. 8Recipient(s)configuration ===80 +=== 3.4 Messages in queue === 91 91 92 - Youcanselect yourrecipientswhen youswitchfromthe"Trigger"to the"Output"tab.In thisoverview,you can choosebotheMagizusersandexternalrecipients.82 +On top of the "static" alert that is autogenerated by eMagiz on Messages in a queue, you can add additional "dynamic" alerts that only trigger when a queue holds more than X messages. Logically, the X can be determined by the user. Subsequently, define whether on which queues (or all queues) you want eMagiz to check for this condition. No further action is needed if you want to check on all queues. 93 93 94 -[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert- recipient-config.png]]84 +[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-messages-in-queue-all-queues.png]] 95 95 96 - {{info}}Note thatwhenyoudefinemultipleexternalrecipients,youneedtoseparate eachemaildresswithacommatomakeitwork.{{/info}}86 +You can uncheck the checkbox if you want to check on a specific (set of) queue(s). As a result, the "Add" and "Remove" buttons are displayed by eMagiz, through which you can add and remove queues to the trigger. 97 97 98 - === 3.9 Congestioncontrolconfiguration===88 +[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-messages-in-queue-specific-queues.png]] 99 99 100 - In thesame"Output"tab,youcan alsodefinethe congestioncontrolconfiguration.Thedefaultconfigurationis thatcongestioncontrolwillbe activatedoncemorethantenalertsaretriggeredinthelasttenminutes.So shouldyouwant toreducethis number,youcan do sohere.90 +When you press the "Add" button, a new pop-up will appear through which you can select the queues for which you want the trigger to be activated. In this pop-up, you can choose one (or more) queues and press the "Select" button to add them to the trigger. 101 101 102 -[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-con gestion-control-config.png]]92 +[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-queue-consumers-queue-selection.png]] 103 103 104 -{{ warning}}Note that we adviseonlyreducingthenumberunderthecongestioncontrol ifthe tendefaultis toohigh. Wedo**not** advisedeactivating the congestioncontrolasthis can causeanexplosioninthenumberofreceivednotifications.{{/warning}}94 +{{info}}Note that when you want to select multiple queues at once, you cannot press "Enter" to Save your selection. In this case, you need to press the "Select" button to save your choice.{{/info}} 105 105 106 -{{html}} 107 -<!-- 108 -=== 3.3 Queue consumers === 96 +Once you have selected the queue(s) and pressed "Select," eMagiz will close the pop-up and add the queues to the trigger. 109 109 110 - On top of the "static"alert thatisautogenerated by eMagiz onQueue consumers, youcan add additional "dynamic"alerts that onlytriggerwhenthe number of consumersona(specific)set ofqueuesis below a certainthreshold.98 +[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-messages-in-queue-queue-selection-result.png]] 111 111 112 - Todefine the trigger, determine the threshold you want to check (i.e.,2). Subsequently,specify whethern which queues (or all queues) you want eMagiz to check for this condition. No furtheraction is needed if you want to check on all queues.100 +=== 3.5 Queue througput === 113 113 114 - [[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-queue-consumers-all-queues.png]]102 +For this category you can add additional "dynamic" alerts that only trigger when the throughput on one or more queues is more or less than X messages per Y minutes. Subsequently, define whether on which queues (or all queues) you want eMagiz to check for this condition. No further action is needed if you want to check on all queues. 115 115 104 +[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-queue-throughput-all-queues.png]] 105 + 116 116 You can uncheck the checkbox if you want to check on a specific (set of) queue(s). As a result, the "Add" and "Remove" buttons are displayed by eMagiz, through which you can add and remove queues to the trigger. 117 117 118 -[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-queue- consumers-specific-queues.png]]108 +[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-queue-throughput-specific-queues.png]] 119 119 120 120 When you press the "Add" button, a new pop-up will appear through which you can select the queues for which you want the trigger to be activated. In this pop-up, you can choose one (or more) queues and press the "Select" button to add them to the trigger. 121 121 ... ... @@ -125,38 +125,50 @@ 125 125 126 126 Once you have selected the queue(s) and pressed "Select," eMagiz will close the pop-up and add the queues to the trigger. 127 127 128 -[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-queue- consumers-queue-selection-result.png]]118 +[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-queue-throughput-queue-selection-result.png]] 129 129 130 - ===3.4Messages inqueue===120 +For this trigger, additional criteria can be configured that allow you to define when eMagiz needs to validate this configuration (i.e., Occurence). With the help of this configuration option, you can specify when the trigger needs to be evaluated. An example could be only on Monday between 04:00 AM and 05:00 AM. 131 131 132 - On top of the "static"alert thatisautogenerated by eMagizon Messagesina queue, youcan add additional "dynamic"alerts that only trigger whena queue holds more thanX messages. Logically, theX can be determined bytheuser. Subsequently, define whethern which queues (or all queues) you wanteMagiz toheck for this condition. No further actionis needed if you want tocheckonall queues.122 +[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-queue-throughput-occurence-config.png]] 133 133 134 - [[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-messages-in-queue-all-queues.png]]124 +=== 3.6 Messages added to topic === 135 135 136 - You canuncheckthecheckboxifyouwant tocheckonaspecific(setof)queue(s). Asult,the"Add"and"Remove"buttonsaredisplayedbyeMagiz,throughwhichyou canaddandremovequeues tothetrigger.126 +For this category, you can add additional "dynamic" alerts. These alerts only trigger when the messages added to one or more topic is less than X messages per Y minutes. On top of the number of messages (X) and the timeframe (Y), you can define whether to validate this on a specific topic or all topics. Note that the default configuration is that the alert applies to all topics. 137 137 138 - {{info}}Thisprocess ofaddingand removing specific queues worksidentically, asexplainedinthe section on Queueconsumers.[[Queue consumers.>>||anchor="H3.3Queueconsumers"]]{{/info}}128 +[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-messages-added-to-topic-all-topics.png]] 139 139 140 - Once youhaveselectedthequeue(s) andpressed "Select," eMagiz willclose thepop-upandaddthequeues to the trigger.130 +You can uncheck the checkbox to check on a specific (set of) topic(s). As a result, the "Add" and "Remove" buttons are displayed by eMagiz, through which you can add and remove topics to the trigger. 141 141 142 - [[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-messages-in-queue-queue-selection-result.png]]132 +{{info}}This process of adding and removing specific topics works identically, as explained in the previous section on "Queue throughput." {{/info}} 143 143 144 - ===3.5Queue througput===134 +For this trigger, additional criteria can be configured that allow you to define when eMagiz needs to validate this configuration (i.e., Occurence). With the help of this configuration option, you can specify when the trigger needs to be evaluated. An example could be only on Monday between 04:00 AM and 05:00 AM. 145 145 146 - Forthiscategory you can add additional "dynamic"alerts thatonly trigger when the throughput on one ormorequeues is moreorless than X messagesper Y minutes. Subsequently, define whether on which queues (or all queues) you want eMagiz to check for this condition. No further action is needed if you want to check on all queues.136 +=== 3.7 Topic consumer lag === 147 147 148 - [[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-queue-throughput-all-queues.png]]138 +For this category, you can add additional "dynamic" alerts. These alerts only trigger when one (or more) consumer groups lag by X messages on one (or more) topic(s). Note that the default configuration is that you, as a user, need to specify for which topic(s) the alert applies, as consumers' behavior can vary widely. 149 149 150 - You canuncheckthecheckboxifyou wantto checkonaspecific(setf) queue(s).Asa result,the "Add"and "Remove" buttonsaredisplayedby eMagiz,throughwhich you canadd andremovequeuestothetrigger.140 +{{info}}This process of adding and removing specific topics works identically, as explained in the section on Queue consumers.[[Queue consumers.>>||anchor="H3.3Queueconsumers"]]{{/info}} 151 151 152 - {{info}}This processofadding and removing specific queues works identically, asexplained in the section on Queueconsumers.[[Queue consumers.>>||anchor="H3.3Queueconsumers"]]{{/info}}142 +Once filled in, the solution should look similar as follows. 153 153 154 - For this trigger,additionalcriteria canbeconfigured that allow you to define when eMagiz needs to validatehis configuration (i.e., Occurence). Withthe helpof thisconfiguration option, you canspecify whenthetrigger needstobe evaluated. An examplecould be only on Monday between 04:00 AM and 05:00 AM.144 +[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-topic-consumer-lag-selected-topics.png]] 155 155 156 -[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-queue-throughput-occurence-config.png]] 157 ---> 158 -{{/html}} 146 +=== 3.8 Recipient(s) configuration === 159 159 148 +You can select your recipients when you switch from the "Trigger" to the "Output" tab. In this overview, you can choose both eMagiz users and external recipients. 149 + 150 +[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-recipient-config.png]] 151 + 152 +{{info}}Note that when you define multiple external recipients, you need to separate each email address with a comma to make it work.{{/info}} 153 + 154 +=== 3.9 Congestion control configuration === 155 + 156 +In the same "Output" tab, you can also define the congestion control configuration. The default configuration is that congestion control will be activated once more than ten alerts are triggered in the last ten minutes. So should you want to reduce this number, you can do so here. 157 + 158 +[[image:Main.Images.Microlearning.WebHome@novice-alerting-dynamic-alerting--dynamic-alert-congestion-control-config.png]] 159 + 160 +{{warning}}Note that we advise only reducing the number under the congestion control if the ten default is too high. We do **not** advise deactivating the congestion control as this can cause an explosion in the number of received notifications.{{/warning}} 161 + 160 160 == 4. Key takeaways == 161 161 162 162 * There are seven trigger options