The Datadog UNIX Agent is being developed for specific system architectures, and is not the same as the Windows, Linux, and MacOS Agents.
This page outlines the installation and configuration of the Datadog UNIX Agent for AIX.
Note: The Datadog Unix Agent supports PowerPC 8 or greater and the following versions of AIX:
AIX 6.1 TL9 SP6+
AIX 7.1 TL5 SP3+
AIX 7.2 TL3 SP0+
Installation
A one-step ksh install script is provided on the Agent download page within Datadog. The script supports the following environment variables:
CHANNEL: defaults to stable. Specifies the package repository channel.
Values: stable, beta, unstable
VERSION: defaults to latest. Specifies the package version.
PROXY: defaults to none. Specifies the proxy URI.
Example: http://proxy.foo.com
PROXY_USER: defaults to empty. Specifies the proxy server username.
PROXY_PASSWORD: defaults to empty. Specifies the proxy server password. For the process/container Agent, this variable is required for passing in an authentication password and cannot be renamed.
INSECURE: defaults to false. Allows skipping TLS validation.
Alternatively, download links for the latest releases can be found on this page.
The installer may be executed as follows (as root):
You can find the Agent installation log in the dd-aix-install.log file. To disable this logging, remove the -e dd-aix-install.log parameter in the installation command.
Commands
Description
Command (as root)
Start Agent as a service
startsrc -s datadog-agent
Stop Agent running as a service
stopsrc -s datadog-agent
Status of Agent service
lssrc -s datadog-agent
Status page of running Agent
datadog-agent status
Send flare
datadog-agent flare
Display command usage
datadog-agent --help
Configuration
The configuration files and folders for the Agent are located in /etc/datadog-agent/datadog.yaml
A sample configuration file can be found in /etc/datadog-agent/datadog.yaml.example.
A basic configuration typically requires your Datadog API key. To submit your metrics to a different site (for example, the EU instance), the site configuration option is available.
Occasionally a proxy configuration must be specified depending on your network setup.
Configuration files for Integrations:/etc/datadog-agent/conf.d/
Integrations
The Unix Agent collects system metrics for:
cpu
filesystem
iostat
load
memory
uptime
disk
network
Additionally, the following integrations can be enabled to collect further metrics:
Enable the above integrations by copying and editing the sample configuration files provided. These are found in /etc/datadog-agent/conf.d. The name of the YAML configuration file should match that of the integration: /etc/datadog-agent/conf.d/<INTEGRATION_NAME>.d/conf.yaml enables the integration <INTEGRATION_NAME>, and set its configuration. Example configuration files can be found at /etc/datadog-agent/conf.d/<INTEGRATION_NAME>.d/conf.yaml.example
Note: Some of the available metrics differ between the integrations for the Unix Agent and the integrations for Linux, Windows and MacOS. Although it is possible to monitor processes and network metrics with the Unix Agent, the Live Process Monitoring and Cloud Network Monitoring capabilities aren’t available. Log Management is also not available with the Unix Agent.
The Unix Agent has no trace-agent component, so APM tracing and profiling is not supported.
Running DogStatsD
DogStatsD allows collecting and submitting custom metrics to Datadog. It listens on a UDP port and DogStatsD metrics may be submitted to it. These are then relayed to Datadog.
DogStatsD relies on the same configuration file defined for the Agent, where a DogStatsD configuration section is available. The DogStatsD server typically runs within the same Agent process—but should you need a dedicated process, it may also be launched in standalone mode.
To enable DogStatsD, edit /etc/datadog-agent/datadog.yaml and set the relevant configuration options.
/etc/datadog-agent/datadog.yaml
dogstatsd:# DogStatsD configuration optionsenabled:true# disabled by defaultbind_host:localhost # address we'll be binding toport:8125# DogStatsD UDP listening portnon_local_traffic:false# listen to non-local traffic
Note: DogStatsD does not daemonize and runs in the foreground.
There are also facilities to run the Agent with the known Python supervisor. This might be your preferred way to manage the Agent daemon if you are familiar with the tool. There are entries for both the Agent and DogStatsD.
Monitor Agent uptime
You can use the metric datadog.agent.running to monitor the uptime of an Agent. The metric emits a value of 1 if the Agent is reporting to Datadog.
Uninstall the Agent
To remove an installed Agent, run the following installp command:
Note: Agent uninstallation logs can be found in the dd-aix-install.log file. To disable this logging, remove the -e parameter in the uninstallation command.
Further Reading
Additional helpful documentation, links, and articles: