Logging is here!

Basic Agent Usage for Red Hat


Datadog Agent has some commands and only the lifecycle commands (i.e. start/stop/restart/status on the Agent service) should be run with sudo service/sudo systemctl, all other commands need to be run with the datadog-agent command.

Agent v5 Agent v6 Notes
sudo service datadog-agent start sudo service datadog-agent start Start Agent as a service
sudo service datadog-agent stop sudo service datadog-agent stop Stop Agent running as a service
sudo service datadog-agent restart sudo service datadog-agent restart Restart Agent running as a service
sudo service datadog-agent status sudo service datadog-agent status Status of Agent service
sudo service datadog-agent info sudo datadog-agent status Status page of running Agent
sudo service datadog-agent flare sudo datadog-agent flare Send flare
sudo service datadog-agent sudo datadog-agent --help Display command usage
sudo -u dd-agent -- dd-agent check <check_name> sudo -u dd-agent -- datadog-agent check <check_name> Run a check

More information about the metrics, events, and service checks for an integrations can be retrieved with the check command:

sudo service datadog-agent check [integration]

Add the check_rate argument to get the most recent values for rates:

sudo service datadog-agent check [integration] check_rate

NB: If service is not available on your system, use:

  • on upstart-based systems: sudo start/stop/restart datadog-agent
  • on systemd-based systems: sudo systemctl start/stop/restart datadog-agent

Learn more about Service lifecycle commands


The configuration files and folders for the Agent are located at:

Agent v5 Agent v6
/etc/dd-agent/datadog.conf /etc/datadog-agent/datadog.yaml

Configuration files for integrations:

Agent v5 Agent v6
/etc/dd-agent/conf.d/ /etc/datadog-agent/conf.d/


Run the info or status command to see the state of the Agent. The Agent logs are located in the /var/log/datadog/ directory:

  • For Agent v6 all logs are in the agent.log file
  • For Agent v5 logs are in:

    • datadog-supervisord.log
    • collector.log
    • dogstatsd.log
    • forwarder.log

If you’re still having trouble, our support team will be glad to provide further assistance.

Switch between Agent v5 and v6

Upgrade to Agent 6

A script is available to automatically install or upgrade the new Agent. It sets up the repos and installs the package for you; in case of upgrade, the import tool also searches for an existing datadog.conf from a prior version and converts Agent and checks configurations according to the new file format and filesystem layout.

One-step install

To Upgrade

The Agent 6.x installer can automatically convert your 5.x style Agent configuration at upgrade:

 DD_UPGRADE=true bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/datadog-agent/master/cmd/agent/install_script.sh)"

Note: the import process won’t automatically move custom Agent checks, this is by design since we cannot guarantee full backwards compatibility out of the box.

To Install Fresh

To install on a clean box (or have an existing Agent 5 install from which you do not wish to import the configuration) provide an api key:

 DD_API_KEY=YOUR_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/datadog-agent/master/cmd/agent/install_script.sh)"

Manual install

  1. Set up Datadog’s Yum repo on your system by creating /etc/yum.repos.d/datadog.repo with the contents:

    name = Datadog, Inc.
    baseurl = https://yum.datadoghq.com/stable/6/x86_64/
  2. Update your local yum repo and install the Agent:

    sudo yum makecache
    sudo yum remove datadog-agent-base
    sudo yum install datadog-agent
  3. Copy the example config into place and plug in your API key:

    sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
  4. Re-start the Agent on Centos 7 and above:

    sudo systemctl restart datadog-agent.service
  5. Re-start the Agent on Centos 6:

    sudo initctl start datadog-agent

Downgrade to Agent v5

  1. Remove the Agent 6 Yum repo from your system:

    rm /etc/yum.repos.d/datadog.repo [ ! -f /etc/yum.repos.d/datadog.repo ] && echo -e '[datadog]\nname = Datadog, Inc.\nbaseurl = https://yum.datadoghq.com/rpm/x86_64/\nenabled=1\ngpgcheck=1\npriority=1\ngpgkey=https://yum.datadoghq.com/DATADOG_RPM_KEY.public\n       https://yum.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public' | sudo tee /etc/yum.repos.d/datadog.repo
  2. Update your local yum cache and downgrade the Agent

    sudo yum clean expire-cache metadata
    sudo yum check-update
    sudo yum remove datadog-agent
    sudo yum install datadog-agent
  3. Back-sync configurations and AutoDiscovery templates (optional): If you have made any changes to your configurations or templates, you might want to sync these back for Agent 5.

    Note: please beware that if you have made any changes to your configurations to support new Agent v6-only options, these will not work anymore with Agent v5.

  4. Back-sync custom Agent checks (optional) If you made any changes or added any new custom Agent checks while testing Agent 6 you might want to enable them back on Agent 5. Note: you only need to copy back checks you changed.

    sudo -u dd-agent -- cp /etc/datadog-agent/checks.d/<check>.py /etc/dd-agent/checks.d/
  5. Restart the Agent

    # Systemd
    sudo systemctl restart datadog-agent
    # Upstart
    sudo /etc/init.d/datadog-agent restart
  6. Clean out /etc/datadog-agent (optional)

    sudo -u dd-agent -- rm -rf /etc/datadog-agent/

Uninstall the Agent

To uninstall the Agent, run:

$ sudo yum remove datadog-agent

Further Reading