Skip to content
Visit booth 3171 at Google Cloud Next to see how to unlock real-time decisions at scaleMore info

Vector Metrics Reference

Metrics reference for Aerospike Vector Search

Application

batch_error
Context
-
Prometheus Name
aerospike_vector_search_batch_requests
Description

Number of batch direct requests that were rejected because of errors.

Introduced
1.0
Removed
-
Measurement type
counter
Data type
integer
Labels
cluster_name
cluster_created_timestamp
Context
-
Prometheus Name
aerospike_vector_search_cluster_created_timestamp
Description

Indicates the date and time when the cluster was created.

Introduced
1.0
Removed
-
Measurement type
gauge
Data type
integer
Labels
cluster_name
cluster_key
Context
-
Prometheus Name
aerospike_vector_search_cluster_key
Description

Randomly generated 64-bit hexadecimal string to identify the AVS cluster.

Introduced
1.0
Removed
-
Measurement type
gauge
Data type
integer
Labels
cluster_name
cluster_size
Context
-
Prometheus Name
aerospike_vector_search_cluster_size
Description

Size of the cluster. Can be checked to make sure the cluster size is what you expect after adding or removing a node. Check across all nodes in a cluster.

Introduced
1.0
Removed
-
Measurement type
gauge
Data type
integer
Labels
cluster_name
connections_active
Context
-
Prometheus Name
aerospike_vector_search_connections
Description

Number of active client connections to AVS.

Introduced
1.0
Removed
-
Measurement type
counter
Data type
integer
Labels
cluster_name
healer_cycle
Context
healer
Prometheus Name
aerospike_vector_search_healer_cycle
Description

Details of an AVS healer cycle. To extract relevant meaning, filter within this metric using one or more of the following filter labels.

  • type reports details of the healer as one of the following:

    • cycle-time time it takes for a healer cycle to complete

    • total-time total time spent by the healer

    • enqueue-index-in number of items that the healer has proxied into an AVS node for re-indexing

    • enqueue-index-out number of items that the healer has proxied out to another node for re-indexing

    • enqueue-index-local number of items re-indexed on the node

Introduced
1.0
Removed
-
Measurement type
gauge
Data type
integer
Labels
cluster_nametype
heartbeats_adjacency_size
Context
-
Prometheus Name
aerospike_vector_search_heartbeats_adjacency_size
Description

Introduced
1.0
Removed
-
Measurement type
gauge
Data type
integer
Labels
cluster_name
heartbeats_received
Context
-
Prometheus Name
aerospike_vector_search_heartbeats_received
Description

The number of heartbeats received from other cluster instances.

Introduced
1.0
Removed
-
Measurement type
counter
Data type
integer
Labels
cluster_name
heartbeats_sent
Context
-
Prometheus Name
aerospike_vector_search_heartbeats_sent
Description

The number of heartbeats sent to other cluster instances.

Introduced
1.0
Removed
-
Measurement type
counter
Data type
integer
Labels
cluster_name
hlc
Context
-
Prometheus Name
aerospike_vector_search_hlc
Description

Introduced
1.0
Removed
-
Measurement type
gauge
Data type
integer
Labels
cluster_name
indexing_queue_size
critical
Context
-
Prometheus Name
aerospike_vector_search_indexing_queue_size
Description

Queue depth of metrics currently being index by Aerospike Vector Search. The maximum queue depth is 1,000,000. Exceeding this limit results in a resource exhausted error.

Monitoring

This value is configured using the max-mem-queue-size property on the AVS node or the index. The default value is 1,000,000.

Introduced
1.0
Removed
-
Measurement type
counter
Data type
integer
Labels
cluster_name
internal_connections_active
Context
-
Prometheus Name
aerospike_vector_search_internal_connections
Description

Introduced
1.0
Removed
-
Measurement type
counter
Data type
integer
Labels
cluster_name
node_id
Context
-
Prometheus Name
aerospike_vector_search_node_id
Description

Introduced
1.0
Removed
-
Measurement type
gauge
Data type
integer
Labels
cluster_name
requests
critical
Context
-
Prometheus Name
aerospike_vector_search_requests
Description

Number of requests on a given Aerospike Vector Search node. Filter within this metric to extract relevant meaning. Some labels support additional filters, as noted below:

  • type filters the different request types, which include query, batch_merge, is-indexed, delete, update, exists, read, and write. Since inbound and outbound proxying are accounted for, this metric can be greater than the actual volume of requests.
  • update_type or query_type provide more information about the behavior of an update or query, and can be one of the following:
    • client is a request from the client.
    • local request performed on the node.
    • proxy-out request routed out to another node.
    • proxy-in request routed in from another node.
  • status can be error, success, queued, malformed, or unauthenticated-error.
Monitoring

Monitoring depends on your use case. Consider monitoring for errors, queries per second (QPS), or ingest rate using this metric with filters. The following expression illustrates monitoring for QPS.

Expression
rate(aerospike_vector_search_requests{type="query", status="success"}[$__rate_interval])
Introduced
1.0
Removed
-
Measurement type
counter
Data type
integer
Labels
cluster_namequery_typeupdate_typestatustype
users
Context
-
Prometheus Name
aerospike_vector_search_users
Description

Introduced
1.0
Removed
-
Measurement type
counter
Data type
integer
Labels
cluster_name
vector_records
optional
Context
vector_records
Prometheus Name
aerospike_vector_search_vector_records
Description

Number of records processed by a standalone indexer or the healer.

  • status can be one of the following:
    • indexed - number of records successfully indexed
    • scanned - number of records eligible to be indexed
    • unindexed - number of records eligible that are not yet indexed
    • batch-merge-pending - number of records waiting to be merged into the index
    • reindexed - number of records re-indexed by the healer
Introduced
1.1
Removed
-
Measurement type
gauge
Data type
integer
Labels
cluster_nameindexstatus

Index

cache_evictions
Context
index
Prometheus Name
aerospike_vector_search_index_cache_evictions
Description

Number of objects evicted from the index cache on this node since AVS started.

Introduced
1.0
Removed
-
Measurement type
histogram
Data type
integer
Labels
cluster_nameindex
cache_evictions_collected
Context
index
Prometheus Name
aerospike_vector_search_index_cache_evictions_collected
Description

Total number of objects evicted from the index cache on this node.

Introduced
1.0
Removed
-
Measurement type
histogram
Data type
integer
Labels
cluster_nameindex
cache_evictions_collected_count
Context
index
Prometheus Name
aerospike_vector_search_index_cache_evictions_collected_count
Description

Count of events that have been observed for cache_evictions_collected.

Introduced
1.0
Removed
-
Measurement type
histogram
Data type
integer
Labels
cluster_nameindex
cache_evictions_expired
Context
index
Prometheus Name
aerospike_vector_search_index_cache_evictions_expired
Description

Introduced
1.0
Removed
-
Measurement type
histogram
Data type
integer
Labels
cluster_nameindex
cache_evictions_expired_count
Context
index
Prometheus Name
aerospike_vector_search_index_cache_evictions_expired_count
Description

Count of events that have been observed for cache_evictions_expired.

Introduced
1.0
Removed
-
Measurement type
histogram
Data type
integer
Labels
cluster_nameindex
cache_evictions_explicit
Context
index
Prometheus Name
aerospike_vector_search_index_cache_evictions_explicit
Description

Introduced
1.0
Removed
-
Measurement type
histogram
Data type
integer
Labels
cluster_nameindex
cache_evictions_explicit_count
Context
index
Prometheus Name
aerospike_vector_search_index_cache_evictions_explicit_count
Description

Count of events that have been observed for cache_evictions_explicit.

Introduced
1.0
Removed
-
Measurement type
histogram
Data type
integer
Labels
cluster_nameindex
cache_evictions_replaced
Context
index
Prometheus Name
aerospike_vector_search_index_cache_evictions_replaced
Description

Introduced
1.0
Removed
-
Measurement type
histogram
Data type
integer
Labels
cluster_nameindex
cache_evictions_replaced_count
Context
index
Prometheus Name
aerospike_vector_search_index_cache_evictions_replaced_count
Description

Count of events that have been observed for cache_evictions_replaced.

Introduced
1.0
Removed
-
Measurement type
histogram
Data type
integer
Labels
cluster_nameindex
cache_evictions_size
Context
index
Prometheus Name
aerospike_vector_search_index_cache_evictions_size
Description

Introduced
1.0
Removed
-
Measurement type
histogram
Data type
integer
Labels
cluster_nameindex
cache_evictions_size_count
Context
index
Prometheus Name
aerospike_vector_search_index_cache_evictions_size_count
Description

Count of events that have been observed for cache_evictions_size.

Introduced
1.0
Removed
-
Measurement type
histogram
Data type
integer
Labels
cluster_nameindex
cache_evictions_weight
Context
index
Prometheus Name
aerospike_vector_search_index_cache_evictions_weight
Description

Introduced
1.0
Removed
-
Measurement type
counter
Data type
integer
Labels
cluster_nameindex
cache_hits
Context
index
Prometheus Name
aerospike_vector_search_index_cache_hits
Description

Introduced
1.0
Removed
-
Measurement type
counter
Data type
integer
Labels
cluster_nameindex
cache_loads_failure
Context
index
Prometheus Name
aerospike_vector_search_index_cache_loads_failure
Description

Introduced
1.0
Removed
-
Measurement type
timer
Data type
integer
Labels
cluster_nameindex
cache_loads_failure_count
Context
index
Prometheus Name
aerospike_vector_search_index_cache_loads_failure_count
Description

Count of events that have been observed for cache_loads_failure.

Introduced
1.0
Removed
-
Measurement type
timer
Data type
integer
Labels
cluster_nameindex
cache_loads_success
Context
index
Prometheus Name
aerospike_vector_search_index_cache_loads_success
Description

Introduced
1.0
Removed
-
Measurement type
timer
Data type
integer
Labels
cluster_nameindex
cache_loads_success_count
Context
index
Prometheus Name
aerospike_vector_search_index_cache_loads_success_count
Description

Count of events that have been observed for cache_loads_success.

Introduced
1.0
Removed
-
Measurement type
timer
Data type
integer
Labels
cluster_nameindex
cache_misses
Context
index
Prometheus Name
aerospike_vector_search_index_cache_misses
Description

Introduced
1.0
Removed
-
Measurement type
counter
Data type
integer
Labels
cluster_nameindex
Feedback

Was this page helpful?

What type of feedback are you giving?

What would you like us to know?

+Capture screenshot

Can we reach out to you?