Agent Guide › Logging › Set Log Levels

Previous Topic: Display SiteMinder Agent Log Messages in a Console

Next Topic: Dynamically Update the SiteMinder Agent Log Files

Set Log Levels

You can configure the SiteMinder Agent to generate different levels of log messages and then display them in a file or console. Choosing a log level facilitates troubleshooting and debugging, as the log level determines the severity and extent of the logged messages. In addition, it provides control for the level of detail that the SiteMinder Agent includes in a log.

To change the log level, set the loglevel parameter to a log level described in the following table. For example:

loglevel="1"

Valid log levels are:

Log Level

Type of Messages

0

No log messages. Note however that log files are still created.

1

Fatal Messages only. For example, fatal messages are logged when the SiteMinder Agent fails to connect to a Policy Server during server startup.

2

Error Messages and Level "1" Messages. Error messages are logged when problems are encountered during SiteMinder Agent initialization or runtime that prevent the SiteMinder Agent from functioning correctly. For example, if the Validation realm is unavailable, an error message is logged.

3

Warning and Level "2" Messages. Warning messages are logged when the SiteMinder Agent encounters noncritical configuration problems that do not affect the functionality of the SiteMinder Agent. For example, if an incorrect value for pspollinterval is specified, the value is ignored and a default value is used.

4

Informational and Level "3" Messages. Informational messages are logged for SiteMinder Agent activity and flow.

5

Tracing and Level "4" Messages. Tracing messages provide tracing information for the SiteMinder Agent.

6

Extended debug logging and Level "5" messages. Reserved for future use. The SiteMinder Agent does not log any messages of this type at this time.

To avoid large log files, leave the log level at "1" so the SiteMinder Agent logs only critical errors. If you want to audit the activity of your site more carefully, change the log level to 4.

Note: If a noninteger log level is specified, the SiteMinder Agent defaults to log level "0".