Agent Check: Aerospike

Overview

Get metrics from Aerospike Database in real time to:

• Visualize and monitor Aerospike states.
• Be notified about Aerospike failovers and events.

Setup

NOTE: The current aerospike integration is only compatible with Aerospike server v4.9 or above, see Aerospike's Python Client Library Release Notes for more info. If you use an older Aerospike server version, it is still possible to monitor it with version 7.29.0 or lower of the Datadog Agent.

Installation

The Aerospike check is included in the Datadog Agent package. No additional installation is needed on your server.

Configuration

Host

Metric collection

To configure this check for an Agent running on a host:

1. Install and configure the Aerospike Prometheus Exporter- refer to Aerospike's documentation for more details.

2. Edit the aerospike.d/conf.yaml file, in the conf.d/ folder at the root of your Agent's configuration directory to start collecting your Aerospike performance data. See the sample aerospike.d/conf.yaml for all available configuration options.

3. Restart the Agent.

Note: Version 1.16.0+ of this check uses OpenMetrics for metric collection, which requires Python 3. For hosts that are unable to use Python 3, or if you would like to use a legacy version of this check, refer to the example config.

Log collection

1. Collecting logs is disabled by default in the Datadog Agent, you need to enable it in datadog.yaml:

   logs_enabled: true

2. Add this configuration block to your aerospike.d/conf.yaml file to start collecting your Aerospike Logs:

   logs:
     - type: file
       path: /var/log/aerospike/aerospike.log
       source: aerospike

   Change the path parameter value and configure them for your environment. See the sample aerospike.d/conf.yaml for all available configuration options.

3. Restart the Agent.

Containerized

For containerized environments, see the Autodiscovery Integration Templates for guidance on applying the parameters below.

Metric collection

Parameter	Value
<INTEGRATION_NAME>	aerospike
<INIT_CONFIG>	blank or {}
<INSTANCE_CONFIG>	{"openmetrics_endpoint": "http://%%host%%:9145/metrics"}

Log collection

Available for Agent versions >6.0

Collecting logs is disabled by default in the Datadog Agent. To enable it, see Kubernetes Log Collection.

Parameter	Value
<LOG_CONFIG>	{"source": "aerospike", "service": "<SERVICE_NAME>"}

Validation

Run the Agent's status subcommand and look for aerospike under the Checks section.

Data Collected

Metrics

See metadata.csv for a list of metrics provided by this integration.

Service Checks

aerospike.can_connect aerospike.cluster_up

Events

Aerospike does not include any events.

Troubleshooting

Need help? Contact Datadog support.