Aerospike Graph Service Release Notes 3.1.0

October 29, 2025  |  Download

New in this version

Aerospike Graph Service 3.1.0 adds transaction support for Gremlin workloads, improves strategy application speed and lowers tail latency, refines operational controls, and improves visibility into supernode-heavy traversals.

New features

• TinkerPop transaction support - Added support for TinkerPop transactions. [GRAPH-1652]
• Separate string and numeric indexes - Added support for creating separate string and numeric vertex property indexes. [GRAPH-1671]

Performance enhancements

• Lower tail latency - Reduced the parallel reading threshold from 4 records per node to 1 record per node. [GRAPH-1678]
• Faster strategy application - Improved strategy application speed by approximately 5 times, reducing execution time for low-latency queries by up to 20 percent. [GRAPH-1644]
• Known-vertex edge optimization - Added an optimization for obtaining edges between known vertices, for example:
  g.V(id1).outE().where(__.inV().hasId(id2)). [GRAPH-1588]
• mergeV batching - mergeV now batches writes for all properties in match and create options to improve performance when many properties are present. [GRAPH-1675]
• Faster mergeE execution - Greatly improved mergeE speed by reducing distributed lock overhead. [GRAPH-1646]

Configuration and operational updates

• Batch read and pagination tuning - Reworked batch reading and pagination configuration. [GRAPH-1694]
  • Introduced aerospike.graph.pagination.page.size.per-node.
  • aerospike.graph.pagination.page.size now defaults to 0 (disabled).
  • Introduced aerospike.client.batch.read.size.per-node.
  • aerospike.client.batch.read.size now defaults to 0 (disabled).
• Query policy naming updates - Renamed configuration options for query policies. [GRAPH-1660]
  • aerospike.client.policy.index.totalTimeout → aerospike.client.policy.query.totalTimeout
  • aerospike.client.policy.index.socketTimeout → aerospike.client.policy.query.socketTimeout
  • aerospike.client.policy.index.connectTimeout → aerospike.client.policy.query.connectTimeout
  • aerospike.client.policy.index.timeoutDelay → aerospike.client.policy.query.timeoutDelay
• mergeE validation - Improved error handling and messages when attempting to use mergeE while the Aerospike configuration has nsup disabled or when TTL behavior without nsup is disabled. [GRAPH-1622]

Observability

• Admin metadata modes - Added a mode parameter to the aerospike.graph.admin.metadata.config admin call step. [GRAPH-1567]
  • full returns the entire configuration, including defaults.
  • delta returns only values that differ from defaults.
• Supernode traversal metric - Added a metric for supernodes traversed. [GRAPH-1566]

Bug fixes

• Mixed element stream fix - Resolved an issue where a mixed element stream searching for an invalid property key could slow down a query. [GRAPH-1688]
• mergeE label propagation fix - Fixed a mergeE issue where labels were not propagating, for example:
  g.mergeE(...).option(...).as("label_example"). [GRAPH-1629]
• TTL log volume adjustments - Reduced the number of error entries under heavy load when TTL activity increases by adjusting default page sizing. [GRAPH-1645]
• Upgrade stability improvements - Fixed an issue during upgrades from 2.x to 3.x that could break secondary index queries. [GRAPH-1635]