opentelemetry-go/example

Example

Here is a collection of OpenTelemtry-Go examples showcasing basic functionality.

OTLP

This example demonstrates how to export trace and metric data from an application using OpenTelemetry's own wire protocal OTLP.

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.
• stdout exporter to print information about spans in the terminal

How to run?

Prequisites

• go 1.13 installed
• GOPATH is configured.

1 Download git repo

GO111MODULE="" go get -d go.opentelemetry.io/otel

2 Start Server

cd $GOPATH/src/go.opentelemetry.io/otel/example/http/
go run ./server/server.go

3 Start Client

cd $GOPATH/src/go.opentelemetry.io/otel/example/http/
go run ./client/client.go

4 Check traces in stdout

The spans should be visible in stdout in the order that they were exported.