tracing-datadog 0.1.0

tracing subscriber for DataDog
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

# tracing-datadog

A `tracing` exporter layer for DataDog, without dependencies on `opentelemetry`.

- Exporter for `tracing` traces to DataDog APM
- (Optional) DataDog-compatible log formatting and APM ↔ log correlation
- (Optional) Distributed tracing support for HTTP requests via W3C Trace Context headers
- (Optional) Container-ID tracking for infrastructure metrics in APM

## Features

- `http` - W3C Trace Context header support

## Usage

To enable both trace data and log collection, use the `DataDogTraceLayer` layer
in your `tracing` subscriber:

```rust
use tracing_subscriber::{layer::SubscriberExt, util::SubscriberInitExt};
use tracing_datadog::DataDogTraceLayer;

tracing_subscriber::registry()
   .with(
       DataDogTraceLayer::builder()
           .service("my-service")
           .env("production")
           .version("git sha")
           .agent_address("localhost:8126")
           .enable_logs(true)
           .build()
           .expect("failed to build DataDogTraceLayer"),
   )
   .init();
```

Logs will be emitted to stdout in the DataDog JSON format.

### Span tag semantics

Certain span tags have special meaning in DataDog:

- `service` - can be used to override the service on a per-span basis
- `operation` - maps to DataDog APM operations
- `resource` - maps to DataDog APM resources
- `span.type` - defaults to `internal`, but can be set to `web` for request 
  handlers, `http` for HTTP client requests, or any of `sql`, `cassandra`, 
  `memcached`, `mongodb`, `elasticsearch`, `opensearch`, `redis`, or `db` for 
  data store queries. `custom` can be used for any other type of span.

There are few other semantic conventions, like the ones for [errors](https://docs.datadoghq.com/logs/error_tracking/backend).
[This page](https://docs.datadoghq.com/opentelemetry/mapping/semantic_mapping)
lists a lot of them.

### Distributed tracing over HTTP

To enable distributed tracing over HTTP, enable the `http` feature and use
`DataDogContext` to extract and inject trace context from/into HTTP headers. 
See the API documentation for examples.

## Prior Art

Some code has been adopted for the following projects:

- [tracing-opentelemetry](https://github.com/tokio-rs/tracing-opentelemetry)
- [DatadogFormattingLayer](https://github.com/open-schnick/DatadogFormattingLayer/)
- [fastrace-datadog](https://github.com/fast/fastrace/tree/main/fastrace-datadog)

See also [komoju-datadog](https://github.com/komoju/komoju-datadog) for 
opinionated usage of this library.