mirror of
https://github.com/open-telemetry/opentelemetry-go.git
synced 2025-03-03 14:52:56 +02:00
60 lines
1.3 KiB
Markdown
60 lines
1.3 KiB
Markdown
|
# Example
|
||
|
|
|
||
|
|
## HTTP
|
||
|
|
This is a simple example that demonstrates tracing http request from client to server. The example
|
||
|
|
shows key aspects of tracing such as
|
||
|
|
- Root Span (on Client)
|
||
|
|
- Child Span (on Client)
|
||
|
|
- Child Span from a Remote Parent (on Server)
|
||
|
|
- SpanContext Propagation (from Client to Server)
|
||
|
|
- Span Events
|
||
|
|
- Span Attributes
|
||
|
|
|
||
|
|
Example uses
|
||
|
|
- open-telemetry SDK as trace instrumentation provider,
|
||
|
|
- httptrace plugin to facilitate tracing http request on client and server
|
||
|
|
- http trace_context propagation to propagate SpanContext on the wire.
|
||
|
|
- jaeger exporter to export spans to visualize and store them.
|
||
|
|
|
||
|
|
### How to run?
|
||
|
|
|
||
|
|
#### Prequisites
|
||
|
|
|
||
|
|
- go 1.12 installed
|
||
|
|
- GOPATH is configured.
|
||
|
|
|
||
|
|
#### 1 Download git repo
|
||
|
|
```
|
||
|
|
GO111MODULE="" go get -d go.opentelemetry.io
|
||
|
|
```
|
||
|
|
|
||
|
|
#### 2 Start All-in-one Jaeger
|
||
|
|
|
||
|
|
```
|
||
|
|
docker run -d --name jaeger \
|
||
|
|
-p 16686:16686 \
|
||
|
|
-p 14268:14268 \
|
||
|
|
jaegertracing/all-in-one:1.8
|
||
|
|
```
|
||
|
|
|
||
|
|
#### 3 Start Server
|
||
|
|
```
|
||
|
|
cd $GOPATH/src/go.opentelemetry.io/example/http/
|
||
|
|
go run ./server/server.go
|
||
|
|
```
|
||
|
|
|
||
|
|
#### 4 Start Client
|
||
|
|
```
|
||
|
|
cd $GOPATH/src/go.opentelemetry.io/example/http/
|
||
|
|
go run ./client/client.go
|
||
|
|
```
|
||
|
|
|
||
|
|
#### 5 Check traces on Jaeger UI
|
||
|
|
|
||
|
|
Visit http://localhost:16686 with a web browser
|
||
|
|
Click on 'Find' to see traces.
|
||
|
|
|
||
|
|
[Sample Snapshot](http/images/JaegarTraceExample.png)
|
||
|
|
|
||
|
|
|