Struct ResourceSpan 

pub struct ResourceSpan {

    pub name: String,
    pub trace_context: TraceContext,
    pub parent_span_id: Option<SpanId>,
    pub start_time_unix_us: u64,
    pub end_time_unix_us: u64,
    pub status: SpanStatus,
    pub lease_ids: Vec<u128>,
    pub ops: Vec<(OpKey, u64)>,
    pub bytes_read: u64,
    pub bytes_written: u64,
    pub lease_cost_byte_secs: u64,
    pub lease_acquire_wait_us: u64,
    pub attributes: Vec<(String, String)>,
}

A resource-attributed span carrying grafOS-specific metadata.

Populated automatically by lease API instrumentation hooks and the #[grafos::instrument] proc macro. Exported to OTel collectors via the otlp exporter (requires otlp feature).

Fields

name: String

Human-readable name for this span (usually the function name).

trace_context: TraceContext

Trace context (trace_id + span_id + flags).

parent_span_id: Option<SpanId>

Parent span ID (if this span has a parent in the same service).

start_time_unix_us: u64

Start time as Unix microseconds.

end_time_unix_us: u64

End time as Unix microseconds.

status: SpanStatus

Completion status.

lease_ids: Vec<u128>

Lease IDs touched during this span.

ops: Vec<(OpKey, u64)>

Operation counts by (resource_type, op_type).

bytes_read: u64

Total bytes read across all lease operations in this span.

bytes_written: u64

Total bytes written across all lease operations in this span.

lease_cost_byte_secs: u64

Sum of (leased_bytes * seconds_held) for all leases in this span.

lease_acquire_wait_us: u64

Time spent waiting for lease acquisition, in microseconds.

attributes: Vec<(String, String)>

User-defined key-value attributes.

Implementations

impl ResourceSpan

pub fn new(name: &str, trace_context: TraceContext) -> Self

Create a new span with the given name and trace context.

pub fn duration_us(&self) -> u64

Duration in microseconds.

pub fn record_op( &mut self, resource_type: ResourceType, op_type: OpType, count: u64, )

Record an operation.

pub fn op_count(&self, resource_type: ResourceType, op_type: OpType) -> u64

Get the operation count for a specific (resource_type, op_type) pair.

pub fn add_lease_id(&mut self, lease_id: u128)

Add a lease ID to the span’s lease list.

pub fn set_attribute(&mut self, key: &str, value: &str)

Add a user-defined attribute.

pub fn trace_id(&self) -> TraceId

Convenience: trace ID from the context.

pub fn span_id(&self) -> SpanId

Convenience: span ID from the context.

Trait Implementations

impl Clone for ResourceSpan

fn clone(&self) -> ResourceSpan

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ResourceSpan

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

Formats the value using the given formatter.