Struct kernel::trace::SerialCollector

pub struct SerialCollector {
    tx: InitOnce<SpscProducer>,
    current_span: AtomicU64,
    current_meta: AtomicPtr<Metadata<'static>>,
    next_id: AtomicU64,
    dropped_events: AtomicUsize,
    max_level: AtomicU8,
    in_send: AtomicBool,
}

Fields

tx: InitOnce<SpscProducer>

current_span: AtomicU64

ID of the current span.

Note: This collector only works correctly on single-threaded hardware!

current_meta: AtomicPtr<Metadata<'static>>

next_id: AtomicU64

ID of the next span.

dropped_events: AtomicUsize

Counter of events that were dropped due to insufficient buffer capacity.

max_level: AtomicU8

in_send: AtomicBool

Tracks whether we are inside of the collector’s send_event method, so that BBQueue tracing can be disabled.

Implementations

impl SerialCollector

pub const PORT: u16 = 3u16

const CAPACITY: usize = 4_096usize

pub const fn new() -> Self

pub const fn with_max_level(max_level: LevelFilter) -> Self

pub async fn start(&'static self, k: &'static Kernel)

fn send_event<'a>( &self, sz: usize, event: impl FnOnce() -> TraceEvent<'a> ) -> bool

Serialize a TraceEvent, returning true if the event was correctly serialized.

async fn worker( &'static self, rx: Consumer, port: PortHandle, k: &'static Kernel )

fn level_enabled(&self, metadata: &Metadata<'_>) -> bool

Trait Implementations

impl Collect for SerialCollector

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

Returns true if a span or event with the specified metadata would be recorded.

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

Registers a new callsite with this collector, returning whether or not the collector is interested in being notified about the callsite.

fn max_level_hint(&self) -> Option<LevelFilter>

Returns the highest verbosity level that this Collector will enable, or None, if the collector does not implement level-based filtering or chooses not to implement this method.

fn new_span(&self, span: &Attributes<'_>) -> Id

Visit the construction of a new span, returning a new span ID for the span being constructed.

fn record(&self, _: &Id, _: &Record<'_>)

Record a set of values on a span.

fn enter(&self, span: &Id)

Records that a span has been entered.

fn exit(&self, span: &Id)

Records that a span has been exited.

fn record_follows_from(&self, _: &Id, _: &Id)

Adds an indication that span follows from the span with the id follows.

fn event(&self, event: &Event<'_>)

Records that an Event has occurred.

fn current_span(&self) -> Current

Returns a type representing this collector’s view of the current span.

fn clone_span(&self, span: &Id) -> Id

Notifies the collector that a span ID has been cloned.

fn try_close(&self, span: Id) -> bool

Notifies the collector that a span ID has been dropped, and returns true if there are now 0 IDs that refer to that span.

fn on_register_dispatch(&self, collector: &Dispatch)

Invoked when this collector becomes a Dispatch.

fn event_enabled(&self, event: &Event<'_>) -> bool

Determine if an Event should be recorded.

fn drop_span(&self, _id: Id)

👎Deprecated since 0.1.2: use Collector::try_close instead

This method is deprecated.

unsafe fn downcast_raw(&self, id: TypeId) -> Option<NonNull<()>>

If self is the same type as the provided TypeId, returns an untyped NonNull pointer to that type. Otherwise, returns None.