ScyllaDB University Live | Free Virtual Training Event
Learn more
ScyllaDB Documentation Logo Documentation
  • Server
  • Cloud
  • Tools
    • ScyllaDB Manager
    • ScyllaDB Monitoring Stack
    • ScyllaDB Operator
  • Drivers
    • CQL Drivers
    • DynamoDB Drivers
  • Resources
    • ScyllaDB University
    • Community Forum
    • Tutorials
Download
ScyllaDB Docs Scylla Rust Driver Query tracing

Caution

You're viewing documentation for a deprecated version of Scylla Rust Driver. Switch to the latest stable version.

Query tracing¶

The driver has utilities for monitoring the execution of queries. There are two separate ways to get information about what happened with a query: Tracing and Query Execution History.

Tracing¶

Tracing is a feature provided by Scylla. When sending a query we can set a flag that signifies that we would like it to be traced. After completing the query Scylla provides a tracing_id which can be used to fetch information about it - which nodes it was sent to, what operations were performed etc.

Queries that support tracing:

  • Session::query_unpaged()

  • Session::query_iter()

  • Session::execute_unpaged()

  • Session::execute_iter()

  • Session::batch()

  • Session::prepare()

After obtaining the tracing id you can use Session::get_tracing_info() to query tracing information.
TracingInfo contains values that are the same in Scylla and Cassandra®, skipping any database-specific ones.
If TracingInfo does not contain some needed value it’s possible to query it manually from the tables system_traces.sessions and system_traces.events

Query Execution History¶

Tracing provides information about how the query execution went on database nodes, but it doesn’t say anything about what was going on inside the driver.
This is what query execution history was made for.

It allows to follow what the driver was thinking - all query attempts, retry decisions, speculative executions. More information is available in the Query Execution History chapter.

Was this page helpful?

PREVIOUS
Logging
NEXT
Tracing a simple/prepared/batch query
  • Create an issue
  • Edit this page

On this page

  • Query tracing
    • Tracing
    • Query Execution History
Scylla Rust Driver
  • v1.0.0
    • main
    • v1.1.0
    • v1.0.0
  • Scylla Rust Driver
  • Quick Start
    • Creating a project
    • Connecting and running a simple query
    • Running Scylla using Docker
  • Connecting to the cluster
    • Compression
    • Authentication
    • TLS
  • Executing CQL statements - best practices
    • Unprepared statement
    • Statement values
    • Query result
    • Prepared statement
    • Batch statement
    • Paged query
    • USE keyspace
    • Schema agreement
    • Lightweight transaction (LWT) statement
    • Request timeouts
    • Timestamp generators
  • Execution profiles
    • Creating a profile and setting it
    • All options supported by a profile
    • Priorities of execution settings
    • Remapping execution profile handles
  • Data Types
    • Bool, Tinyint, Smallint, Int, Bigint, Float, Double
    • Ascii, Text, Varchar
    • Counter
    • Blob
    • Inet
    • Uuid
    • Timeuuid
    • Date
    • Time
    • Timestamp
    • Duration
    • Decimal
    • Varint
    • List, Set, Map
    • Tuple
    • User defined types
  • Load balancing
    • DefaultPolicy
  • Retry policy configuration
    • Fallthrough retry policy
    • Default retry policy
    • Downgrading consistency retry policy
  • Speculative execution
    • Simple speculative execution
    • Percentile speculative execution
  • Driver metrics
  • Migration guides
    • Adjusting code to changes in serialization API introduced in 0.11
    • Adjusting code to changes in deserialization API introduced in 0.15
  • Logging
  • Query tracing
    • Tracing a simple/prepared/batch query
    • Tracing a paged query
    • Tracing Session::prepare
    • Query Execution History
  • Schema
Docs Tutorials University Contact Us About Us
© 2025, ScyllaDB. All rights reserved. | Terms of Service | Privacy Policy | ScyllaDB, and ScyllaDB Cloud, are registered trademarks of ScyllaDB, Inc.
Last updated on 08 May 2025.
Powered by Sphinx 7.4.7 & ScyllaDB Theme 1.8.6