summaryrefslogtreecommitdiffstats
path: root/tokio-trace/tokio-trace-core/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'tokio-trace/tokio-trace-core/README.md')
-rw-r--r--tokio-trace/tokio-trace-core/README.md26
1 files changed, 20 insertions, 6 deletions
diff --git a/tokio-trace/tokio-trace-core/README.md b/tokio-trace/tokio-trace-core/README.md
index 9fab7429..3bc117b1 100644
--- a/tokio-trace/tokio-trace-core/README.md
+++ b/tokio-trace/tokio-trace-core/README.md
@@ -2,6 +2,8 @@
Core primitives for `tokio-trace`.
+[Documentation](https://tokio-rs.github.io/tokio/tokio_trace_core/index.html)
+
## Overview
`tokio-trace` is a framework for instrumenting Rust programs to collect
@@ -10,16 +12,18 @@ primitives of `tokio-trace`.
The crate provides:
-* `Span` identifies a span within the execution of a program.
+* [`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.
+* [`Subscriber`], the trait implemented to collect trace data.
-* `Metadata` and `Callsite` provide information describing `Span`s.
+* [`Metadata`] and [`Callsite`] provide information describing `Span`s.
-* `Field` and `FieldSet` describe and access the structured data attached to a
- `Span`.
+* [`Field`], [`FieldSet`], [`Value`], and [`ValueSet`] represent the
+ structured data attached to a `Span`.
-* `Dispatch` allows span events to be dispatched to `Subscriber`s.
+* [`Dispatch`] allows span events to be dispatched to `Subscriber`s.
In addition, it defines the global callsite registry and per-thread current
dispatcher which other components of the tracing system rely on.
@@ -30,6 +34,16 @@ API. However, this crate's API will change very infrequently, so it may be used
when dependencies must be very stable.
[`tokio-trace`]: ../
+[`Span`]: https://tokio-rs.github.io/tokio/tokio_trace_core/span/struct.Span.html
+[`Event`]: https://tokio-rs.github.io/tokio/tokio_trace_core/event/struct.Event.html
+[`Subscriber`]: https://tokio-rs.github.io/tokio/tokio_trace_core/subscriber/trait.Subscriber.html
+[`Metadata`]: https://tokio-rs.github.io/tokio/tokio_trace_core/metadata/struct.Metadata.html
+[`Callsite`]: https://tokio-rs.github.io/tokio/tokio_trace_core/callsite/trait.Callsite.html
+[`Field`]: https://tokio-rs.github.io/tokio/tokio_trace_core/field/struct.Field.html
+[`FieldSet`]: https://tokio-rs.github.io/tokio/tokio_trace_core/field/struct.FieldSet.html
+[`Value`]: https://tokio-rs.github.io/tokio/tokio_trace_core/field/trait.Value.html
+[`ValueSet`]: https://tokio-rs.github.io/tokio/tokio_trace_core/field/struct.ValueSet.html
+[`Dispatch`]: https://tokio-rs.github.io/tokio/tokio_trace_core/dispatcher/struct.Dispatch.html
## License