Skip to main content

Quick installation using Docker containers


  • A running Aerospike instance. See Install Aerospike for deployment instructions for your platform.
  • If you want to monitor an Aerospike outbound connector, but you do not have an instance deployed, see Streaming Data from Aerospike for deployment instructions.

1. Run Aerospike Prometheus Exporter

Aerospike provides docker images for the Aerospike Prometheus Exporter on Docker Hub.

Run Aerospike Prometheus Exporter and connect to an Aerospike database. This example command assumes that the Aerospike database was deployed in a container named aerospike on the same system and where the aerospike container is running.

docker run -itd --name exporter --link="aerospike" -e AS_HOST=aerospike -e AS_PORT=3000 -e METRIC_LABELS="type='development',source='aerospike'" -p 9145:9145 aerospike/aerospike-prometheus-exporter:latest
  • AS_HOST - The IP address of a node of the Aerospike database
  • AS_PORT - The client-access port for the database

2. Run Prometheus

Run a Prometheus container and configure the exporter as a scrape target.

Create prometheus.yml with this content:

scrape_interval: 15s
- job_name: 'aerospike'
- targets: ['exporter:9145']
docker run -tid --name prometheus --link="exporter" -p 9090:9090 -v <Path_of_prometheus.yml>:/etc/prometheus/prometheus.yml prom/prometheus:latest

View metrics on a Prometheus dashboard at http://localhost:9090.

3. Run Grafana

Grafana's default port is 3000, however Aerospike is already bound to ports 3000, 3001, and 3002. To avoid a conflict, you must use the -p flag to rebind Grafana to a new port outside this range. The following example rebinds it to 3003.

docker run -d --name grafana -p 3003:3000 grafana/grafana

Visit http://localhost:3003/ to access the dashboard.

The previous steps describing how to run Grafana in a Docker container represent a general process useful for getting to know the software. For a video tutorial and more information about less commonly-used command line options, see Run Grafana Docker image in the Grafana documentation.

You can import dashboards for monitoring your Aerospike database from the Aerospike Monitoring repository on GitHub.

Example using Docker swarm

See Aerospike Cluster with Monitoring Stack on Docker Swarm