Skip to content

Commit fcd2d90

Browse files
authored
operate/monitoring/tracing: mention otlp+http (#657)
* operate/monitoring/tracing: mention otlp+http * Update tracing.mdx
1 parent 92cc878 commit fcd2d90

File tree

1 file changed

+8
-4
lines changed

1 file changed

+8
-4
lines changed

docs/operate/monitoring/tracing.mdx

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,22 +17,26 @@ Restate supports the following tracing features:
1717
## Setting up OTLP exporter
1818

1919
Set up the [OTLP exporter](https://github.com/open-telemetry/opentelemetry-collector/blob/main/exporter/otlpexporter/README.md) by pointing the configuration entry `tracing-endpoint` to your trace collector.
20+
By default, a `tracing-endpoint` using the `http://` or `https://` scheme will emit trace data in the OTLP/gRPC format.
21+
Restate also supports the `otlp+http://` and `otlp+https://` schemes, to emit trace data in the OTLP/HTTP format.
22+
Note that when using OTLP/HTTP, the `tracing-endpoint` URI usually needs to include an e.g. `/v1/traces` path.
2023

2124
### Exporting traces to Jaeger
2225

23-
[Jaeger](https://www.jaegertracing.io/docs/2.4/deployment/) accepts OTLP trace data on port `4317`.
26+
[Jaeger](https://www.jaegertracing.io/docs/2.4/deployment/) accepts OTLP trace data on port `4317` (gRPC) and `4318` (HTTP).
2427
Start Jaeger locally with Docker, for example:
2528

2629
```shell
2730
docker run -d --name jaeger \
28-
-p 4317:4317 -p 16686:16686 \
31+
-p 4317:4317 -p 4318:4318 -p 16686:16686 \
2932
jaegertracing/jaeger:2.4.0
3033
```
3134

32-
Configure the tracing endpoint in Restate as a fully specified URL:
35+
Configure the tracing endpoint in Restate as a valid URL:
3336

3437
```shell
35-
restate-server --tracing-endpoint http://localhost:4317
38+
restate-server --tracing-endpoint http://localhost:4317 # for gRPC
39+
restate-server --tracing-endpoint otlp+http://localhost:4318/v1/traces # for HTTP (note /v1/traces)
3640
```
3741

3842
If you run Restate in Docker, then instead add the environment variable `-e RESTATE_TRACING_ENDPOINT=http://host.docker.internal:4317`.

0 commit comments

Comments
 (0)