Wiki source code of Determining cause of log entry

Last modified by Erik Bakker on 2024/02/22 12:35

Hide last authors
Erik Bakker 1.1 1 {{container}}{{container layoutStyle="columns"}}(((
Erik Bakker 8.1 2 {{error}}
3 Note that the functionality mentioned in this microlearning will become obsolete when migrating to the 3rd generation runtime.
4 {{/error}}
5
Erik Bakker 4.1 6 When something goes wrong within the process, you want to determine what caused the error to be raised. In earlier microlearnings, we learned how to determine the cause of error messages. Now, we shift our focus to the log entries. In eMagiz, errors can show up in the dashboard and the log entries. For this microlearning, we will look at the log entries and see how we can use that information to look at the flow to determine what part of the flow is causing the error.
Erik Bakker 1.1 7
8 Should you have any questions, please get in touch with academy@emagiz.com.
9
10 == 1. Prerequisites ==
11 * Advanced knowledge of the eMagiz platform
Erik Bakker 4.1 12 * Errors in the log that can be analyzed
Erik Bakker 1.1 13
14 == 2. Key concepts ==
Erik Bakker 4.1 15 This microlearning centers around determining the cause of log entry
16 By determining the cause, we mean: Figuring out what was responsible for generating an error.
Erik Bakker 1.1 17
Erik Bakker 4.1 18 * The component that raises the error could differ from the component that causes the error
19 * A log entry error could be raised on runtime level or flow level but can be related to a specific part of the process
Erik Bakker 1.1 20
Erik Bakker 4.1 21 == 3. Determining the cause of log entry ==
Erik Bakker 1.1 22
Erik Bakker 4.1 23 When something goes wrong within the process, you want to determine what caused the error to be raised. In earlier microlearnings, we learned how to determine the cause of error messages. Now, we shift our focus to the log entries. In eMagiz, errors can show up in the dashboard and the log entries. For this microlearning, we will look at the log entries and see how we can use that information to look at the flow to determine what part of the flow is causing the error.
Erik Bakker 1.1 24
Erik Bakker 4.1 25 * The component that raises the error could differ from the component that causes the error
26 * A log entry error could be raised on runtime level or flow level but can be related to a specific part of the process
Erik Bakker 1.1 27
Erik Bakker 4.1 28 In eMagiz, you can find the log entries under Manage -> Log entries. Here you can focus your search by searching for a specific runtime. An example of an error that could be raised and shown in the log entries is any error introduced in the entry that causes the transaction to fail.
Erik Bakker 1.1 29
Erik Bakker 4.1 30 [[image:Main.Images.Microlearning.WebHome@advanced-active-monitoring-determining-cause-of-log-entry--example-error-log-entry.png]]
Erik Bakker 1.1 31
Erik Bakker 4.1 32 When you have found the log entry, it becomes time to read it to see whether you can interpret the problem. For example, in this case, we that a message has been rejected in a filter component. When we read on, we see the name of the specific filter component that is throwing the error.
Erik Bakker 1.1 33
Erik Bakker 4.1 34 [[image:Main.Images.Microlearning.WebHome@advanced-active-monitoring-determining-cause-of-log-entry--example-error-log-entry-identify-the-problem.png]]
Erik Bakker 1.1 35
Erik Bakker 4.1 36 Now that we know the component that raised the error, we can navigate to the flow in which this component is used. You can determine based on the naming, but the flow's name is also shown on the log entry if it is known.
Erik Bakker 1.1 37
Erik Bakker 4.1 38 [[image:Main.Images.Microlearning.WebHome@advanced-active-monitoring-determining-cause-of-log-entry--example-error-log-entry-find-flow.png]]
Erik Bakker 1.1 39
Erik Bakker 4.1 40 When we navigate to the flow that is raising the error in our example, we see that a filter is in the flow that checks before the message can be further processed by eMagiz.
Erik Bakker 1.1 41
Erik Bakker 4.1 42 [[image:Main.Images.Microlearning.WebHome@advanced-active-monitoring-determining-cause-of-log-entry--example-error-log-entry-analyze-flow.png]]
Erik Bakker 1.1 43
Erik Bakker 4.1 44 When we open the filter, we can see what check is done. By analyzing the check, we can determine whether the statement itself is faulty, a configuration error occurred, or whether input created earlier in the flow was the culprit in this case. For this example, we used an obvious error to make the problem clear to you. In real-life scenarios identifying the cause might take some additional work to determine the specific reason for your particular problem.
Erik Bakker 1.1 45
Erik Bakker 4.1 46 [[image:Main.Images.Microlearning.WebHome@advanced-active-monitoring-determining-cause-of-log-entry--current-faulty-check.png]]
Erik Bakker 1.1 47
Erik Bakker 9.1 48 == 4. Key takeaways ==
Erik Bakker 1.1 49
Erik Bakker 4.1 50 * The log entry shows which flow has raised the error
51 * You need to read the log entry to interpret on which component the error is raised
52 * With the information from the log entry, you can analyze the flow starting at the component that raised the error and move back in the process step by step
Erik Bakker 1.1 53
Erik Bakker 9.1 54 == 5. Suggested Additional Readings ==
Erik Bakker 1.1 55
Erik Bakker 9.1 56 If you are interested in this topic and want more information, please read the release notes provided by eMagiz.)))((({{toc/}}))){{/container}}{{/container}}