Skip to main content
Loading

Working with the Aerospike Monitoring Stack dashboards

Using locations, types, and labelsโ€‹

Metrics data from Aerospike is described by the location API that generated the metric. Metrics are further described by type for the scope, data type, and duration of the data. Each metric also may have labels that allow for sorting and filtering.

For a complete list of metrics available, see the Metrics Reference.

Locationโ€‹

Each metric is described for a location that refers to the API that generated the metric and corresponds to the asadm show command parameter. The Aerospike Prometheus Exporter prepends the metric with a string to identify the location. For example, the metric conns_in_use, generated for the Users location, becomes aerospike_users_conns_in_use when exported from a node. Following are the locations mapped to the string prefixes prepended by the Exporter. Use a metric with its exported prefix when creating alerts or displaying the metric in a dashboard.

LocationExported prefix
Binsaerospike_namespace_
Namespaceaerospike_namespace_
Setsaerospike_sets_
Sindexaerospike_sets_
Statisticsaerospike_node_stats_
Usersaerospike_users_
XDRaerospike_xdr_
XDR - DCaerospike_xdr_

Typeโ€‹

The Metrics Reference also describes the types that apply to a specific metric. These are shown with colored highlighting in the upper right corner of the metric's reference entry. Types describe the Aerospike Database edition, the data duration, and the data type for the metric.

Editionโ€‹

When the enterprise edition label is shown, the metric is available only in Aerospike Enterprise Edition. Otherwise, the metric is available for all Aerospike editions.

Durationโ€‹

  • instantaneous - the data is measured at a specific instant. For example, the memory_used_bytes metric is an instantaneous measure of the total bytes of memory used.

  • cumulative - the data is accumulated from the last restart. For example, the batch_sub_delete_error metric reports the accumulated subtransactions that failed with an error since the last restart.

  • moving average - the data reported is a moving average of all values since the last restart. For example, the device_compression_ratio measures the average compressed size to uncompressed size ratio since the last restart.

Data typeโ€‹

  • integer

  • decimal

  • boolean

Labelsโ€‹

Metrics may also be described with labels in queries on the command line or in a dashboard. You can sort and filter metric data based on these labels. Following are some of the more prominent labels used in Aerospike:

  • ns - corresponds to the specific namespace of the metric.

  • set - a group of records within a collection.

  • job_name - a label you can set on the Aerospike Prometheus Exporter. aerospike is the default. The label is customizable.

  • cluster_name - corresponds to the name set for in your cluster configuration. It is required for monitoring multiple clusters.

  • service - IP:port of the nodes.

  • instance - IP:port of the Exporter on the node.

Example PromQL query used in the dashboardโ€‹

An example query to compute and view transactions per second (TPS) for Aerospike read operations is detailed here.

The query passes the following parameters to the rate() function:

  • The metric name aerospike_namespace_client_read_success.
  • The job label as aerospike.
  • The cluster_name label as aerospike-release-aerospike-enterprise.
rate(aerospike_namespace_client_read_success{job="aerospike", cluster_name="aerospike-release-aerospike-enterprise"}[1m])+
rate(aerospike_namespace_client_read_not_found{job="aerospike", cluster_name="aerospike-release-aerospike-enterprise"}[1m])

Query resultsโ€‹

The query returns the per-second average rate of increase in TPS for Aerospike reads.

The following results are displayed in the dashboard.

Dashboard example console

Example graphโ€‹

Dashboard example graph

Other operations on the dashboardโ€‹

In addition to queries, you can also check the status of scrape targets, alert rules, configuration, and more.

Dashboard status menu