azure_data_cosmos_driver 0.5.0

Core implementation layer for Azure Cosmos DB - provides transport, routing, and protocol handling for cross-language SDK reuse
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the MIT License.

//! Diagnostic and telemetry types for Cosmos DB operations.
//!
//! This module provides rich diagnostic information about Cosmos DB operations,
//! similar to [CosmosDiagnosticsContext](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/cosmos/azure-cosmos/src/main/java/com/azure/cosmos/CosmosDiagnosticsContext.java)
//! in the Java SDK.
//!
//! Diagnostics are **operational metadata** tracked by the SDK, not service resources.
//!
//! # Architecture
//!
//! - `DiagnosticsContextBuilder` (internal): Mutable builder used during operation execution
//! - [`DiagnosticsContext`]: Immutable, finalized diagnostics returned to callers
//!
//! The builder is `pub(crate)` and used internally by the driver to collect diagnostics.
//! When an operation completes, the builder is consumed to create an immutable
//! `DiagnosticsContext` which is safe to share via `Arc` without locking.

mod diagnostics_context;
mod proxy_configuration;

pub(crate) use diagnostics_context::DiagnosticsContextBuilder;
pub use diagnostics_context::{
    DiagnosticsContext, ExecutionContext, FailedTransportShardDiagnostics, PipelineType,
    RequestDiagnostics, RequestEvent, RequestEventType, RequestHandle, RequestSentStatus,
    TransportHttpVersion, TransportKind, TransportSecurity, TransportShardDiagnostics,
};
pub use proxy_configuration::ProxyConfiguration;

pub use crate::driver::pipeline::hedging_diagnostics::{
    HedgeDiagnostics, HedgeTerminalState, HedgingStrategyConfig,
};