Struct RequestDiagnostics 

#[non_exhaustive]
pub struct RequestDiagnostics { /* private fields */ }

Diagnostics for a single HTTP request/response pair.

Each retry, hedged request, or failover produces a separate RequestDiagnostics entry in the DiagnosticsContext.

This type is non-exhaustive and new fields may be added in future releases. Use the getter methods to access field values.

Implementations

impl RequestDiagnostics

pub fn execution_context(&self) -> ExecutionContext

Returns the execution context describing why this request was made.

pub fn pipeline_type(&self) -> PipelineType

Returns the pipeline type used for this request.

pub fn transport_security(&self) -> TransportSecurity

Returns the transport security mode used for this request.

pub fn transport_kind(&self) -> TransportKind

Returns the concrete transport kind used for this request.

pub fn transport_http_version(&self) -> TransportHttpVersion

Returns the HTTP protocol version used by the selected transport.

pub fn region(&self) -> Option<&Region>

Returns the region this request was sent to.

pub fn endpoint(&self) -> &str

Returns the endpoint URI contacted.

pub fn status(&self) -> &CosmosStatus

Returns the combined HTTP status and sub-status code.

pub fn request_charge(&self) -> RequestCharge

Returns the request charge (RU) for this individual request.

pub fn activity_id(&self) -> Option<&ActivityId>

Returns the activity ID from response headers, if present.

pub fn session_token(&self) -> Option<&str>

Returns the session token from response, if present.

pub fn server_duration_ms(&self) -> Option<f64>

Returns the server-side request processing duration in milliseconds, if available.

pub fn started_at(&self) -> Instant

Returns when this request was started.

pub fn completed_at(&self) -> Option<Instant>

Returns when this request completed, if it has completed.

pub fn duration_ms(&self) -> u64

Returns the duration in milliseconds.

pub fn events(&self) -> &[RequestEvent]

Returns the pipeline events during this request.

pub fn transport_shard(&self) -> Option<&TransportShardDiagnostics>

Returns the sharded transport state for the shard used by this request, if present.

pub fn failed_transport_shards(&self) -> &[FailedTransportShardDiagnostics]

Returns prior shard-local failures recorded before the final attempt outcome.

pub fn local_shard_retry_count(&self) -> u32

Returns how many shard-local transport retries were performed.

pub fn timed_out(&self) -> bool

Returns whether this request timed out.

pub fn request_sent(&self) -> RequestSentStatus

Returns whether the request was sent on the wire.

pub fn error(&self) -> Option<&str>

Returns the error message if the request failed.

pub fn fault_injection_evaluations(&self) -> &[FaultInjectionEvaluation]

Returns fault injection rule evaluations for this request.

Each entry describes why a rule was applied, skipped, or missed. Only populated when the fault_injection feature is enabled.

Trait Implementations

impl Clone for RequestDiagnostics

fn clone(&self) -> RequestDiagnostics

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestDiagnostics

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

Formats the value using the given formatter.

impl PartialEq for RequestDiagnostics

fn eq(&self, other: &RequestDiagnostics) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for RequestDiagnostics

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for RequestDiagnostics

impl StructuralPartialEq for RequestDiagnostics