View The Logging Levels

This option display the Escenic logging level editor, which you can use to control what kinds of messages are added to the browser log (see View the Browser Log). All messages have two properties that are used by the logging level editor:

category

This is a string that identifies the source of the message. If the source is a Java program (which is usually the case), the string is the fully qualified class name of the class that issued the message (com.escenic.presentation.servlet.BootstrapFilter, for example). Messages generated by template code, on the other hand, have category strings defined by the template developer: template developers are recommended to follow a similar "dotted" naming convention.

level

This is a keyword denoting the severity of the condition that caused the message to be issued. The severity levels (from highest to lowest) are:

FATAL

indicates that a fatal error has occurred.

ERROR

indicates that a non-fatal error has occurred.

WARN

indicates that a possibly undesirable event has occurred.

INFO

indicates that a event of possible interest has occurred.

DEBUG

indicates that an event of possible significance in a debugging situation has occurred.

TRACE

indicates that a traceable event has occurred.

The logging level editor lets you use these two message properties to control what messages are appended to the browser log. Messages are selected by assigning levels to categories. All messages belonging to that category that have the assigned level or higher will then be appended to the log. Assigning the level ERROR to the category com.escenic.presentation.servlet.BootstrapFilter, for example, will cause any com.escenic.presentation.servlet.BootstrapFilter messages with the level ERROR or FATAL to be appended to the log.

Instead of assigning one of the above level settings to com.escenic.presentation.servlet.BootstrapFilter, you can instead set the level to INHERIT. It will then inherit whatever level is set for com.escenic.presentation.servlet; if com.escenic.presentation.servlet is also set to INHERIT, then it will inherit whatever is set for com.escenic.presentation and so on. This means it is possible to set a general level for all messages by setting the level of the special category root, and then just set any exceptions as required.