Struct RequestContext 

pub struct RequestContext {
    pub request_id: Uuid,
    pub correlation_id: Uuid,
    pub parent_id: Option<Uuid>,
    pub session_id: Option<Uuid>,
    pub user_id: Option<Uuid>,
    pub started_at: DateTime<Utc>,
    pub source: String,
    pub operation: Option<String>,
    pub metadata: HashMap<String, String>,
}

Request context for correlation across operations.

This struct carries context information that should be propagated through the system for tracing and debugging purposes.

Fields

request_id: Uuid

Unique request identifier.

correlation_id: Uuid

Correlation ID for tracing related requests.

parent_id: Option<Uuid>

Parent request ID if this is a sub-request.

session_id: Option<Uuid>

Session ID if within a session.

user_id: Option<Uuid>

User ID if authenticated.

started_at: DateTime<Utc>

When the request started.

source: String

Source component that created this context.

operation: Option<String>

Operation being performed.

metadata: HashMap<String, String>

Additional metadata.

Implementations

impl RequestContext

pub fn new(source: impl Into<String>) -> Self

Create a new request context.

pub fn child(&self, source: impl Into<String>) -> Self

Create a child context that inherits correlation info.

pub fn with_correlation_id(self, id: Uuid) -> Self

Set the correlation ID.

pub fn with_session_id(self, id: Uuid) -> Self

Set the session ID.

pub fn with_user_id(self, id: Uuid) -> Self

Set the user ID.

pub fn with_operation(self, operation: impl Into<String>) -> Self

Set the operation name.

pub fn with_metadata( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Add metadata.

pub fn elapsed(&self) -> Duration

Get elapsed time since the request started.

pub fn elapsed_ms(&self) -> i64

Get elapsed time in milliseconds.

pub fn span(&self) -> Span

Create a tracing span with this context.

pub fn has_parent(&self) -> bool

Check if this context has a parent.

pub fn short_id(&self) -> String

Get a short identifier for logging.

Trait Implementations

impl Clone for RequestContext

fn clone(&self) -> RequestContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestContext

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

Formats the value using the given formatter.

impl Default for RequestContext

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RequestContext

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RequestContext

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.