Wiki source code of Logging

Show last authors
1 {{content/}}
2
3 This sections allows you to configure how and when events should be logged.
4
5 The logging settings can be modified even while the application is running, it does not need to be restarted.
6
7 When you want to run an error analysis, you can change the logging level or logging files temporarily
8
9 {{figure image="logging_1_en.png" width="300"}}
10 Log messages let you trace processes and analyse errors. Each Java class has got its own logger. This makes it possible to freely configure which log messages should be logged and which should be suppressed.
11 {{/figure}}
12
13 A logging configuration always consists of a logging configuration and a logging target.
14
15 For each logging configuration, you can set the desired logging level and which log messages you want to be included.
16
17 Setup a logging target to define where you want the log message to be written to (file or console). A logging targets also lets you change or configure how the log messages are formatted.
18
19 == Setup ==
20
21 ; Add new logger
22 : Adds a new logging configuration to the available logging configurations.
23 ; Add new logging target configuration
24 : Adds a new logging target to the available logging targets.
25 ; Edit
26 : Open the screen for editing the configuration of loggers or logging targets.
27 ; Delete
28 : Deletes the selected logging configuration or target.
29
30 {{info}}
31 The root logging configuration cannot be deleted. Logging targets cannot be deleted while they are still in use by some logging configuration.
32 {{/info}}
33
34 == Logging configuration ==
35
36 {{figure image="logging_2_en.png"}}
37 A logger is responsible for collection log messages. To restrict which log messages should be included, you can set both a log level as well as the package path.
38 {{/figure}}
39
40 ; Name or path of package
41 : Defines the name of a class or Java package path whose output should be logged.
42 ; Level
43 : The logging level. Available levels are, in order of increasing severity: //ALL//, //DEBUG//, //INFO//, //WARN//, //ERROR//, //FATAL//, //OFF//. When you select a certain severity level, all log messages with a higher severity are logged as well.
44 ; Log output
45 : The logging target that should be used for this logger.
46 ; Pass on log scope to root logger
47 : This allows you to pass on the log scope to the root logger. That is, the log messages will be logged by both this logger as well as the root logger.
48
49 == Logging target ==
50
51 {{figure image="logging_3_en.png" width="300"}}
52 Writing log messages to the console. This uses the same console that was used to start the application server.
53 {{/figure}}
54
55 {{figure image="logging_4_en.png" width="300"}}
56 Writing log messages to a file. You may choose any arbitrary path on the file system. Also, you may want to set a limit for the log file size, or you risk exceeding the available disk space of the server.
57 {{/figure}}
58
59 ; Type
60 : The type of output. Available types are //console// (writes log messages to the console) and //rolling file// (writes log messages to a file).
61 ; Name
62 : Unique name for this logging target. Two logging target cannot have the same name.
63 ; Log level limit
64 : Sets a limit for the logging level of this logging target. Available limits are: //No limit//, //DEBUG//, //INFO/, //WARN//, //ERROR//, //FATAL//
65 ; Layout type
66 : Sets the format of the log output. Currently, only the so-called pattern layout is supported. The pattern currently in use is shown in the input field.
67
68 The following settings apply only to logging target of type //rolling file//.
69
70 {{info}}
71 The path must exists on the file system and the user running the {{formcycle/}} application (or application server) must have write appropriate rights for that path.
72 {{/info}}
73
74 ; File
75 : Path to the log file.
76 ; Maximum file size
77 : The maximum file size for an individual log file. When that size has been reached, a new log file will be created.
78 ; Maximal number of backup files
79 : The maximum number of backup files that will be created. When this limit has been reached, the oldest backup file will be deleted.