mirror of https://github.com/tokio-rs/tracing.git synced 2026-03-19 14:14:08 +00:00

Files

Eliza Weisman 96e9d6d4f0 subscriber: prepare to release 0.2.8 (#823 )

### Changed

- **fmt**: When the `chrono` dependency is enabled, the `SystemTime`
  timestamp now emits human-readable timestamps rather than using
  `SystemTime`'s fmt::Debug`implementation (`chrono` is still required
  for customized timestamp formatting) (#807)
- **ansi**: Updated `ansi_term` dependency to 0.12 (#816)

### Added

- **json**: `with_span_list` method to configure the JSON formatter to
  include a list of all spans in the current trace in formatting events
  (similarly to the text formatter) (#741)
- **json**: `with_current_span` method to configure the JSON formatter
  to include a field for the _current_ span (the leaf of the trace) in
  formatted events (#741)
- **fmt**: `with_thread_names` and `with_thread_ids` methods to
  configure `fmt::Subscriber`s and `fmt::Layer`s to include the thread
  name and/or thread ID of the current thread when formatting events
  (#818)

Thanks to new contributors @mockersf, @keetonian, and @Pothulapati for
contributing to this release!

2020-07-17 11:03:23 -07:00

examples

subscriber: allow thread name and ID to be displayed in traces (#818 )

2020-07-17 10:09:59 -07:00

Cargo.toml

subscriber: prepare to release 0.2.8 (#823 )

2020-07-17 11:03:23 -07:00

README.md

journald: add tracing-journald crate implementing a simple journald layer (#691 )

2020-06-29 12:07:24 -07:00

README.md

Tracing Examples

This directory contains a collection of examples that demonstrate the use of the tracing ecosystem:

tracing:
- counters: Implements a very simple metrics system to demonstrate how subscribers can consume field values as typed data.
- sloggish: A demo Subscriber implementation that mimics the output of slog-term's Compact formatter.
tracing-attributes:
- attrs-basic: A simple example of the #[instrument] attribute.
- attrs-args: An example implementing a simple recursive calculation of Fibonacci numbers, to demonstrate how the #[instrument] attribute can record function arguments.
tracing-subscriber:
- fmt: Demonstrates the use of the fmt module in tracing-subscriber, which provides a subscriber implementation that logs traces to the console.
- fmt-stderr: Demonstrates overriding the output stream used by the fmt subscriber.
- fmt-custom-field: Demonstrates overriding how the fmt subscriber formats fields on spans and events.
- fmt-custom-event: Demonstrates overriding how the fmt subscriber formats events.
- subscriber-filter: Demonstrates the tracing-subscriber::filter module, which provides a layer which adds configurable filtering to a subscriber implementation.
- tower-load: Demonstrates how dynamically reloadable filters can be used to debug a server under load in production.
- journald: Demonstrates how to use fmt and journald layers to output to both the terminal and the system journal.
tracing-futures:
- spawny-thing: Demonstrates the use of the #[instrument] attribute macro asynchronous functions.
- tokio-spawny-thing.rs: Similar to spawny-thingy, but with the additional demonstration instrumenting concurrent tasks created with tokio::spawn.
- futures-proxy-server: Demonstrates the use of tracing-futures by implementing a simple proxy server, based on this example from tokio.
- async_fn: Demonstrates how asynchronous functions can be instrumented.
- echo: Demonstrates a tracing-instrumented variant of Tokio's echo example.
tracing-flame:
- infero-flame: Demonstrates the use of tracing-flame to generate a flamegraph from spans.
tracing-tower:
- tower-client: Demonstrates the use of tracing-tower to instrument a simple tower HTTP/1.1 client.
- tower-server: Demonstrates the use of tracing-tower to instrument a simple tower HTTP/1.1 server.
tracing-serde:
- serde-yak-shave: Demonstrates the use of tracing-serde by implementing a subscriber that emits trace output as JSON.
tracing-log:
- hyper-echo: Demonstrates how tracing-log can be used to record unstructured logs from dependencies as tracing events, by instrumenting this example from hyper, and using tracing-log to record logs emitted by hyper.
tracing-opentelemetry:
- opentelemetry: Demonstrates how tracing-opentelemetry can be used to export and visualize tracing span data.
- opentelemetry-remote-context: Demonstrates how tracing-opentelemetry can be used to extract and inject remote context when traces span multiple systems.