Enum BuildError 

#[non_exhaustive]
pub enum BuildError {
    Config(ConfigError),
    Metrics(String),
    Io(Error),
    Sink(String),
    DuplicateSinkName(String),
    DuplicateSeries(String),
    MissingSink,
    MissingChains,
    AsyncContext,
}

Error assembling a pipeline (cold path, before anything runs).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Config(ConfigError)

The configuration failed to load or validate.

Metrics(String)

The metrics exporter failed to install.

Io(Error)

The I/O runtime failed to build.

Sink(String)

The sink bundle’s topology or labels are unusable.

DuplicateSinkName(String)

Pipeline::add_sink was called twice with the same name (a second bare Pipeline::sink collides on the reserved "default" name).

DuplicateSeries(String)

Another live handle set in this process already owns a metric series this sink would publish — a second pipeline with the same pipeline and sink name, usually. Gauge series cannot be shared (see “Series ownership” in docs/METRICS.md), so assembly stops here rather than letting one of the two publish readings the other overwrites. A pipeline rebuilt sequentially is fine: drop the old one first.

MissingSink

Pipeline::into_runtime/Pipeline::run without a sink.

MissingChains

Pipeline::into_runtime/Pipeline::run without a chain factory.

AsyncContext

The builder was constructed inside an async runtime. It owns a blocking tokio runtime (dropping or block_on-ing one inside async context panics), so build pipelines from a plain thread — usually main.

Trait Implementations

impl Debug for BuildError

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

Formats the value using the given formatter.

impl Display for BuildError

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

Formats the value using the given formatter.

impl Error for BuildError

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<BuildError> for PipelineError

fn from(source: BuildError) -> Self

Converts to this type from the input type.

impl From<ConfigError> for BuildError

fn from(source: ConfigError) -> Self

Converts to this type from the input type.

impl From<Error> for BuildError

fn from(source: Error) -> Self

Converts to this type from the input type.