Skip to content

Commit

Permalink
content/en/docs/next/op-guide/monitoring.md: Add distributed tracing
Browse files Browse the repository at this point in the history
  • Loading branch information
lilic committed Jun 10, 2021
1 parent 0668c0c commit 5c184b7
Showing 1 changed file with 17 additions and 0 deletions.
17 changes: 17 additions & 0 deletions content/en/docs/next/op-guide/monitoring.md
Original file line number Diff line number Diff line change
Expand Up @@ -129,6 +129,23 @@ Sample dashboard:

![](../etcd-sample-grafana.png)

## Distributed tracing

In v3.5 etcd has added support for distributed tracing using [OpenTelemetry](https://github.com/open-telemetry).

> Note: This feature is still experimental and can change at any time.
To enable this experimental feature, pass the `--experimental-enable-distributed-tracing=true` to the etcd server. Setup and configure the distributed tracing by starting etcd server with the following flags:

`--experimental-distributed-tracing-address` - (Optional) - "localhost:4317" - Address of the tracing collector.

`--experimental-distributed-tracing-service-name` - (Optional) - "etcd" - Distributed tracing service name, must be same across all etcd instances.

`--experimental-distributed-tracing-instance-id` - (Optional) - Instace ID, while optional it's strongly recommended to set, must be unique per etcd instance.

Before enabling the distributed tracing, make sure to have the OpenTelemetry endpoint, if that address differs to the default one, override with the `--experimental-distributed-tracing-address` flag. Due to OpenTelemetry having different ways of running, refer to the [collector documentation](https://opentelemetry.io/docs/collector/getting-started/) to learn more.

> Note: There is a resource overhead, as with any observability signal, according to our initial measurements that overhead could be between 2% - 4% CPU overhead.
[grafana]: http://grafana.org/
[prometheus]: https://prometheus.io/
Expand Down

0 comments on commit 5c184b7

Please sign in to comment.