Enum TelemetryError 

pub enum TelemetryError {
    GenericError(Option<Arc<str>>),
    InvalidType,
    SizeMismatch {
        expected: usize,
        got: usize,
    },
    SizeMismatchError,
    EmptyEndpoints,
    TimestampInvalid,
    MissingPayload,
    HandlerError(&'static str),
    BadArg,
    PermissionDenied,
    Pack(&'static str),
    Unpack(&'static str),
    Io(&'static str),
    InvalidUtf8,
    TypeMismatch {
        expected: usize,
        got: usize,
    },
    InvalidLinkId(&'static str),
    PacketTooLarge(&'static str),
}

Rich error type used throughout the telemetry crate.

Most public APIs expose a TelemetryResult<T> alias for Result<T, TelemetryError>.

Variants

GenericError(Option<Arc<str>>)

Generic / unspecified error.

InvalidType

Logical type ID is not a valid DataType.

SizeMismatch

Payload size doesn’t match the schema’s expectations.

Fields

expected: usize

got: usize

SizeMismatchError

Legacy / generic size mismatch error (for C/Python parity).

EmptyEndpoints

No endpoints were supplied where they are required.

TimestampInvalid

Timestamp is invalid (e.g., zero when disallowed).

MissingPayload

A packet is missing its payload bytes.

HandlerError(&'static str)

A handler (C/Python callback) returned an error.

BadArg

Generic invalid argument from caller.

PermissionDenied

Operation is not permitted for the current router/device policy.

Pack(&'static str)

Packing error.

Unpack(&'static str)

Unpacking error.

Io(&'static str)

IO / transport error.

InvalidUtf8

UTF-8 decoding failed where string payloads are expected.

TypeMismatch

Payload type size mismatch.

Fields

expected: usize

got: usize

InvalidLinkId(&'static str)

Invalid link ID provided.

PacketTooLarge(&'static str)

Packet is bigger than the queue size

Implementations

impl TelemetryError

pub const fn to_error_code(&self) -> TelemetryErrorCode

Map a rich TelemetryError to a stable numeric error code used by the FFI layers.

Trait Implementations

impl Clone for TelemetryError

fn clone(&self) -> TelemetryError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TelemetryError

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

Formats the value using the given formatter.

impl Display for TelemetryError

Allow conversion of TelemetryError to human-readable string.

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

Formats the value using the given formatter.

impl Eq for TelemetryError

impl Error for TelemetryError

Available on crate feature std only.

Implement std::error::Error for TelemetryError when std is enabled.

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl From<Box<dyn Error>> for TelemetryError

Available on crate feature std only.

Allow the conversion from boxed std error to telemetry error

fn from(err: Box<dyn Error>) -> Self

Converts to this type from the input type.

impl From<Error> for TelemetryError

Available on crate feature std only.

Allow the conversion from std error to telemetry error

fn from(error: Error) -> Self

Converts to this type from the input type.

impl PartialEq for TelemetryError

fn eq(&self, other: &TelemetryError) -> 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 StructuralPartialEq for TelemetryError