#[non_exhaustive]pub struct Span {
pub duration: Option<i64>,
pub end_time: Option<i64>,
pub end_time_dt: Option<String>,
pub message: Option<String>,
pub operation: Option<String>,
pub parent_uid: Option<String>,
pub service: Option<Box<Service>>,
pub start_time: Option<i64>,
pub start_time_dt: Option<String>,
pub status_code: Option<String>,
pub uid: Option<String>,
}Expand description
Span
Represents a single unit of work or operation within a distributed trace. A span typically tracks the execution of a request across a service, capturing important details such as the operation, timestamps, and status. Spans help break down the overall trace into smaller, manageable parts, enabling detailed analysis of the performance and behavior of specific operations within the system. They are crucial for understanding latency, dependencies, and bottlenecks in complex distributed systems.
[] Category: | Name: span
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.duration: Option<i64>Duration Milliseconds
The total time, in milliseconds, that the span represents, calculated as the difference between start_time and end_time. It reflects the operation’s performance and latency, independent of event timestamps, and accounts for normalized times used by observability tools to ensure consistency across distributed systems.
optional
end_time: Option<i64>End Time
The end timestamp of the span, essential for identifying latency and performance bottlenecks. Like the start time, this timestamp is normalized across the observability system to ensure consistency, even when events are recorded across distributed services with unsynchronized clocks. Normalized time allows for accurate duration calculations and helps observability tools track performance across services, regardless of the individual system time settings.
required
end_time_dt: Option<String>End Time
The end timestamp of the span, essential for identifying latency and performance bottlenecks. Like the start time, this timestamp is normalized across the observability system to ensure consistency, even when events are recorded across distributed services with unsynchronized clocks. Normalized time allows for accurate duration calculations and helps observability tools track performance across services, regardless of the individual system time settings.
optional
message: Option<String>Message
The message in a span (often referred to as a span event) serves as a way to record significant moments or occurrences during the span’s lifecycle. This content typically manifests as log entries, annotations, or semi-structured events as a string, providing additional granularity and context about what happens at specific points during the execution of an operation.
optional
operation: Option<String>Operation
Describes an action performed in a span, such as API requests, database queries, or computations.
optional
parent_uid: Option<String>Parent Unique ID
The ID of the parent span for this span object, establishing its relationship in the trace hierarchy.
optional
service: Option<Box<Service>>Service
Identifies the service or component that generates the span, helping trace its path through the distributed system.
optional
start_time: Option<i64>Start Time
The start timestamp of the span, essential for identifying latency and performance bottlenecks. This timestamp is normalized across the observability system, ensuring consistency even when events occur across distributed services with potentially unsynchronized clocks. By using normalized time, observability tools can provide accurate, uniform measurements of operation performance and latency, regardless of where or when the events actually occur.
required
start_time_dt: Option<String>Start Time
The start timestamp of the span, essential for identifying latency and performance bottlenecks. This timestamp is normalized across the observability system, ensuring consistency even when events occur across distributed services with potentially unsynchronized clocks. By using normalized time, observability tools can provide accurate, uniform measurements of operation performance and latency, regardless of where or when the events actually occur.
optional
status_code: Option<String>Status Code
Indicates the outcome of the operation in the span, such as success, failure, or error. Issues in a span typically refer to problems such as failed operations, timeouts, service unavailability, or errors in processing that can negatively impact the performance or reliability of the system. Tracking the status_code helps pinpoint these issues, enabling quicker identification and resolution of system inefficiencies or faults.
optional
uid: Option<String>Unique ID
The unique identifier for the span, used in distributed systems and microservices architectures to track and correlate requests across different components of an application. It enables tracing the flow of a request through various services.
required