このページは日本語には対応しておりません。随時翻訳に取り組んでいます。
翻訳に関してご質問やご意見ございましたら、お気軽にご連絡ください。

This page covers Agent 7 on AIX. For AIX versions that Agent 7 does not support, see the legacy Datadog UNIX Agent.

Overview

The Datadog Agent brings host-level monitoring to IBM AIX (PowerPC 8+) so you can visualize system metrics, enable additional Datadog products, and troubleshoot services that run on-prem.

Note: Agent 7 on AIX does not support the following:

  • JMX-based integrations
  • Cloud Network Monitoring
  • Remote Agent configuration and upgrades with Fleet Automation

See Supported Platforms for the complete list of supported AIX versions.

Installation

Prerequisites

  • Root privileges (or sudo) on each host
  • Outbound HTTPS (443) to .datadoghq.com
  • curl or wget, and ksh (shipped on AIX by default)
  • Verify your host is running a supported AIX version

Install the Agent

To install the Agent on AIX, follow the in-app instructions in Fleet Automation, and run the generated script on your hosts.

In-app installation steps for the Datadog Agent on an AIX host.

Commands

DescriptionCommand
Start Agentstartsrc -g datadog-agent
Stop Agentstopsrc -g datadog-agent
Status of Agent serviceslssrc -g datadog-agent
Agent status pagedatadog-agent status
Send flaredatadog-agent flare
Show all commandsdatadog-agent --help

Configure the Agent

The Datadog Agent configuration file is located in /etc/datadog-agent/datadog.yaml. This YAML file holds the host-wide connection details used to send data to Datadog including:

A fully commented reference file, located in /etc/datadog-agent/datadog.yaml.example, lists every available option for comparison or to copy and paste.

Alternatively, see the datadog-agent_aix.yaml.example file for all available configuration options.

Integration files

Configuration files for integrations exist in /etc/datadog-agent/conf.d/. Each integration has its own subdirectory, <INTEGRATION>.d/, that contains:

  • conf.yaml: The active configuration controlling how the integration gathers metrics and logs
  • conf.yaml.example: A sample illustrating supported keys and defaults

To request support for an integration on AIX, open a feature request with Datadog Support.

Migrate from the UNIX Agent

To migrate from the Datadog UNIX Agent to Agent 7, uninstall the UNIX Agent and then install Agent 7:

  1. Back up the UNIX Agent configuration. Uninstalling the UNIX Agent removes the /etc/datadog-agent directory.
    cp -rp /etc/datadog-agent /etc/datadog-agent.unix-agent.bak
    
  2. Uninstall the UNIX Agent:
    installp -u datadog-unix-agent
    
  3. Install Agent 7.
  4. Configure Agent 7 in /etc/datadog-agent/datadog.yaml. Use your backup as a reference, but do not copy the file as is:
    • Basic settings like api_key, site, hostname, tags, log_level, and proxy.* keep the same names.
    • Most other options are renamed or removed. Check each option against the AIX example configuration.
    • Do not copy the dd_url: https://unix.agent.datadoghq.com setting.
  5. Check your integration configurations in /etc/datadog-agent/conf.d/. Some options are different in Agent 7.
  6. Run datadog-agent status to confirm that the Agent is running and sending data.

If you have questions about migrating your configuration, contact Datadog Support.

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:

installp -u datadog-agent

Uninstalling the Agent removes the Agent services and the boot entry.

Further Reading