Logging

Starting with Oryon version 2.4.0, the Oryon agent allows to control its logging, primarily for circumstances where troubleshooting is required.

For that purpose, two Java properties may be set (if they are not present, the system will use defaults as outlined below).

oryon.loglevel

Sample usage: -Doryon.loglevel=debug

This setting defines the verbosity of the logging. The supported values are:

• ERROR
• WARN
• INFO
• DEBUG
• TRACE

The default log level is INFO, which is not very verbose. Note that you may specify the loglevel in a case-insensitive manner, as shown in the above example.

oryon.logtarget

Sample usage: -Doryon.logtarget=C:/temp/oryon-agent.log

This setting defines where the logs will be written to. There are three predefined values:

• stdout: Standard output
• stderr: Standard error
• slf4j: Force using the SLF4J logging framework

The default behavior is: Try to use slf4j if it seems to be usable (i.e. if the corresponding classes exist), otherwise fall back to stdout.

Finally, if the setting does not correspond to any of the predefined values (as shown in the example above), the value is interpreted as a filename. It is strongly recommended to provide an absolute path. Also ensure that the target directory exists, and that the file can be written to.

If logging to the given file fails for some reason, it will fall back to the default as specified above.