Log documentation

Log entry groups

The following groups of log entries are defined:
NameCategoryEntries
Servletorg.xins.server.servlet3
Internal lifespan-relatedorg.xins.server.lifespan2
Bootstrappingorg.xins.server.lifespan.bootstrap42
Logging subsystemorg.xins.server.log12
Initializationorg.xins.server.lifespan.init42
Runtimeorg.xins.server.runtime18
HTTP-levelorg.xins.server.runtime.http3
Transaction loggingorg.xins.server.runtime.tx2
Access rule matchingorg.xins.server.runtime.acl3
Calling Conventionorg.xins.server.runtime.cc2
Diagnostic Context Identifiersorg.xins.server.runtime.context3
Shutdownorg.xins.server.lifespan.shutdown8
Front-end calling conventionorg.xins.server.cc.frontend6

Translation bundles

The following translation bundles are available:

Log levels

The following log levels can be used:

IDDescription
DEBUGDebugging messages. Only useful for programmers. This is the only level that may contain implementation details that are not exposed outside individual functions.
INFOInformational messages. Typically not important to operational people, except in cases where a problem is being traced or if behaviour is investigated.
NOTICEInformational messages that should typically be noticed by operational people.
WARNINGWarning messages. Should be noticed, but typically require no immediate action, although they may indicate a problem that should be fixed.
ERRORError messages. Indicates an error that should be fixed. However, it does not keep the whole application from functioning.
FATALFatal error messages. Indicates an error that keeps the whole application from functioning.

Note that it is a fatal condition to start with an unexpected condition of any crucial aspect of the application. If the configuration of all crucial aspects of the application could not be correctly and fully processed it is effectively in an unexpected state. Falling back to defaults does not imply returning to an expected condition because clearly some specific configuration was intended and expected.

This rule should be applied to determine whether a message should be logged at the FATAL level or not.