Skip to Content
Last modified by Danniar Firdausy on 2024/09/18 20:30
From version 9.1
edited by eMagiz
on 2022/06/02 12:38
Change comment: There is no comment for this version
To version 2.1
edited by eMagiz
on 2022/06/02 12:13
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,61 +1,95 @@
1 -{{container}}
2 -{{container layoutStyle="columns"}}
3 -(((
4 -= How to connect with the eMagiz SFTP Service =
1 +{{html wiki="true"}}
2 +<div class="ez-academy">
3 + <div class="ez-academy_body">
5 5  
6 -In this microlearning, we will provide short guide that will help eMagiz users how to connect to the eMagiz SFTP service. Allthough this is a regular SFTP service, there are some specific steps involved to allow an optimal configuration of the integration.
7 -
5 +<div class="doc">
6 +
7 +
8 +
9 += Determining the origin of log entries =
10 +
11 +In this microlearning, we will focus on how you can quickly and easily determine the origin of log entries. In other words, what caused the logging.
12 +
8 8  Should you have any questions, please contact academy@emagiz.com.
9 9  
10 -* Last update: June 2nd, 2022
15 +* Last update: July 22th, 2021
11 11  * Required reading time: 5 minutes
12 12  
13 13  == 1. Prerequisites ==
14 14  
15 15  * Basic knowledge of the eMagiz platform
16 -* Understanding of the way in which an SFTP file pickup or drop is configured in eMagiz
17 -* Reviewed microlearning :: TO ADD
18 -
19 -
21 +* Understanding of Monitoring concept
22 +* One or more log entries raised in the last two weeks within the context of your (Academy) project
23 +
20 20  == 2. Key concepts ==
21 -By the eMagiz SFTP, we mean: A specific SFTP offered by the eMagiz platform on which you can securely store and read messages. Considerations when connecting to the eMagiz SFTP
22 22  
23 -* Did you read the connect guide and made sure that all requirements are met?
24 -* Did you use the store component made available in the eMagiz store to set up the connection?
25 -* Did you verify that the indicator for temporary file name is set to false?
26 +This microlearning centers around determining the origin of log entries.
27 +By origin, in this context, we mean: Identifying which flow wrote an entry to the log that might be in need of analysis.
26 26  
29 +* Determining in which flow a log entry is raised can be done with the help of the Manage phase in eMagiz.
30 + * In the Manage phase you have an option called Monitoring. In this overview, you will see all logging that is relevant without your project.
31 +* This overview allows you to filter on various elements, such as runtime, type, and timestamp. This way you can conduct a more focused search.
32 +* Double-clicking on a log entry provides you with the relevant details
33 +* Note that log entries are not shown in full when they exceed a certain size so takes this into account when logging
34 +* When you know the flow and the details you have determined the origin of the log entry
27 27  
28 -== 3. How to steps ==
29 29  
30 -=== 3.1 Obtain an SFTP User account ===
31 -Make sure to get the access credentials from eMagiz Support. Ensure to obtain access credentials for all connected systems/applications that need to send or received files from the SFTP service. Every application team will get a specific user, and the eMagiz model will get it's own user. In this way, the data is securely provided to the ecosystem of the eMagiz model. For instance, in case there are 4 applications involved that need to get or send data to the SFTP service there will be 5 SFTP service users
32 32  
33 -=== 3.2 Create (agreed) folder structure ===
38 +== 3. Determining the origin of log entries ==
34 34  
40 +You can determine the origin of a log entry with a two-step approach:
35 35  
36 -=== 3.3 Dispatch folder structure fixed to eMagiz Support ===
42 +1. Search in the Monitoring overview for log entries
43 +2. Select a specific log entry for further analysis
37 37  
45 +=== 3.1 Monitoring overview Manage ===
38 38  
47 +To see and analyze the log entries you need to navigate to Manage -> Monitoring. This overview shows all log entries within your project that have been written to the log in the last fourteen days (assuming you did adhere to the fair use policy). Within this overview, you have the ability to search on various options such as runtime, type, and timestamp.
39 39  
49 +<p align="center">[[image:intermediate-active-monitoring-determining-origin-of-log-entry--manage-monitoring-unfiltered.png||]]</p>
40 40  
51 +<p align="center">[[image:intermediate-active-monitoring-determining-origin-of-log-entry--manage-monitoring-filtered.png||]]</p>
52 +
53 +=== 3.2 Select a specific log entry for further analysis ===
54 +
55 +After you have filtered the log entries to your liking you can select a specific log entry by double-clicking on the log entry. By doing so a pop-up will be presented in which the details of the log entry are written. On this details page, the flow and message are the most relevant from a user perspective.
56 +
57 +<p align="center">[[image:intermediate-active-monitoring-determining-origin-of-log-entry--manage-monitoring-log-entry-details.png||]]</p>
58 +
59 +Note that some log entries are grouped as they appeared in short proximity after each other and have to do with the same logging.
60 +
61 +<p align="center">[[image:intermediate-active-monitoring-determining-origin-of-log-entry--manage-monitoring-log-entry-details-grouped.png||]]</p>
62 +
63 +===== Practice =====
64 +
41 41  == 4. Assignment ==
42 42  
43 -Take a moment to locate the Store component for eMagiz.
67 +Determine the origin of at least five log entries that have been raised within your (Academy) project in the last two weeks. If your project has no log entries be creative in messing up stuff to create a log entry for which you can then determine the origin.
44 44  
45 45  == 5. Key takeaways ==
46 46  
47 -* The eMagiz SFTP Service requires use of a specific Store component
48 -* Please contact eMagiz Support to ensure the right configuration is created including the proper file paths inside the SFTP user folder
49 -* Ensure to update eMagiz Support whenever the file path changes
71 +* Determining in which flow a log entry is raised can be done with the help of the Manage phase in eMagiz.
72 + * In the Manage phase you have an option called Monitoring. In this overview, you will see all logging that is relevant without your project.
73 +* This overview allows you to filter on various elements, such as runtime, type, and timestamp. This way you can conduct a more focused search.
74 +* Double-clicking on a log entry provides you with the relevant details
75 +* Note that log entries are not shown in full when they exceed a certain size so takes this into account when logging
76 +* When you know the flow and the details you have determined the origin of the log entry
50 50  
51 51  
79 +
52 52  == 6. Suggested Additional Readings ==
53 53  
54 -None available
82 +If you are interested in this topic and want more information on it please read the help text provided by eMagiz when executing these actions.
55 55  
56 56  == 7. Silent demonstration video ==
57 57  
58 -None available
59 -)))
60 -((({{toc/}}))){{/container}}
61 -{{/container}}
86 +This video demonstrates how you could have handled the assignment and gives you some context on what you have just learned.
87 +
88 +<iframe width="1280" height="720" src="../../vid/microlearning/intermediate-active-monitoring-determining-origin-of-log-entry.mp4" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
89 +
90 +</div>
91 +
92 +</div>
93 +</div>
94 +
95 +{{/html}}