Debug Mode
Incident Management is now generally available! Incident Management is now generally available!

Debug Mode

Agent

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.

  1. Modify your local datadog.conf 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

When run in a container, the Agent cannot be restarted via service datadog-agent restart (or similar) which causes the container to be killed by Docker. Use supervisor to restart a containerized Agent:

/opt/datadog-agent/bin/supervisorctl -c /etc/dd-agent/supervisor.conf restart all

The following commands enable debug logging, restart the Agent, wait 60 seconds, then send a flare, in that order:

sed -i '/\[Main\]/a LOG_LEVEL=DEBUG' /etc/dd-agent/datadog.conf
/opt/datadog-agent/bin/supervisorctl -c /etc/dd-agent/supervisor.conf restart all
sleep 60
/etc/init.d/datadog-agent flare <CASE_ID>

Debug logs can be disabled with:

sed -i '/LOG_LEVEL=DEBUG/d' /etc/dd-agent/datadog.conf
/opt/datadog-agent/bin/supervisorctl -c /etc/dd-agent/supervisor.conf restart all

Or the container can be restarted.

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