LinkServer uses five predefined logging levels:
Fatal logging level is used to report only the most severe messages. The LinkServer usually stops if a fatal error is detected and reported.
Error messages do not cause LinkServer to stop immediately when they are reported, but they indicate that there are serious problems with the server operation and that action is needed to prevent server failure.
Warning messages show that something has gone wrong, but usually LinkServer can recover from such issues automatically and no immediate action is required.
Info messages reflect normal LinkServeractivities. These messages should be used for monitoring by a system administrator.
Debug messages are used to solve problems if LinkServer does not behave as expected. Debug output is disabled by default. Enabling debug-level logging for all categories can lead to extremely high volume of logged messages and seriously affect LinkServer performance. Enable debug output temporarily only if you are absolutely sure that you need this. This level of logging is usually only enabled if advised by Tibbo support team.
By default, logging is performed at Info level. It's recommended to change logging level to Warning during production use to improve performance and reduce size of log files. When problems arise, it may be necessary to set logging level in individual categories to Debug for troubleshooting.
To modify the logging level, perform the following steps:
| • | Edit logging.xml. |
| • | Find the section that says: |
<category name="ag.category_name">
<priority value="info"/>
</category>
| • | Change the priority value entry (info above) to the logging level you want to specify. |
| • | Usually changes take effect within 20 seconds of saving the corrected logging configuration file was saved. In some cases it may be necessary to restart the LinkServer in order to activate changes. |
|
The string priority value= appears in other sections of the file. Most importantly, it appears under the section </root>. Modifying this value under the section root (especially to higher logging levels, such as debug) may affect performance considerably, and even cause the LinkServer to halt or freeze. |
