Aerospike

❗️

This source has been deprecated

observIQ is in the process of transitioning a subset of BindPlane's monitoring capabilities to the observIQ OpenTelemetry Collector. As a result, this Source is no longer publicly available in BindPlane. If you need access to this Source, please reach out to our support via chat or via [email protected].

Data Collection Setup

Aerospike metrics are collected via interaction with the Aerospike Java Client. Detail and statistical metrics for the Cluster, Namespaces, the Nodes, and the Secondary Indexes and Sets on the Nodes are collected.

Network Requirements

Port: 3000

The service port used by Aerospike DB and XDR

There are several default ports related to Aerospike DB. For more information about these, please refer to the Aerospike Network Configuration documentation.

Least Privileged User

The requirement for an LPU is a user that only has read permissions. For more information, please read the Aerospike documentation around Configuring Access Control

🚧

Access Control for Aerospike Databases

Access Control is only available with the Enterprise edition of Aerospike

Supported Versions

Aerospike DB: 3.9+

Connection Parameters

NameRequired?Description
HostRequiredAerospike node to connect to.
PortThe port for communication to the Aerospike Server.
SSL ConfigurationThe SSL mode to use when connecting to the target. Can be configured to not use SSL (No SSL), use SSL but do not verify the target's certificate (No Verify), or use SSL and verify the target's certificate (Verify).
Username
Password
Collect SetsWhether to collect set resources from Aerospike nodes.
Maximum Parallel RequestsMaximum number of requests to make to the Aerospike nodes at one time.

Connection Parameters

NameRequired?Description
HostRequiredAerospike node to connect to.
PortThe port for communication to the Aerospike Server.
SSL ConfigurationThe SSL mode to use when connecting to the target. Can be configured to not use SSL (No SSL), use SSL but do not verify the target's certificate (No Verify), or use SSL and verify the target's certificate (Verify).
Username
Password
Collect SetsWhether to collect set resources from Aerospike nodes.
Maximum Parallel RequestsMaximum number of requests to make to the Aerospike nodes at one time.

Metrics

Cluster

NameDescription
All Nodes HealthyWhether none of the nodes in the cluster are faulty or dead.
KeyRandom value generated by Aerospike to identify the cluster.
Maximum Clock Skew (Milliseconds)The maximum clock skew between nodes in the cluster.
Nodes QuiescedNumber of nodes in the cluster which are quiesced.
SizeNumber of nodes in the cluster.

Namespace

NameDescription
Available Bin NamesRemaining number of unique bins that can be created.
Average Query Aggregation Response Size (Records)Average number of records returned by the underlying query of query aggregations.
Average Secondary Index Query Response Size (Records)Average number of records returned by secondary index query lookups.
Basic Scan ErrorsNumber of failed basic scans.
Basic Scans AbortedNumber of basic scans which were aborted.
Basic Scans CompletedNumber of basic scans which were completed.
Batch Index Proxied Sub Transaction Errors (Errors)Number of proxied batch index sub transactions which failed with an error.
Batch Index Proxied Sub Transaction TimeoutsNumber of proxied batch index sub transactions which timed out.
Batch Index Proxied Sub Transactions CompletedNumber of proxied batch index sub transactions completed.
Batch Index Read ErrorsNumber of batch index read transactions which failed with an error.
Batch Index Read Not Found Errors (Errors)Number of batch index read sub transactions which failed with a 'record not found' error.
Batch Index Read Successes (Records)Number of records successfully read by batch index sub transactions.
Batch Index Read TimeoutsNumber of batch index read sub transactions which timed out.
Batch Index Transaction Errors (Errors)Number of batch index sub transactions which failed in the transaction service.
Batch Index Transaction TimeoutsNumber of batch index sub transactions which timed out in the transaction service.
Cache Read Ratio (%)Ratio of read transactions which are hit the post-write queue.
Client Delete Errors (Errors)Number of client delete transactions which failed with an error.
Client Delete Not Found Errors (Errors)Number of client delete transactions which failed with a 'record not found' error.
Client Delete Successes (Transactions)Number of successful client delete transactions.
Client Delete Timeouts (Transactions)Number of client delete transactions which resulted in a timeout.
Client Proxy Timeouts (Transactions)Number of successful client-initiated proxy transactions which completed.
Client Proxy Transaction Errors (Errors)Number of successful client-initiated proxy transactions which failed with an error.
Client Proxy Transactions Completed (Transactions)Number of successful client-initiated proxy transactions which completed.
Client Read Errors (Errors)Number of client-initiated read transactions which failed with an error.
Client Read Successes (Transactions)Number of successful client-initiated read transactions.
Client Read Timeouts (Transactions)Number of client-initiated read transactions which timed out.
Client Transaction Errors (Errors)Number of client-initiated transactions which failed with an error.
Client Transaction Timeouts (Transactions)Number of client-initiated transactions which timed out.
Client UDF Delete Successes (Transactions)Number of client-initiated UDF transactions which successfully deleted a record.
Client UDF Errors (Errors)Number of client-initiated UDF transactions which failed due to a Lua error in execution.
Client UDF Read Successes (Transactions)Number of successful client-initiated UDF read transactions.
Client UDF Transaction Errors (Errors)Number of client-initiated UDF transactions which failed with an error, not including timeouts.
Client UDF Transaction Timeouts (Transactions)Number of client-initiated UDF transactions which timed out.
Client UDF Transactions Completed (Transactions)Number of completed client-initiated UDF transactions.
Client UDF Write Successes (Transactions)Number of successful client-initiated UDF write transactions.
Client Write Errors (Errors)Number of client-initiated write transactions which failed with an error.
Client Write Successes (Transactions)Number of successful client-initiated write transactions.
Client Write Timeouts (Transactions)Number of client-initiated write transactions which timed out.
Contiguous Free Device Space Ratio (%)Amount of contiguous free blocks across all devices in the namespace, in proportion to all blocks across all devices in the namespace.
Data Memory Usage (Bytes)Amount of memory used data of the namespace on its node.
Dead PartitionsNumber of dead partitions in the namespace.
Deletes (Transactions)Delete operations performed in the namespace.
Device Compression RatioMoving average of the ratio of compressed size to uncompressed size.
Disk Space Available (Bytes)Disk space allocated to the namespace on its node.
Disk Space Used (Bytes)Disk space used by the namespace on its node.
Effective Replication FactorEffective replication factor of the namespace.
Emigration Instance ObjectsNumber of instance objects managing emigrations.
Emigration PartitionsNumber of partitions currently emigrating from the namespace on its node.
EvictionsNumber of objects that have been evicted from the namespace on its node since the server started.
ExpirationsNumber of objects that have expired from the namespace on its node since the server started.
Failed UDF QueriesNumber of UDF background queries which failed.
Free Device Space Ratio (%)Amount of free space across all devices in the namespace, in proportion to all space across all devices in the namespace.
Generation Check FailuresNumber of read/write transactions which failed on generation check.
High Watermark ExceededWhether the memory or disk high watermark is exceeded. When true, nodes will begin to evict data.
Hot Key FailuresNumber of read/write transactions which failed due to too many other transactions waiting to operate on the same record.
Immigration Instance ObjectsNumber of instance objects managing immigrations.
Immigration PartitionsNumber of partitions currently immigrating to the namespace on its node.
Index Memory Usage (Bytes)Amount of memory used by the index of the namespace on its node.
Initial Emigration PartitionsNumber of migrations the node will send during the current migration cycle for the namespace.
Initial Immigration PartitionsNumber of migrations the node will receive during the current migration cycle for the namespace.
Lead Migrations RemainingNumber of initially scheduled emigrations which are not delayed by the 'migrate-fill-delay' configuration.
Long Running QueriesNumber of long running queries in progress.
Long Running Query Queue Full Errors (Errors)Number of long running queries which encountered queue full errors.
Master Objects (Records)Number of records in the namespace on its node which are active masters.
Master Sub-ObjectsNumber of LDT sub-records in the namespace on its node which are active masters.
Master TombstonesNumber of tombstones in the namespace on its node which are active masters.
Memory Free (%)Amount of free memory for the namespace in proportion to its memory capacity.
Memory Usage (Bytes)Amount of memory used by the namespace on its node.
Migration Imbalance FailuresNumber of migration failures which may cause partitions to be imbalanced.
Migration Records Received (Records)Record insert requests received for the namespace on its node by immigration.
Migration Records Retransmitted (Records)Records retransmitted by emigration.
Migration Records Sent (Records)Records read and sent by emigration.
Migration Records Skipped (Records)Records that were not shipped due to the remote node already being up to date.
NameName of the namespace.
Namespace Supervisor Cycle Duration (Milliseconds)Duration of the most recent namespace supervisor cycle.
NodeName of the node containing the namespace.
Non-Expirable Objects (Records)Number of records with non-expirable TTLs.
Non-Replica Objects (Records)Number of records which are neither masters nor replicas.
Non-Replica Sub-Objects (Records)Number of LDT sub-records which are neither masters nor replicas.
Non-Replica TombstonesNumber of tombstones which are neither masters nor replicas.
Objects (Records)Number of records in the namespace, not including tombstones.
Query Aggregation Errors (Errors)Number of query aggregations attempted on the node which resulted in an error due to an internal error.
Query Aggregation SuccessesNumber of successful query aggregations completed on the node.
Query AggregationsNumber of query aggregations attempted on the node.
Query Aggregations AbortedNumber of query aggregations aborted by the user and seen by the node.
Query Errors (Errors)Number of queries attempted on the node which resulted in an error due to an internal error.
Query Requests (Requests)Number of query requests attempted on the node.
Quiesce PendingWhether the node has received the 'quiesce' command but has not yet quiesced.
Quiesced NodesNumber of Nodes which are quiesced.
Reads (Transactions)Read operations performed in the namespace.
Record Too Big FailuresNumber of write transactions which failed due to the record size being above the 'write-block-size' limit.
Records Deleted by Set (Records)Number of records deleted by a set.
Remaining Emigration PartitionsNumber of migrations not yet sent by the node for the namespace's current migration cycle.
Remaining Immigration PartitionsNumber of migrations not yet received by the node for the namespace's current migration cycle.
Replica Objects (Records)Number of records which are replicas on the node.
Replica Sub-Objects (Records)Number of LDT sub-records which are replicas on the node.
Replica TombstonesNumber of tombstones which are replicas on the node.
Scan Aggregation ErrorsNumber of failed scan aggregations.
Scan Aggregations AbortedNumber of scan aggregations which were aborted.
Scan Aggregations CompletedNumber of scan aggregations which were completed.
Secondary Index Memory Usage (Bytes)Amount of memory used by the secondary index of the namespace on its node.
Secondary Index QueriesNumber of secondary index query lookups attempted on the node.
Secondary Index Queries AbortedNumber of secondary index queries aborted by the user.
Secondary Index Query Errors (Errors)Number of secondary index query lookup errors.
Secondary Index Query SuccessesNumber of successful secondary index query lookups.
Short Running QueriesNumber of short running queries in progress.
Short Running Query Queue Full Errors (Errors)Number of short running queries which encountered queue full errors.
Sub-ObjectsNumber of LDT sub-objects.
Successful UDF QueriesNumber of successful UDF background queries.
TombstonesNumber of tombstones in the namespace on its node.
Truncated RecordsNumber of records which were deleted by truncation in the namespace.
UDF Background Scan ErrorsNumber of failed UDF background scans.
UDF Background Scans AbortedNumber of UDF background scans which were aborted.
UDF Background Scans CompletedNumber of UDF background scans which were completed.
UDF Delete Sub-Transaction SuccessesNumber of successful UDF delete sub-transactions.
UDF Sub-Transaction Errors (Errors)Number of UDF sub-transaction errors.
UDF Sub-Transaction Failures (Errors)Number of failed UDF sub-transactions, excluding timeouts.
UDF Read Sub-Transaction SuccessesNumber of successful UDF read sub-transactions.
UDF Sub-Transaction TimeoutsNumber of UDF sub-transactions which timed out.
UDF Sub-Transaction Transaction Errors (Errors)Number of UDF sub-transactions which failed with an error in the transaction service.
UDF Sub-Transaction Transaction TimeoutsNumber of UDF sub-transactions which timed out in the transaction service.
UDF Write Sub-Transaction SuccessesNumber of successful UDF write sub-transactions.
UDF Sub-Transactions CompletedNumber of completed UDF sub-transactions.
Writes (Transactions)Write operations performed in the namespace.
Writes StoppedWhether writes are currently disallowed for the namespace.

Node

NameDescription
AddressAddress of the node.
Batch Index Buffers AvailableNumber of batch index response buffers currently in the buffer pool and not in use.
Batch Index Buffers CreatedNumber of 128KB response buffers in response to batch index transactions.
Batch Index Buffers DestroyedNumber of batch index response buffers that have been destroyed due to the buffer pool size being above its limit.
Batch Index DelaysNumber of times a batch index response has been delayed.
Batch Index Errors (Errors)Number of batch index requests which completed with an error.
Batch Index Huge Buffers CreatedNumber of created batch index response buffers that were larger than 128KB.
Batch Index Requests (Requests)Number of batch index requests received.
Batch Index Requests Completed (Requests)Number of batch index requests completed by the node.
Batch Index TimeoutsNumber of batch index requests which timed out on the node before being processed.
Client Connections (Connections)Number of clients currently connected to the node.
Closed Idle Connections (Connections)Number of idle connections closed by the node.
Deletes (Transactions)Delete operations performed on the node.
Fabric Bulk Channel Received Throughput (Bytes per Second)Average data receive rate by the fabric bulk channel (migrations), over the configured ticker interval.
Fabric Bulk Channel Sent Throughput (Bytes per Second)Average data send rate by the fabric bulk channel (migrations), over the configured ticker interval.
Fabric Connections (Connections)Number of open fabric connections to the node.
Fabric Ctrl Channel Received Throughput (Bytes per Second)Average data receive rate by the fabric ctrl channel (paxos and migration control), over the configured ticker interval.
Fabric Ctrl Channel Sent Throughput (Bytes per Second)Average data send rate by the fabric ctrl channel (paxos and migration control), over the configured ticker interval.
Fabric Meta Channel Received Throughput (Bytes per Second)Average data receive rate by the fabric meta channel (system metadata), over the configured ticker interval.
Fabric Meta Channel Sent Throughput (Bytes per Second)Average data send rate by the fabric meta channel (system metadata), over the configured ticker interval.
Fabric RW Channel Received Throughput (Bytes per Second)Average data receive rate by the fabric rw channel (read/write transactions), over the configured ticker interval.
Fabric RW Channel Sent Throughput (Bytes per Second)Average data send rate by the fabric rw channel (read/write transactions), over the configured ticker interval.
Heap Active (Kibibytes)Memory allocated to in-use pages.
Heap Allocated (Kibibytes)Memory allocated to the asd daemon.
Heap Efficiency (%)Ratio of the size of allocated heap space to the process's resident set size.
Heap RSS (Kibibytes)Amount of memory allocated to the process which is in RAM.
Heartbeat Connections (Connections)Number of active heartbeat connections to the node.
Heartbeats ReceivedNumber of heartbeats received by the node.
Heartbeats SentNumber of heartbeats multicast by the node.
Info Requests CompletedNumber of info requests completed.
Info Requests QueuedNumber of info requests pending in the queue.
Long-Running QueriesNumber of long-running queries that have been attempted on the node.
Memory Free (%)Amount of free memory in proportion to the total memory available.
Migration Partitions RemainingNumber of partitions remaining to migrate.
Migrations AllowedWhether migrations are allowed to run on the node. Will be false if a rebalance is in progress.
NameServer node name.
ObjectsNumber of replicated objects on the node.
Pending Transactions (Transactions)Number of requests pending in the transaction queue on the node.
ProxiesNumber of proxies in progress on the node.
Read/Write Transactions In Progress (Transactions)Number of read/write transactions in progress on the node.
Reads (Transactions)Read operations performed on the node.
Scans (Transactions)Number of scans in progress on the node.
Secondary Index Entries ProcessedNumber of entries processed by the secondary index garbage collector.
Secondary Index Garbage CleanedNumber of secondary index garbage entries cleaned by its garbage collector.
Secondary Index Garbage Deletion Time (Milliseconds)Time spent cleaning secondary index garbage entries.
Secondary Index Garbage FoundNumber of secondary index garbage entries found by its garbage collector.
Short-Running QueriesNumber of short-running queries that have been attempted on the node.
Time Since Rebalance (Seconds)Time since the last reclustering event.
TombstonesNumber of tombstones on the node.
VersionVersion of Aerospike running on the node.
Writes (Transactions)Write operations performed on the node.

Secondary Index

NameDescription
Aggregation QueriesAggregation queries attempted for the secondary index on its node.
Average Lookup Query Record SizeAverage size of records returned by lookup queries against the secondary index.
Average Lookup Query Response Size (Records)Average number of records returned by lookup queries against the secondary index.
Average Query Aggregation Record SizeAverage size of records returned by the underlying query of query aggregations.
Average Query Aggregation Response Size (Records)Average number of records returned by the underlying query of query aggregations.
Average Query Record SizeAverage size of records returned by queries against the secondary index.
Average Query Response Size (Records)Average number of records returned by queries against the secondary index.
Collection TypeCollection type of the secondary index.
Creation Duration (Milliseconds)How long it took to fully create the secondary index.
Creation Progress (%)How much progress creation of the secondary index has made.
Delete Errors (Errors)Errors encountered while processing delete transactions.
Delete Successes (Transactions)Number of successful delete transactions.
Entries (Records)Number of records indexed by the secondary index.
Entry Size (Bytes)Memory consumed by the entries of the secondary index.
Garbage Collected Records (Records)Number of records which have been removed from memory by garbage collection.
Garbage Collection DurationTime spent in garbage collection for the secondary index.
Key Size (Bytes)Memory consumed by the keys of the secondary index.
KeysNumber of secondary keys in the secondary index.
Lookup QueriesNumber of lookup queries attempted against the secondary index.
NameName of the secondary index.
NamespaceNamespace of the secondary index.
NodeNode of the secondary index.
QueriesNumber of queries attempted against the secondary index.
SetSet that the secondary index is for.
Size (Bytes)Amount of memory consumed by the secondary index on its node.
StateState of the secondary index.
Successful Writes (Transactions)Number of successful write transactions for the secondary index.
TypeData type of the secondary index.
Write Errors (Errors)Number of errors encountered during write transactions for the secondary index.

Set

NameDescription
Data Size (Bytes)Memory used by the data part of the set. Will be 0 if data is not configured for storage in memory.
NameName of the set.
NamespaceNamespace containing the set.
NodeName of the node containing the set's namespace.
ObjectsNumber of objects in the set on its node, including master and all replicas.
TombstonesNumber of tombstones in the set on its node, including master and all replicas.
Truncate Last Update TimeBroadest truncation 'last update time' for the set.