This page outlines the basic functionality of the Datadog Agent. If you haven’t installed the Agent yet, instructions can be found in the Datadog agent integration page.
By default, your Agent is installed in its own sandbox located at
/opt/datadog-agent. You’re free to move this folder wherever you like.
However, we assume that the Agent is installed in its default location, so be sure to modify the instructions accordingly if you decide to move it to another location.
lifecycle commands (former
status on the Agent 5) are replaced by
launchctl commands on the
com.datadoghq.agent service, and should be run under the logged-in user. For these commands, you can also use the Datadog Agent systray app, all the other commands can still be run with the
datadog-agent command (located in the
/usr/local/bin/) by default)
|Agent v5||Agent v6||Notes|
||Start Agent as a service|
||Stop Agent running as a service|
||Restart Agent running as a service|
||Status of Agent service|
||Status page of running Agent|
||Display command usage|
||Run a check|
The configuration files and folders for the Agent are located at:
|Agent v5||Agent v6|
Configuration files for integrations:
|Agent v5||Agent v6|
Run the info or status command to see the state of the Agent.
The Agent logs are located in the
For Agent v5 logs are in:
If you’re still having trouble, our support team will be glad to provide further assistance.
You can either download the DMG package and install it manually, or use the one-line install script.
Then start the Datadog Agent app (once started, you should see it in the system tray), and manage the Agent from there. The Agent6 also ships a web-based GUI to edit the Agent configuration files and much more, refer to the [changes and deprecations document][changes] document for more information.
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_mac_os.sh)"
In case you want to install on a clean box (or have an existing agent 5 install from which you do not wish to import the configuration) you have to 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_mac_os.sh)"
Stop and Close the Datadog Agent: via the bone icon in the Tray.
Drag the Datadog Application from the application folder to the Trash Bin.
$ sudo rm -rf /opt/datadog-agent $ sudo rm -rf /usr/local/bin/datadog-agent $ sudo rm -rf ~/.datadog-agent/** #to remove broken symlinks
If you ran the optional install commands to have the Agent run at boot time, run the following to finish uninstalling:
$ sudo launchctl unload -w /Library/LaunchDaemons/com.datadoghq.agent.plist $ sudo rm /Library/LaunchDaemons/com.datadoghq.agent.plist