tracing-flat-json 0.1.0

A simple tracing-subscriber Layer emitting newline-delimited JSON.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

# `tracing-flat-json`

to combining the [`json-subscriber`] options [`with_flattened_event`] and
[`with_top_level_flattened_span_list`], without the caveats about duplicate
fields noted in the documentation for those options.

[`tracing_subscriber::Layer`]: https://docs.rs/tracing-subscriber/0.3.20/tracing_subscriber/layer/trait.Layer.html
[`json-subscriber`]: https://crates.io/crates/json-subscriber
[`with_flattened_event`]: https://docs.rs/json-subscriber/0.2.6/json_subscriber/struct.JsonLayer.html#method.with_flattened_event
[`with_top_level_flattened_span_list`]: https://docs.rs/json-subscriber/0.2.6/json_subscriber/struct.JsonLayer.html#method.with_top_level_flattened_span_list

## Usage

```rust
use tracing_subscriber::prelude::*;

tracing_subscriber::Registry::default()
    .with(tracing_flat_json::FlatJsonLayer::new(std::io::stdout))
    .init();
```

## Feature Flags

- `tracing-log`: Handle [`log`] events emitted by [`tracing-log`]. Enabled
  by default.
- `tracing-opentelemetry`: Outputs the `trace_id` added to spans by
  [`tracing-opentelemetry`]. May not work when compiled with multiple
  versions of [`tracing-opentelemetry`] in the same executable.

[`log`]: https://crates.io/crates/log
[`tracing-log`]: https://crates.io/crates/tracing-log
[`tracing-opentelemetry`]: https://crates.io/crates/tracing-opentelemetry

## Output Format

Included:

- timestamp (RFC3339 UTC)
- level
- `trace_id` (with feature `tracing-opentelemetry`)
- `code.file.path`
- `code.line.number`
- event message
- event fields, source code order
- parent span fields, source code order, latest span first, root span last

Excluded:

- span names
- `target`
- `span_id`
- duplicate fields (only latest value for each field name)