mirror of
https://github.com/caddyserver/website.git
synced 2025-04-23 05:26:16 -04:00
c734cc3e64
* Add documentation for tracing directive * Update header in tracing.md Co-authored-by: Matt Holt <mholt@users.noreply.github.com> * Update documentation in tracing.md Co-authored-by: Matt Holt <mholt@users.noreply.github.com> * add link to the repository * add link to gRPC repo and w3c specification Co-authored-by: Andrii Kushch <> Co-authored-by: Matt Holt <mholt@users.noreply.github.com>
53 lines
1.5 KiB
Markdown
53 lines
1.5 KiB
Markdown
---
|
|
title: tracing (Caddyfile directive)
|
|
---
|
|
|
|
# tracing
|
|
|
|
It provides integration with OpenTelemetry tracing facilities.
|
|
|
|
When enabled, it will propagate an existing trace context or initialize a new one.
|
|
|
|
It is based on [github.com/open-telemetry/opentelemetry-go](https://github.com/open-telemetry/opentelemetry-go).
|
|
|
|
It uses [gRPC](https://github.com/grpc/) as an exporter protocol and W3C [tracecontext](https://www.w3.org/TR/trace-context/) and [baggage](https://www.w3.org/TR/baggage/) as propagators.
|
|
|
|
## Syntax
|
|
|
|
```caddy-d
|
|
tracing {
|
|
[span <span_name>]
|
|
}
|
|
```
|
|
|
|
- **<span_name>** - is a span name. Please see span naming [guidelines](https://github.com/open-telemetry/opentelemetry-specification/blob/v1.7.0/specification/trace/api.md).
|
|
|
|
## Configuration
|
|
|
|
### Environment variables
|
|
|
|
It can be configured using the environment variables defined
|
|
by the [OpenTelemetry Environment Variable Specification](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/sdk-environment-variables.md).
|
|
|
|
For the exporter configuration details, please
|
|
see [spec](https://github.com/open-telemetry/opentelemetry-specification/blob/v1.7.0/specification/protocol/exporter.md).
|
|
|
|
For example:
|
|
|
|
```bash
|
|
export OTEL_EXPORTER_OTLP_HEADERS="myAuthHeader=myToken,anotherHeader=value"
|
|
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://my-otlp-endpoint:55680
|
|
```
|
|
|
|
## Examples
|
|
|
|
Here is a **Caddyfile** example:
|
|
|
|
```
|
|
handle /myHandler {
|
|
tracing {
|
|
span my-span
|
|
}
|
|
reverse_proxy 127.0.0.1:8081
|
|
}
|
|
```
|