Struct TailtriageControllerBuilder 

pub struct TailtriageControllerBuilder { /* private fields */ }

Builder for a long-lived TailtriageController.

Implementations

impl TailtriageControllerBuilder

pub fn new(service_name: impl Into<String>) -> Self

Creates a controller builder for one service.

pub fn config_path(self, config_path: impl AsRef<Path>) -> Self

Sets the optional config path used for reloadable controller config.

pub const fn initially_enabled(self, initially_enabled: bool) -> Self

Sets whether build should immediately create the first active generation.

When set to true, Self::build calls TailtriageController::enable during construction so generation 1 is active as soon as build succeeds.

pub fn output(self, output_path: impl AsRef<Path>) -> Self

Sets the output location template for future activation runs.

pub const fn capture_limits_override( self, capture_limits_override: CaptureLimitsOverride, ) -> Self

Sets field-level capture limit overrides applied on top of selected mode defaults.

pub const fn strict_lifecycle(self, strict_lifecycle: bool) -> Self

Sets strict lifecycle validation applied to future activation runs.

pub const fn runtime_sampler( self, runtime_sampler: RuntimeSamplerTemplate, ) -> Self

Sets runtime sampler template settings for future activations.

pub const fn run_end_policy(self, run_end_policy: RunEndPolicy) -> Self

Sets a run-end policy template applied to future activations.

pub fn build(self) -> Result<TailtriageController, ControllerBuildError>

Builds the controller.

Errors

When config_path(...) is set, controller.service_name from TOML takes precedence when present; the builder value is used only when TOML omits it.

Returns ControllerBuildError::EmptyServiceName when the final resolved service_name is blank.

Returns ControllerBuildError::ConfigLoad when config_path(...) is set and reading or parsing the TOML file fails.

Returns ControllerBuildError::InitialEnable when Self::initially_enabled is true and the first generation cannot be armed.

Trait Implementations

impl Clone for TailtriageControllerBuilder

fn clone(&self) -> TailtriageControllerBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TailtriageControllerBuilder

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

Formats the value using the given formatter.