Java Agents 2024.9

Agent Debug Level

The agent log level.

Make sure your container captures messages written to the standard output. Some containers do not, and warnings or critical errors can disappear forever.

Property name

org.forgerock.agents.debug.level

Aliases

com.iplanet.services.debug.level
  Introduced in Java Agent 5.0
  Recognized from AM 6

org.forgerock.agents.debug.level
  Introduced in Java Agent 5.6

Function

Logs

Supported settings
OFF

(Deprecated) Uses the same log level as ERROR. To disable logging, edit agent-logback.xml. Forgerock advises not to disable logging.

ERROR

Log only errors.

WARNING

Log errors and warnings.

MESSAGE

Log errors, warnings, and informative messages.

DEBUG

Log errors, warnings, informative messages, and some debugging messages.

TRACE

Log fine-grained information, when you need the full visibility of what is happening in your application. This log level can create big log files, so use only when necessary, and then reduce the log level.

ON

(Deprecated) Uses the same log level as TRACE. When the log level is ON, TRACE level logs are written to file. In previous releases, TRACE level logs were written to the standard output. Make sure your container captures messages written to the standard output.

Default

ERROR

Bootstrap property

No

Required property

No

Restart required

No

Local configuration file

AgentConfig.properties

AM console

Tab: Global

Title: Agent Debug Level