Debug Mode

Overview

The Agent, by default, logs in INFO level. You can set the log level to DEBUG to get more information from your logs.

Note: Debug mode is meant for debugging purposes only. Datadog recommends only enabling DEBUG for a certain window of time as it increases the number of indexed logs. Set the log level back to INFO when done.

To enable the Agent full debug mode:

  1. Modify your local datadog.yaml file. See Agent main configuration file for OS specific details.

  2. Replace # log_level: INFO with log_level: DEBUG (remove # to uncomment the line).

  3. Restart the Datadog Agent. See Agent Commands for OS specific details.

  4. Wait a few minutes to generate some logs. See Agent Log Files for OS specific details.

Containerized Agent

To enable debug mode for the container Agent, use DD_LOG_LEVEL=debug when starting your Agent.

For Agent v6.19+ / v7.19+, set the Agent log level at runtime using:

agent config set log_level debug

You cannot change the log level for the trace-agent container at runtime like you can do for the agent container. A redeployment after setting DD_LOG_LEVEL variable to debug is still necessary for the dedicated trace-agent container.

If using Helm, replace logLevel: INFO with logLevel: DEBUG in your datadog-values.yaml file and re-deploy.

Agent log level

The following Agent log levels are available for log_level or DD_LOG_LEVEL:

OptionCritical logsError logsWarn logsInfo logsDebug logsTrace logs
'OFF'
'CRITICAL'
'ERROR'
'WARN'
'INFO'
'DEBUG'
'TRACE'

Note: When setting the log level to 'OFF' in the configuration file quotes are mandatory to prevent the value for being improperly parsed. Quotes are optional for other log levels.

Further Reading

Additional helpful documentation, links, and articles: