Datadog Synthetics is now available!

Agent Commands

For Linux based systems where the service wrapper command is not available, consult the list of alternatives.

Start, Stop, and Restart the Agent

Start the Agent

List of commands to start the Datadog Agent:

Platform Command
AIX startsrc -s datadog-agent
Linux sudo service datadog-agent start
Docker See the dedicated Docker documentation
macOS launchctl start com.datadoghq.agent or via the systray app
Source sudo service datadog-agent start
Windows See the dedicated Windows documentation
Platform Command
Linux sudo service datadog-agent start
Docker See the dedicated Docker documentation
macOS /usr/local/bin/datadog-agent start
Source sudo ~/.datadog-agent/bin/agent start
Windows See the dedicated Windows documentation

Stop the Agent

List of commands to stop the Datadog Agent:

Platform Command
AIX stopsrc -s datadog-agent
Linux sudo service datadog-agent stop
Docker See the dedicated Docker documentation
macOS launchctl stop com.datadoghq.agent or via the systray app
Source sudo service datadog-agent stop
Windows See the dedicated Windows documentation
Platform Command
Linux sudo service datadog-agent stop
Docker See the dedicated Docker documentation
macOS /usr/local/bin/datadog-agent stop
Source sudo ~/.datadog-agent/bin/agent stop
Windows See the dedicated Windows documentation

Restart the Agent

List of commands to restart the Datadog Agent:

Platform Command
Linux sudo service datadog-agent restart
Docker See the dedicated Docker documentation
macOS run stop then start, or via the systray app
Source unsupported Platform
Windows See the dedicated Windows documentation
Platform Command
Linux sudo service datadog-agent restart
Docker See the dedicated Docker documentation
macOS /usr/local/bin/datadog-agent restart
Source sudo ~/.datadog-agent/bin/agent restart
Windows See the dedicated Windows documentation

Agent Status and Information

Service Status

List of commands to display the status of the Datadog Agent:

Platform Command
AIX lssrc -s datadog-agent
Linux sudo service datadog-agent status
Docker (Debian) sudo docker exec -it <container_name> s6-svstat /var/run/s6/services/agent/
Kubernetes kubectl exec -it <pod-name> s6-svstat /var/run/s6/services/agent/
macOS launchctl list com.datadoghq.agent or via the systray app
Source sudo service datadog-agent status
Platform Command
Linux sudo service datadog-agent status
Docker (Debian) sudo docker exec -it <container_name> /etc/init.d/datadog-agent status
Kubernetes kubectl exec -it <pod-name> /etc/init.d/datadog-agent status
macOS datadog-agent status
Source sudo ~/.datadog-agent/bin/agent status
Windows See the dedicated Windows documentation
Platform Command
Kubernetes datadog-cluster-agent status

Agent Information

List of commands to display the status of your Datadog Agent and enabled integrations.

Platform Command
AIX datadog-agent status
Linux sudo datadog-agent status
Docker sudo docker exec -it <container_name> agent status
Kubernetes kubectl exec -it <pod-name> agent status
macOS datadog-agent status or via the web GUI
Source sudo datadog-agent status
Windows See the dedicated Windows documentation

A properly configured integration is displayed under Running Checks with no warnings or errors, as seen below:

  Running Checks
  ==============

    network (1.6.0)
    ---------------
      Total Runs: 5
      Metric Samples: 26, Total: 130
      Events: 0, Total: 0
      Service Checks: 0, Total: 0
      Average Execution Time : 0ms
Platform Command
Linux sudo service datadog-agent info
Docker sudo docker exec -it <container_name> /etc/init.d/datadog-agent info
Kubernetes kubectl exec -it <pod-name> /etc/init.d/datadog-agent info
macOS datadog-agent info
Source sudo ~/.datadog-agent/bin/info
Windows See the dedicated Windows documentation

A properly configured integration is displayed under Checks with no warnings or errors, as seen below:

  Checks
  ======

   network
   -------
     - instance #0 [OK]
     - Collected 15 metrics, 0 events & 1 service check
Platform Command
Kubernetes datadog-cluster-agent status

Further Reading

Additional helpful documentation, links, and articles: