Logging Levels

Iotellect Server uses five predefined logging levels:

  • Fatal logging level is used to report only the most severe messages. The Iotellect Server usually stops if a fatal error is detected and reported.

  • Error messages do not cause Iotellect Server 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.

  • Warn messages show that something has gone wrong, but usually Iotellect Server can recover from such issues automatically and no immediate action is required.

  • Info messages reflect normal Iotellect Server activities. These messages should be used for monitoring by a system administrator.

  • Debug messages are used to solve problems if Iotellect Server 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 Iotellect Server 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 Iotellect 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: <Logger name="ag.category_name" level="info"/>

  • Change the level 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 Iotellect Server 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 Iotellect Server to halt or freeze.

Was this page helpful?