Crate near_o11y 

Observability (o11y) helpers for the NEAR codebase.

This crate contains all sorts of utilities to enable a more convenient observability implementation in the NEAR codebase.

The are three infrastructures:

• tracing, for structured, hierarchical logging of events (see default_subscriber function in particular)
• metrics – convenience wrappers around prometheus metric, for reporting statistics.
• io-tracer – custom infrastructure for observing DB accesses in particular (mostly for parameter estimator)

Re-exports

pub use env_filter::BuildEnvFilterError;

pub use env_filter::EnvFilterBuilder;

pub use tracing;

pub use tracing_appender;

pub use tracing_subscriber;

pub use context::*;

Modules

context

Custom tracing subscriber implementation that produces IO traces.

env_filter

log_config

macros

metrics

A fork of the lighthouse_metrics crate used to implement prometheus

testonly

Macros

handler_debug_span

A macro that lets attach handle() functions to the tracing context that generated the actix message being processed. Creates a DEBUG-level span with the handler type name and the message type name as attributes.

handler_span

Internal use only.

handler_trace_span

A macro that lets attach handle() functions to the tracing context that generated the actix message being processed. Creates a TRACE-level span with the handler type name and the message type name as attributes.

io_trace

log_assert

Asserts that the condition is true, logging an error otherwise.

log_assert_fail

The same as ‘log_assert’ but always fails.

Structs

Options

Configures exporter of span and trace data.

Enums

OpenTelemetryLevel

Traits

OpenTelemetrySpanExt

Utility functions to allow tracing Spans to accept and return OpenTelemetry Contexts.

Functions

default_subscriber

Constructs a subscriber set to the option appropriate for the NEAR code.

default_subscriber_with_opentelemetry

Constructs a subscriber set to the option appropriate for the NEAR code.

reload

Constructs new filters for the logging and opentelemetry layers.

reload_log_config