Last modified by Erik Bakker on 2024/02/22 12:36
Show last authors
1 {{container}}{{container layoutStyle="columns"}}(((
2 {{error}}
3 Note that the functionality mentioned in this microlearning will become obsolete when migrating to the 3rd generation runtime.
4 {{/error}}
5
6 There is a need to see runtime level logging in cases where it is unclear whether that specific runtime has started up or not. In eMagiz, you won't receive logging if the start-up fails because no established connection can send logging to eMagiz. When this particular runtime runs on-premises, you can see that specific logging on the runtime in the wrapper.log. In this microlearning, we will learn how to find the wrapper log and search within the wrapper log to find the corresponding error and subsequently analyze that error.
7
8 Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]].
9
10 == 1. Prerequisites ==
11
12 * Advanced knowledge of the eMagiz platform
13
14 == 2. Key concepts ==
15
16 This microlearning centers around interpreting the wrapper.log for an on-premise runtime
17 With a wrapper.log, we mean: A file that holds start-up and shut down information on a specific runtime
18
19 In a wrapper log, you see the following information:
20
21 * Start-up information on JVM level
22 * Shutdown information on JVM level
23 * Errors on start-up or shutdown
24
25 == 3. Interpreting wrapper.log on-premise ==
26
27 There is a need to see runtime level logging in cases where it is unclear whether that specific runtime has started up or not. In eMagiz, you won't receive logging if the start-up fails because no established connection can send logging to eMagiz. When this particular runtime runs on-premises, you can see that specific logging on the runtime in the wrapper.log. In this microlearning, we will learn how to find the wrapper log and search within the wrapper log to find the corresponding error and subsequently analyze that error.
28
29 In a wrapper log, you see the following information:
30
31 * Start-up information on JVM level
32 * Shutdown information on JVM level
33 * Errors on start-up or shutdown
34
35 === 3.1 Where to find the wrapper.log ===
36
37 Before we can interpret the wrapper.log, the first action will be to find the wrapper.log. The wrapper.log is available within the data folder of each eMagiz runtime that is running on-premises. To see it, you first need to know the location where you saved and unpacked the runtime zips. Suppose you open the runtime you want to interpret the wrapper log and open the data folder. Within the data folder, there is a folder called log. You will see a file called wrapper which can be opened with a tool such as Notepad++.
38
39 [[image:Main.Images.Microlearning.WebHome@advanced-advanced-monitoring-interpreting-wrapper-log-on-premise--wrapper-log-location.png]]
40
41 === 3.2 Find additional information ===
42
43 When you open the wrapper.log file, you see all JVM-related logging. Here, you can also see whether things have broken down when starting the JVM or shutting it down. With the help of this information, you can quickly determine whether the start-up or shutdown process is not working as expected. Having this information will be the trigger to see, per the relevant stakeholders, what to do to fix these problems in a structured manner.
44
45 One way to do so would be to stop the runtime and delete the data folder without deleting the h2 folder. That would initiate a clean restart of the runtime to alleviate the problems. In case of structural issues, you should dive into the logging and analyze the issues in more detail.
46
47 == 4. Key takeaways ==
48
49 * The wrapper.log can be found within the folder called log under the folder data
50 * You can search the log with the help of tools such as Notepad++
51 * By looking at the timestamp in the eMagiz Manage Log, you can run a focused search
52
53 == 5. Suggested Additional Readings ==
54
55 No suggested additional readings for this microlearning.)))((({{toc/}}))){{/container}}{{/container}}