Overview

This page outlines the basic features of the Datadog Agent for macOS. If you haven’t installed the Agent yet, instructions can be found in the Datadog Agent Integration documentation.

By default, the Agent is installed in a sandbox located at /opt/datadog-agent. You can move this folder anywhere; however, this documentation assumes a default installation location.

Supported macOS versions

Commands

In Agent v6 and v7, the launchctl service manager provided by the operating system is responsible for the Agent lifecycle, while other commands must be run through the Agent binary directly. Alternatively, lifecycle commands can also be managed through the systray app, and other commands can be executed with the web GUI.

Configuration

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

• ~/.datadog-agent/datadog.yaml

Configuration files for Integrations:

• ~/.datadog-agent/conf.d/

Uninstall the Agent

To uninstall the Agent, run the following command:

Single user installation

To remove the Agent and all Agent configuration files:

1. Stop and close the Datadog Agent with the bone icon in the tray.
2. Drag the Datadog application from the application folder to the trash bin.
3. Run the following commands:

   sudo rm -rf /opt/datadog-agent
   sudo rm -rf /usr/local/bin/datadog-agent
   sudo rm -rf ~/.datadog-agent/** # to remove broken symlinks
   launchctl remove com.datadoghq.agent
   sudo rm -rf /var/log/datadog
   

4. Reboot your machine for the changes to take effect.

System-wide LaunchDaemon installation

To remove the Agent and all Agent configuration files:

1. Drag the Datadog application from the application folder to the trash bin.
2. To remove remaining files, run the following:

   sudo rm -rf /opt/datadog-agent
   sudo rm -rf /usr/local/bin/datadog-agent
   sudo rm -rf ~/.datadog-agent/** # to remove broken symlinks
   sudo launchctl disable system/com.datadoghq.agent && sudo launchctl bootout system/com.datadoghq.agent
   sudo launchctl unload /Library/LaunchDaemons/com.datadoghq.agent.plist
   sudo rm /Library/LaunchDaemons/com.datadoghq.agent.plist
   sudo rm -rf /var/log/datadog
   

3. Reboot your machine for the changes to take effect.

Troubleshooting

See the Agent Troubleshooting documentation.

Working with the embedded Agent

The Agent contains an embedded Python environment at /opt/datadog-agent/embedded/. Common binaries such as python and pip are contained within /opt/datadog-agent/embedded/bin/.

See the instructions on how to add packages to the embedded Agent for more information.

Further Reading

Additional helpful documentation, links, and articles:

Collect your logsDOCUMENTATION Collect your processesDOCUMENTATION Collect your tracesDOCUMENTATION Find out more about the Agent's architectureDOCUMENTATION Configure inbound portsDOCUMENTATION