Enum ServiceError 

pub enum ServiceError {
    Io(Error),
    Fmt(Error),
    Json(Error),
    Network(Error),
    Http(HttpError),
    LockPoisoned,
    ConfigDeserialization,
    FeatureDisabled(FeatureDisabledError),
    Unknown(Box<dyn Error + Send + Sync>),
}

Represents the possible failure modes for a Service.

This enum wraps specific backend errors into a unified type, allowing the LoggerImpl to handle various failure scenarios consistently.

Variants

Io(Error)

Errors related to the file system or standard I/O operations.

This is typically triggered by permission issues, missing files, or interrupted streams during log rotation or local storage.

Fmt(Error)

Errors occurring during string formatting operations.

Usually happens when writing to a buffer or formatting complex log structures for output.

Json(Error)

Errors occurring during JSON serialization or deserialization.

Triggered when the log message cannot be converted to valid JSON or when a configuration file has an invalid JSON format.

Network(Error)

Errors occurring during network requests (e.g., HTTP).

This includes connection timeouts, DNS resolution failures, or transport-level issues when sending logs to a remote server.

Http(HttpError)

Errors returned by the HTTP server or protocol.

Unlike ServiceError::Network, this variant represents valid HTTP responses that indicate a failure (e.g., 4xx or 5xx status codes).

LockPoisoned

A synchronization primitive has been “poisoned”.

This occurs when a thread panics while holding a std::sync::Mutex or std::sync::RwLock. The data protected by the lock might be in an inconsistent state.

ConfigDeserialization

Failed to map the raw configuration into the internal settings structure.

This indicates that the configuration exists and is syntactically correct, but contains invalid values or missing required fields.

FeatureDisabled(FeatureDisabledError)

The requested operation requires a feature that is not currently enabled.

Check the FeatureDisabledError for details on which feature is missing and how to enable it in your Cargo.toml.

Unknown(Box<dyn Error + Send + Sync>)

A catch-all for errors not covered by the specific variants.

Use this for wrapping third-party errors that don’t justify a dedicated variant or for rare, unexpected conditions.

Trait Implementations

impl Debug for ServiceError

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

Formats the value using the given formatter.

impl Display for ServiceError

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

Formats the value using the given formatter.

impl Error for ServiceError

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<Error> for ServiceError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ServiceError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl<T> From<PoisonError<MutexGuard<'_, T>>> for ServiceError

fn from(_err: PoisonError<MutexGuard<'_, T>>) -> Self

Converts to this type from the input type.