Struct seella::Session

pub struct Session {
    pub id: Uuid,
    pub client: IpAddr,
    pub command: String,
    pub coordinator: IpAddr,
    pub duration: Duration,
    pub parameters: String,
    pub request: String,
    pub started_at: DateTime<Utc>,
    pub request_size: Option<u32>,
    pub response_size: Option<u32>,
    pub username: Option<String>,
    /* private fields */
}

All of the information related to a single tracing session.

This is effectively:

SELECT * FROM system_traces.sessions WHERE session_id=227aff60-4f21-11e6-8835-000000000000
JOIN
SELECT * FROM system_traces.events WHERE session_id=227aff60-4f21-11e6-8835-000000000000

This gives us all possible tracing information for a single session, where that session may be a single query, or some other command.

Events can be accessed through the Session::events() method, and these will be presented depth-first; i.e. we provide the children of the first root trace before moving on to the second root trace.

Fields

id: Uuid

The UUID of the Session

client: IpAddr

The IP address of the connecting client

command: String

Currently, this can only be “QUERY”

coordinator: IpAddr

The IP address of the coordinating Scylla Node

duration: Duration

Total duration of the Session

parameters: String

A scylla map containing string pairs that describe the query

request: String

A short string decribing the Session. Is not the CQL query being ran; that is in parameters.

started_at: DateTime<Utc>

DateTime of the start of this tracing session

request_size: Option<u32>

Size of the request Since Scylla 3.0 Not present in Cassandra

response_size: Option<u32>

Size of the response Since Scylla 3.0 Not present in Cassandra

username: Option<String>

The username associated with the request? Lacking documentation. Not present in Cassandra

Implementations

impl Session

pub fn event_count(&self) -> usize

Recurses the tree of events without needing to allocate or otherwise work too hard.

pub fn events(&self) -> Vec<(&Event, usize)>

Depth-first recursion of all events in the tree.

pub fn total_duration(&self) -> i64

Returns the total duration of the trace.

Given by summing the total durations of all root traces.

pub fn display(&self, cli: Cli, w: &mut dyn Write) -> Result<()>

Trait Implementations

impl Debug for Session

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.