Skip to Content

Changes for page Introduction

Last modified by Erik Bakker on 2024/09/03 09:57
From version 1.1
edited by Eva Torken
on 2024/02/06 10:09
Change comment: There is no comment for this version
To version 2.1
edited by Erik Bakker
on 2024/02/09 08:03
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.etorken
1 +XWiki.ebakker
Content
... ... @@ -1,0 +1,47 @@
1 +{{container}}
2 +{{container layoutStyle="columns"}}
3 +(((
4 +This document will use the actual root cause analysis information to make a generic view that can be used if you run into the same or similar problem. Finally, the document will describe the situation, the problem, the analysis, and the result.
5 +
6 +Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]].
7 +
8 +== 1. Situation ==
9 +
10 +Sometimes, a ticket suggests that something on the flow level might not work as expected and warrants further investigation. In these situations, executing various checks in the Design, Create, and Deploy phases of eMagin is good for zooming in on the problem. This entry will look at a generic approach to this and various situations we have encountered in the past few years.
11 +
12 +== 2. Problem ==
13 +
14 +A suspected configuration problem on the flow level needs to be analyzed generically.
15 +
16 +== 3. Analysis ==
17 +
18 +=== 3.1 Reproduction ===
19 +
20 +First, you should check the assumptions of the person coming to you with a ticket. This is for both the Create and the Deploy phase of eMagiz. In Deploy, you check which version of a flow is running and whether this matches the client's expectations. Once you have established the correct flow version, it could happen that what is running is not what a user expected. The first step is to eliminate this mismatch.
21 +
22 +If the flow version is as expected, we can check the [[properties>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.crashcourse-platform-deploy-execute-deployment-plan-gen3.WebHome||target="blank"]] to see whether we see any changes. In this situation, always verify whether the user deployed the flow **after** the property value was changed.
23 +
24 +Thirdly, we zoom into the Manage phase to gather related information in the form of error messages or logging that help us identify at what place in the integration the message has [[exited>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.crashcourse-platform-manage-determining-origin-of-error-message||target="blank"]] the process. Once we have that, we can determine the [[cause>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.Active Monitoring.intermediate-active-monitoring-determining-cause-of-error-message||target="blank"]] of the error message better. If there is no indication in the Error messages where the message broke down, it is wise to check the log entries and [[queue statistics>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Messaging.crashcourse-messaging-interpreting-queue-statistics-gen3||target="blank"]] for more information.
25 +
26 +=== 3.2 Analysis ===
27 +
28 +You can analyze most flow configuration problems in eMagiz with the above steps. The list below indicates various cases where part of the flow was misconfigured.
29 +
30 +For more specific cases, please check out the following:
31 +
32 +* [[Incorrect property configuration>>doc:Main.eMagiz Support.RCA Knowledge Base.Configuration Issues.rca-knowledgebase-incorrect-property-configuration||target="blank"]]
33 +* [[Incorrect queue configuration>>doc:Main.eMagiz Support.RCA Knowledge Base.Configuration Issues.rca-knowledgebase-incorrect-queue-configuration.WebHome||target="blank"]]
34 +* [[Incorrect groovy configuration>>doc:Main.eMagiz Support.RCA Knowledge Base.Configuration Issues.rca-knowledgebase-incorrect-groovy-configuration.WebHome||target="blank"]]
35 +* [[FTP Configuration>>doc:Main.eMagiz Support.RCA Knowledge Base.Configuration Issues.rca-knowledgebase-ftp-configuration.WebHome||target="blank"]]
36 +* [[Design runtime changes after Create>>doc:Main.eMagiz Support.RCA Knowledge Base.Runtime Issues.rca-knowledgebase-design-runtime-changes-of-created-runtimes.WebHome||target="blank"]]
37 +
38 +== 4. Result ==
39 +
40 +Once the flow configuration problem is identified, you can work towards analyzing and fixing the problem.
41 +)))
42 +
43 +(((
44 +{{toc/}}
45 +)))
46 +{{/container}}
47 +{{/container}}