Event-name constants for the telemetry taxonomy emitted by this driver.

All events live under the [:aerospike, ...] namespace. Callers attach handlers via :telemetry.attach/4 (or :telemetry.attach_many/4) using the event names returned by the functions in this module. Emitters call :telemetry.span/3 or emit the concrete event names directly via :telemetry.execute/3 with those same names.

Using the constants from here is the contract. Handler code relies on these exact event names and metadata keys; emitters must not invent new names or forget to route through this module.

Span versus instant events

Functions whose name ends with _span return the prefix expected by :telemetry.span/3. :telemetry appends :start, :stop, or :exception itself, producing three event names per span:

prefix = Aerospike.Telemetry.pool_checkout_span()
:telemetry.span(prefix, start_metadata, fn ->
  {result, stop_metadata}
end)

Functions without the _span suffix return the full event name for an instant event dispatched via :telemetry.execute/3:

:telemetry.execute(
  Aerospike.Telemetry.node_transition(),
  measurements,
  metadata
)

Operators that want one handler for the whole driver can attach to handler_events/0, which expands the current taxonomy into concrete event names suitable for :telemetry.attach_many/4.

The Telemetry And Runtime Metrics guide provides the operator-facing metadata and measurement contract for each family.

Taxonomy

Span events (prefix + :start | :stop | :exception):

• [:aerospike, :pool, :checkout] — wraps every per-node pool checkout. Metadata: :node_name, :pool_pid, :telemetry_span_context. Measurements: :system_time and :monotonic_time on start; :duration on stop and exception.

• [:aerospike, :command, :send] — wraps the send side of a per-attempt command on the transport. Metadata: :node_name, :attempt (0-indexed, matching the retry driver), :deadline_ms. Measurements: :system_time on start; :duration on stop and exception.

• [:aerospike, :command, :recv] — wraps the receive side of a per-attempt command. Metadata: :node_name, :attempt, :deadline_ms. Measurements: :duration on stop and exception, plus :bytes metadata on stop.

• [:aerospike, :info, :rpc] — wraps every info RPC (Tender cycles and transport login/authenticate handshakes). Metadata: :node_name, :commands (the list of info keys requested, or [:login] for auth). Measurements: :system_time on start; :duration on stop and exception.

• [:aerospike, :tender, :tend_cycle] — wraps one full tend cycle. Cluster-wide (one pair per cycle). Metadata: none. Measurements: :system_time on start; :duration on stop and exception.

• [:aerospike, :tender, :partition_map_refresh] — wraps the partition-map refresh stage of the tend cycle (the most expensive sub-step). Cluster-wide, nested inside a :tend_cycle span. Metadata: none. Measurements: :system_time on start; :duration on stop and exception.

Instant events (dispatched via :telemetry.execute/3):

• [:aerospike, :node, :transition] — lifecycle flip for a node. Metadata: :node_name, :from (:active | :inactive | :unknown), :to (same enum), :reason (:bootstrap | :peer_discovery | :recovery | :failure_threshold | :dropped). Measurements: :system_time.

• [:aerospike, :retry, :attempt] — one event per retry attempt beyond the first. Metadata: :classification (:rebalance | :transport | :circuit_open), :attempt, :node_name. Measurements: :remaining_budget_ms.