Semantic Conventions for Cassandra

Status: Experimental

The Semantic Conventions for Cassandra extend and override the Database Semantic Conventions that describe common database operations attributes in addition to the Semantic Conventions described on this page.

db.system MUST be set to "cassandra".

Call-level attributes

AttributeTypeDescriptionExamplesRequirement Level
db.cassandra.consistency_levelstringThe consistency level of the query. Based on consistency values from CQL.allRecommended
db.cassandra.coordinator.dcstringThe data center of the coordinating node for a query.us-west-2Recommended
db.cassandra.coordinator.idstringThe ID of the coordinating node for a query.be13faa2-8574-4d71-926d-27f16cf8a7afRecommended
db.cassandra.idempotencebooleanWhether or not the query is idempotent.Recommended
db.cassandra.page_sizeintThe fetch size used for paging, i.e. how many rows will be returned at once.5000Recommended
db.cassandra.speculative_execution_countintThe number of times a query was speculatively executed. Not set or 0 if the query was not executed speculatively.0; 2Recommended
db.cassandra.tablestringThe name of the primary table that the operation is acting upon, including the keyspace name (if applicable). [1]mytableRecommended
db.namestringThe keyspace name in Cassandra. [2]mykeyspaceConditionally Required: If applicable.

[1]: This mirrors the db.sql.table attribute but references cassandra rather than sql. It is not recommended to attempt any client-side parsing of db.statement just to get this property, but it should be set if it is provided by the library being instrumented. If the operation is acting upon an anonymous table, or more than one table, this value MUST NOT be set.

[2]: For Cassandra the db.name should be set to the Cassandra keyspace name.

db.cassandra.consistency_level MUST be one of the following:

ValueDescription
allall
each_quorumeach_quorum
quorumquorum
local_quorumlocal_quorum
oneone
twotwo
threethree
local_onelocal_one
anyany
serialserial
local_seriallocal_serial