Struct tracing_axiom::Builder

pub struct Builder { /* private fields */ }

Builder for creating a tracer, a layer or a subscriber that sends traces to Axiom. The token and the url are derived from the AXIOM_TOKEN and AXIOM_URL environment variables.

Implementations

impl Builder

pub fn new() -> Self

Create a new Builder.

pub fn with_token(self, token: impl Into<String>) -> Self

Set the Axiom API token to use.

pub fn with_url(self, url: impl Into<String>) -> Self

Set the Axiom API URL to use. Defaults to Axiom Cloud.

pub fn with_trace_config(self, trace_config: impl Into<TraceConfig>) -> Self

Set the trace config.

pub fn with_service_name(self, service_name: impl Into<String>) -> Self

Set the service name. It will be set as a resource attribute with the name service_name.

pub fn no_env(self) -> Self

Don’t fall back to environment variables.

pub fn init(self) -> Guard

Initialize the global subscriber. This panics if the initialization was unsuccessful, likely because a global subscriber was already installed or AXIOM_TOKEN is not set or invalid.

pub fn try_init(self) -> Result<Guard, Error>

Initialize the global subscriber. This returns an error if the initialization was unsuccessful, likely because a global subscriber was already installed or AXIOM_TOKEN is not set or invalid.

pub fn layer<S>(self) -> Result<(OpenTelemetryLayer<S, Tracer>, Guard), Error> where
    S: Subscriber + for<'span> LookupSpan<'span>, 

Create a layer which sends traces to Axiom and a Guard which will shut down the tracer provider on drop.

Trait Implementations

impl Debug for Builder

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

Formats the value using the given formatter.

impl Default for Builder

fn default() -> Builder

Returns the “default value” for a type.