Struct GlideOpenTelemetry 

pub struct GlideOpenTelemetry {}

Implementations

impl GlideOpenTelemetry

Our interface to OpenTelemetry

pub unsafe fn is_span_pointer_valid(span_ptr: u64) -> bool

Validate if a span pointer is valid

Arguments

• span_ptr - The u64 span pointer to validate

Returns

• true - If the span pointer is valid (non-zero and within reasonable bounds)
• false - If the span pointer is invalid (zero, out of bounds, or potentially corrupted)

Safety

This function performs basic validation but cannot guarantee the pointer points to valid memory. It only checks for obvious invalid values like null pointers and unreasonable addresses.

pub unsafe fn span_from_pointer( span_ptr: u64, ) -> Result<GlideSpan, GlideOTELError>

Convert a span pointer to a GlideSpan with validation

Arguments

• span_ptr - The u64 span pointer to convert

Returns

• Ok(GlideSpan) - If the pointer is valid and conversion succeeds
• Err(TraceError) - If the pointer is invalid or conversion fails

Safety

This function validates the pointer before attempting conversion, but still uses unsafe code

pub fn initialise( config: GlideOpenTelemetryConfig, ) -> Result<(), GlideOTELError>

Initialise the open telemetry library with a file system exporter

This method should be called once for the given process If OpenTelemetry is already initialized, this method will return Ok(()) without reinitializing

pub fn record_timeout_error() -> Result<(), GlideOTELError>

Record a timeout error

If OpenTelemetry is not initialized, this method will do nothing.

pub fn record_retry_attempt() -> Result<(), GlideOTELError>

Record a retry attempt

If OpenTelemetry is not initialized, this method will do nothing.

pub fn record_moved_error() -> Result<(), GlideOTELError>

Record a moved error

If OpenTelemetry is not initialized, this method will do nothing.

pub fn record_subscription_out_of_sync() -> Result<(), GlideOTELError>

Record that subscriptions are out of sync

If OpenTelemetry is not initialized, this method will do nothing.

pub fn update_subscription_last_sync_timestamp() -> Result<(), GlideOTELError>

Update the timestamp of when subscriptions were last in sync

Records the current system time as a Unix timestamp in milliseconds.

If OpenTelemetry is not initialized, this method will do nothing.

pub fn get_flush_interval_ms(config: GlideOpenTelemetryConfig) -> Duration

Get the flush interval milliseconds

pub fn new_span(name: &str) -> GlideSpan

Create new span

pub fn shutdown()

Trigger a shutdown procedure flushing all remaining traces

pub fn is_initialized() -> bool

Check if OpenTelemetry is initialized

Trait Implementations

impl Clone for GlideOpenTelemetry

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.