> ## Documentation Index
> Fetch the complete documentation index at: https://otel.fyi/llms.txt
> Use this file to discover all available pages before exploring further.

# Aerospike

> OpenTelemetry receiver for Aerospike

# Aerospike Receiver

![Status](https://img.shields.io/badge/status-alpha-red)

**Available in:** `contrib`

**Maintainers:** [@antonblock](https://github.com/antonblock)

**Source:** [opentelemetry-collector-contrib](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/aerospikereceiver)

## Supported Telemetry

![Metrics](https://img.shields.io/badge/metrics-alpha-green)

## Overview

The Aerospike Receiver uses the [official Go client](https://github.com/aerospike/aerospike-client-go/tree/v5/) to
connect and collect.

Aerospike versions 4.9, 5.x, and 6.x are supported.

## Configuration

Configuration parameters:

* `endpoint` (default localhost:3000): Aerospike host ex: 127.0.0.1:3000.
* `tlsname` Endpoint tls name. Used by the client during TLS connections. See [Aerospike authentication](https://docs.aerospike.com/server/guide/security/tls#standard-authentication) for mor details.
* `collect_cluster_metrics` (default false): Whether discovered peer nodes should be collected.
* `collection_interval` (default = 60s): This receiver collects metrics on an interval. Valid time units are ns, us (or µs), ms, s, m, h.
* `initial_delay` (default = `1s`): defines how long this receiver waits before starting.
* `username` (Enterprise Edition only.)
* `password` (Enterprise Edition only.)
* `tls` (default empty/no tls) tls configuration for connection to Aerospike nodes. More information at [OpenTelemetry's tls config page](https://github.com/open-telemetry/opentelemetry-collector/blob/main/config/configtls/README.md).

### Example Configuration

```yaml theme={null}
receivers:
    aerospike:
        endpoint: "localhost:3000"
        tlsname: ""
        collect_cluster_metrics: false
        collection_interval: 30s
```

## Metrics

Details about the metrics produced by this receiver can be found in [metadata.yaml](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/aerospikereceiver/metadata.yaml)

## Metrics

| Metric Name | Description | Unit | Type | Attributes |
| - | - | - | - | - |
| ✅ `aerospike.namespace.disk.available` | Minimum percentage of contiguous disk space free to the namespace across all devices | % | Gauge | |
| ✅ `aerospike.namespace.geojson.region_query_cells` | Number of cell coverings for query region queried | \{cells} | Counter | |
| ✅ `aerospike.namespace.geojson.region_query_false_positive` | Number of points outside the region. | \{points} | Counter | |
| ✅ `aerospike.namespace.geojson.region_query_points` | Number of points within the region. | \{points} | Counter | |
| ✅ `aerospike.namespace.geojson.region_query_requests` | Number of geojson queries on the system since the uptime of the node. | \{queries} | Counter | |
| ✅ `aerospike.namespace.memory.free` | Percentage of the namespace's memory which is still free | % | Gauge | |
| ✅ `aerospike.namespace.memory.usage` | Memory currently used by each component of the namespace | By | UpDownCounter | namespace\_component |
| ✅ `aerospike.namespace.query.count` | Number of query operations performed on the namespace | \{queries} | Counter | query\_type, index\_type, query\_result |
| ✅ `aerospike.namespace.scan.count` | Number of scan operations performed on the namespace | \{scans} | Counter | scan\_type, scan\_result |
| ✅ `aerospike.namespace.transaction.count` | Number of transactions performed on the namespace | \{transactions} | Counter | transaction\_type, transaction\_result |
| ✅ `aerospike.node.connection.count` | Number of connections opened and closed to the node | \{connections} | Counter | connection\_type, connection\_op |
| ✅ `aerospike.node.connection.open` | Current number of open connections to the node | \{connections} | UpDownCounter | connection\_type |
| ✅ `aerospike.node.memory.free` | Percentage of the node's memory which is still free | % | Gauge | |
| ✅ `aerospike.node.query.tracked` | Number of queries tracked by the system. | \{queries} | Counter | |

## Attributes

| Attribute Name | Description | Type | Values |
| - | - | - | - |
| `operation` | Operation performed with a connection (open or close) | string | `close`, `open` |
| `type` | Type of connection to an Aerospike node | string | `client`, `fabric`, `heartbeat` |
| `index` | Type of index the operation was performed on | string | `primary`, `secondary` |
| `component` | Individual component of a namespace | string | `data`, `index`, `set_index`, `secondary_index` |
| `result` | Result of a query operation performed on a namespace | string | `abort`, `complete`, `error`, `timeout` |
| `type` | Type of query operation performed on a namespace | string | `aggregation`, `basic`, `short`, `long_basic`, `short_basic`, `ops_background`, `udf_background` |
| `result` | Result of a scan operation performed on a namespace | string | `abort`, `complete`, `error` |
| `type` | Type of scan operation performed on a namespace | string | `aggregation`, `basic`, `ops_background`, `udf_background` |
| `result` | Result of a transaction performed on a namespace | string | `error`, `filtered_out`, `not_found`, `success`, `timeout` |
| `type` | Type of transaction performed on a namespace | string | `delete`, `read`, `udf`, `write` |

## Resource Attributes

| Attribute Name | Description | Type | Enabled |
| - | - | - | - |
| `aerospike.namespace` | Name of the Aerospike namespace | string | ✅ |
| `aerospike.node.name` | Name of the Aerospike node collected from | string | ✅ |

## Configuration

### Example Configuration

```yaml theme={null}
aerospike:
  endpoint: "localhost:3000"
  tlsname: ""
  collect_cluster_metrics: false
  collection_interval: 30s
```

***

*Last generated: 2026-10-05*