Struct TelemetrySpan 

pub struct TelemetrySpan { /* private fields */ }

An exportable span that also exposes rust-zero’s W3C context representation.

Implementations

impl TelemetrySpan

pub fn start( name: impl Into<String>, kind: TelemetrySpanKind, parent: Option<&TraceContext>, attributes: impl IntoIterator<Item = (&'static str, String)>, ) -> Self

Examples found in repository

examples/telemetry.rs (lines 12-17)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let endpoint = env::var("OTEL_EXPORTER_OTLP_ENDPOINT")
        .unwrap_or_else(|_| "http://127.0.0.1:4317".to_owned());
    let telemetry = Telemetry::init(TelemetryConfig::new(
        "rust-zero-example",
        endpoint,
        OtlpTransport::Grpc,
    ))?;
    let span = TelemetrySpan::start(
        "example.startup",
        TelemetrySpanKind::Internal,
        None,
        [("deployment.environment", "development".to_owned())],
    );
    span.end();
    telemetry.force_flush()?;
    Ok(())
}

pub fn trace_context(&self) -> Option<&TraceContext>

pub fn set_attribute(&self, key: &'static str, value: impl Into<String>)

pub fn set_error(&self, description: impl Into<String>)

pub fn end(self)

Examples found in repository

examples/telemetry.rs (line 18)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let endpoint = env::var("OTEL_EXPORTER_OTLP_ENDPOINT")
        .unwrap_or_else(|_| "http://127.0.0.1:4317".to_owned());
    let telemetry = Telemetry::init(TelemetryConfig::new(
        "rust-zero-example",
        endpoint,
        OtlpTransport::Grpc,
    ))?;
    let span = TelemetrySpan::start(
        "example.startup",
        TelemetrySpanKind::Internal,
        None,
        [("deployment.environment", "development".to_owned())],
    );
    span.end();
    telemetry.force_flush()?;
    Ok(())
}

Trait Implementations

impl Debug for TelemetrySpan

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

Formats the value using the given formatter.

impl Drop for TelemetrySpan

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.