Crate tokio_trace_core

Core primitives for tokio-trace.

tokio-trace is a framework for instrumenting Rust programs to collect structured, event-based diagnostic information. This crate defines the core primitives of tokio-trace.

This crate provides:

• Span identifies a span within the execution of a program.

• Event represents a single event within a trace.

• Subscriber, the trait implemented to collect trace data.

• Metadata and Callsite provide information describing Spans.

• Field, FieldSet, Value, and ValueSet represent the structured data attached to a Span.

• Dispatch allows span events to be dispatched to Subscribers.

In addition, it defines the global callsite registry and per-thread current dispatcher which other components of the tracing system rely on.

Application authors will typically not use this crate directly. Instead, they will use the tokio-trace crate, which provides a much more fully-featured API. However, this crate’s API will change very infrequently, so it may be used when dependencies must be very stable.

The tokio-trace-nursery repository contains less stable crates designed to be used with the tokio-trace ecosystem. It includes a collection of Subscriber implementations, as well as utility and adapter crates.

Re-exports

• pub use self::callsite::Callsite;
• pub use self::dispatcher::Dispatch;
• pub use self::event::Event;
• pub use self::field::Field;
• pub use self::metadata::Kind;
• pub use self::metadata::Level;
• pub use self::metadata::Metadata;
• pub use self::subscriber::Interest;
• pub use self::subscriber::Subscriber;

Modules

• callsite
  Callsites represent the source locations from which spans or events originate.
• dispatcher
  Dispatches trace events to Subscribers.c
• event
  Events represent single points in time during the execution of a program.
• field
  Span and Event key-value data.
• metadata
  Metadata describing trace data.
• span
  Spans represent periods of time in the execution of a program.
• subscriber
  Subscribers collect and record trace data.

Macros

• identify_callsite
  Statically constructs an Identifier for the provided Callsite.
• metadata
  Statically constructs new span metadata.