This repo contains Aerospike's monitoring agent for Prometheus. The exporter is part of the Aerospike Monitoring Stack.
The Aerospike Prometheus Exporter is now generally available (GA).
If you're an enterprise customer feel free to reach out to support with any questions.
We appreciate feedback from community members on the issues.
Build Instructions
Aerospike Prometheus Exporter Binary
Pre Requisites
Install Go v1.12+
Steps
Clone or fetch this repository
git clone https://github.com/aerospike/aerospike-prometheus-exporter.git
cd aerospike-prometheus-exporter/
# or
# go get github.com/aerospike/aerospike-prometheus-exporter
# cd $GOPATH/src/github.com/aerospike/aerospike-prometheus-exporter
Edit /etc/aerospike-prometheus-exporter/ape.toml to add db_host (default localhost) and db_port (default 3000) to point to an Aerospike server IP and port.
[Aerospike]
db_host="localhost"
db_port=3000
Update Aerospike security and TLS configurations (optional),
Use allowlist and blocklist to filter out required metrics (optional). The allowlist and blocklist supports standard wildcards (globbing patterns which include - ? (question mark), * (asterisk), [ ] (square brackets), { } (curly brackets), [!] and \ (backslash)) for bulk metrics filtering. For example,
[Aerospike]
# Metrics Allowlist - If specified, only these metrics will be scraped. An empty list will exclude all metrics.
# Commenting out the below allowlist configs will disable metrics filtering (i.e. all metrics will be scraped).
# Namespace metrics allowlist
namespace_metrics_allowlist=[
"client_read_[a-z]*",
"stop_writes",
"storage-engine.file.defrag_q",
"client_write_success",
"memory_*_bytes",
"objects",
"*_available_pct"
]
# Set metrics allowlist
set_metrics_allowlist=[
"objects",
"tombstones"
]
# Node metrics allowlist
node_metrics_allowlist=[
"uptime",
"cluster_size",
"batch_index_*",
"xdr_ship_*"
]
# XDR metrics allowlist (only for Aerospike versions 5.0 and above)
xdr_metrics_allowlist=[
"success",
"latency_ms",
"throughput",
"lap_us"
]
# Metrics Blocklist - If specified, these metrics will be NOT be scraped.
# Namespace metrics blocklist
namespace_metrics_blocklist=[
"memory_used_sindex_bytes",
"client_read_success"
]
# Set metrics blocklist
# set_metrics_blocklist=[]
# Node metrics blocklist
node_metrics_blocklist=[
"batch_index_*_buffers"
]
# XDR metrics blocklist (only for Aerospike versions 5.0 and above)
# xdr_metrics_blocklist=[]
To enable basic HTTP authentication and/or enable HTTPS between the Prometheus server and the exporter, use the below configurations keys,
[Agent]
# File paths should be double quoted.
# Certificate file for the metric servers for prometheus
cert_file = ""
# Key file for the metric servers for prometheus
key_file = ""
# Basic HTTP authentication for '/metrics'.
basic_auth_username=""
basic_auth_password=""