The Service Map for APM is here!

Basic Agent Usage for SUSE

Overview

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

Note: SUSE 11 SP4 and above (we do not support SysVinit) are supported.

Commands

In Agent v6, the service manager provided by the operating system is responsible for the Agent lifecycle, while other commands must be run via the Agent binary directly. In Agent v5, almost everything is done via the service manager.

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

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

  • upstart-based systems: initctl
  • systemd-based systems: systemctl

Learn more about Service lifecycle commands

Configuration

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

  • /etc/datadog-agent/datadog.yaml

Configuration files for Integrations:

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

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

  • /etc/dd-agent/datadog.conf

Configuration files for Integrations:

  • /etc/dd-agent/conf.d/

Troubleshooting

Run the status command to see the state of the Agent. The Agent logs are located in the /var/log/datadog/ directory and are consolidated in the agent.log file.

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

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

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

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

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.

Upgrade to Agent 6

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

    [datadog]
    name=Datadog, Inc.
    enabled=1
    baseurl=https://yum.datadoghq.com/suse/stable/6/x86_64
    type=rpm-md
    gpgcheck=1
    repo_gpgcheck=0
    gpgkey=https://yum.datadoghq.com/DATADOG_RPM_KEY.public
  2. Update your local Zypper repo and install the Agent:

    sudo zypper refresh
    sudo rpm --import https://yum.datadoghq.com/DATADOG_RPM_KEY.public
    sudo zypper install datadog-agent
    
  3. Copy the example configuration 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:

    sudo systemctl restart datadog-agent.service
    

Further Reading