Log levels for log categories

The log level of a category determines the type of messages that the log file includes. When you create a log category and set its default log level, these selections apply to all nodes in the cluster and they persist until you change them. The default log level applies to all the loggers that you associate with your category.

Log levels

When you choose a log level, messages from that level and above are written to the log file. For example, if the log level is set to ERROR, the log file includes log messages with a severity of ERROR and FATAL. The following list orders log levels from highest (most severe) to lowest (least severe):

OFF: The log file does not include any messages.
FATAL: The log file includes messages that inform about severe errors that can cause the application to terminate.
ERROR: The log file includes messages that inform about serious errors that might allow the application to continue running.
ALERT: The log file includes Pega Platform -specific messages that indicate that a performance threshold has been exceeded, or that an event that affects the performance has occured.
WARN: The log file includes messages that inform about situations that might have an adverse performance implication.
INFO: The log file includes messages that inform that a run-time event, such as startup or shutdown, has occurred.
DEBUG: The log file includes messages that inform about informational events that are useful for debugging.
ALL: The log file includes messages of all levels.

Note: Adjust a log level to your specific needs. The log level that is too verbose may cause performance issues.

You can apply the same log levels to individual loggers. For example, if you want a log category that groups loggers that correspond with agents to work on the FATAL level, but you need one logger within this category to work on the ALL level, you can change the level of the individual logger.

Log categotries management

In Admin Studio, you can see the list of log categories in your application. You can see the information about the log levels on which your log categories work in the following columns:

Default log level: A log level that you specify when you create a log category. All the loggers that you associate with this category work on this log level.
Current log level: A log level on which a specific category works. It can be the same as the default log level. You can change the current log level at run time from Admin Studio. Change the current log level of a category to include or exclude specific log messages. You can reset current log levels to default log levels.

For more information, see Log categories on Pega Community.

In Admin Studio, you can manage your log categories. For example, you can change or reset the log level.

Operations on log categories require the following privileges:

pzLogLevelObserver to view log categories.
pzLogLevelAdministrator to edit log categories.