Struct SystemdLayer

pub struct SystemdLayer { /* private fields */ }

A configurable tracing-subscriber layer compatible with journald.

The layer used to format and log events. Can be configured to log to stdout, or directly to journald using the sd-journal feature.

let systemd_layer = SystemdLayer::new()
    .with_target(true)
    .use_level_prefix(false)
    .use_color(true);

Implementations

impl SystemdLayer

pub fn new() -> Self

Creates a new SystemdLayer with default configuration.

Examples found in repository

examples/test_log_stdout.rs (line 9)

fn main() {
    tracing_subscriber::registry()
        .with(
            SystemdLayer::new()
                .with_target(true)
                .use_level_prefix(false)
                .use_color(true)
                .with_thread_ids(true),
        )
        .init();

    root_log_fn(true);
}

pub fn with_thread_ids(self, log_thread_id: bool) -> Self

Sets whether or not to include thread IDs (default: false)

Examples found in repository

examples/test_log_stdout.rs (line 13)

fn main() {
    tracing_subscriber::registry()
        .with(
            SystemdLayer::new()
                .with_target(true)
                .use_level_prefix(false)
                .use_color(true)
                .with_thread_ids(true),
        )
        .init();

    root_log_fn(true);
}

pub fn separate_spans_with(self, span_separator: &'static str) -> Self

Sets the span separator (default: “::”)

pub fn separate_message_with(self, message_separator: &'static str) -> Self

Sets the message separator (default: “: “)

pub fn with_target(self, display_target: bool) -> Self

Sets whether or not to include the target (default: false)

Examples found in repository

examples/test_log_stdout.rs (line 10)

fn main() {
    tracing_subscriber::registry()
        .with(
            SystemdLayer::new()
                .with_target(true)
                .use_level_prefix(false)
                .use_color(true)
                .with_thread_ids(true),
        )
        .init();

    root_log_fn(true);
}

pub fn function_bracket_left(self, function_bracket_left: &'static str) -> Self

Sets the left bracket for function names (default: “(”)

pub fn function_bracket_right( self, function_bracket_right: &'static str, ) -> Self

Sets the right bracket for function names (default: “)”)

pub fn arguments_equality(self, arguments_equality: &'static str) -> Self

Sets the equality sign for arguments (default: “: “)

pub fn arguments_separator(self, arguments_separator: &'static str) -> Self

Sets the separator for arguments (default: “, “)

pub fn level_separator(self, level_separator: &'static str) -> Self

Sets the separator for levels (default: “ “)

pub fn thread_id_prefix(self, thread_id_prefix: &'static str) -> Self

Sets the prefix for thread IDs (default: “[”)

pub fn thread_id_suffix(self, thread_id_suffix: &'static str) -> Self

Sets the suffix for thread IDs (default: “] “)

pub fn use_level_prefix(self, use_level_prefix: bool) -> Self

Sets whether or not to use level prefixes (default: true)

Examples found in repository

examples/test_log_stdout.rs (line 11)

fn main() {
    tracing_subscriber::registry()
        .with(
            SystemdLayer::new()
                .with_target(true)
                .use_level_prefix(false)
                .use_color(true)
                .with_thread_ids(true),
        )
        .init();

    root_log_fn(true);
}

pub fn use_color(self, use_color: bool) -> Self

Sets whether or not to use color

Examples found in repository

examples/test_log_stdout.rs (line 12)

fn main() {
    tracing_subscriber::registry()
        .with(
            SystemdLayer::new()
                .with_target(true)
                .use_level_prefix(false)
                .use_color(true)
                .with_thread_ids(true),
        )
        .init();

    root_log_fn(true);
}

Trait Implementations

impl<S> Layer<S> for SystemdLayer

where S: Subscriber + for<'a> LookupSpan<'a>,

fn on_event(&self, event: &Event<'_>, ctx: Context<'_, S>)

Notifies this layer that an event has occurred.

fn on_new_span(&self, attrs: &Attributes<'_>, id: &Id, ctx: Context<'_, S>)

Notifies this layer that a new span was constructed with the given Attributes and Id.

fn on_register_dispatch(&self, subscriber: &Dispatch)

Performs late initialization when installing this layer as a Subscriber.

fn on_layer(&mut self, subscriber: &mut S)

Performs late initialization when attaching a Layer to a Subscriber.

fn register_callsite(&self, metadata: &'static Metadata<'static>) -> Interest

Registers a new callsite with this layer, returning whether or not the layer is interested in being notified about the callsite, similarly to Subscriber::register_callsite.

fn enabled(&self, metadata: &Metadata<'_>, ctx: Context<'_, S>) -> bool

Returns true if this layer is interested in a span or event with the given metadata in the current Context, similarly to Subscriber::enabled.

fn on_record(&self, _span: &Id, _values: &Record<'_>, _ctx: Context<'_, S>)

Notifies this layer that a span with the given Id recorded the given values.

fn on_follows_from(&self, _span: &Id, _follows: &Id, _ctx: Context<'_, S>)

Notifies this layer that a span with the ID span recorded that it follows from the span with the ID follows.

fn event_enabled(&self, _event: &Event<'_>, _ctx: Context<'_, S>) -> bool

Called before on_event, to determine if on_event should be called.

fn on_enter(&self, _id: &Id, _ctx: Context<'_, S>)

Notifies this layer that a span with the given ID was entered.

fn on_exit(&self, _id: &Id, _ctx: Context<'_, S>)

Notifies this layer that the span with the given ID was exited.

fn on_close(&self, _id: Id, _ctx: Context<'_, S>)

Notifies this layer that the span with the given ID has been closed.

fn on_id_change(&self, _old: &Id, _new: &Id, _ctx: Context<'_, S>)

Notifies this layer that a span ID has been cloned, and that the subscriber returned a different ID.

fn and_then<L>(self, layer: L) -> Layered<L, Self, S>

where L: Layer<S>, Self: Sized,

Composes this layer around the given Layer, returning a Layered struct implementing Layer.

fn with_subscriber(self, inner: S) -> Layered<Self, S>

where Self: Sized,

Composes this Layer with the given Subscriber, returning a Layered struct that implements Subscriber.

fn with_filter<F>(self, filter: F) -> Filtered<Self, F, S>

where Self: Sized, F: Filter<S>,

Combines self with a Filter, returning a Filtered layer.

fn boxed(self) -> Box<dyn Layer<S> + Send + Sync>

where Self: Sized + Layer<S> + Send + Sync + 'static, S: Subscriber,

Erases the type of this Layer, returning a Boxed dyn Layer trait object.