# Getting started with OpenTelemetry

  • Step 0. Createopen in new window an Uptrace project to obtain a DSN (connection string), for example, https://<token>@api.uptrace.dev/<project_id>.
go get github.com/uptrace/uptrace-go
package main

import (
	"context"
	"errors"
	"fmt"

	"go.opentelemetry.io/otel"
	"go.opentelemetry.io/otel/attribute"

	"github.com/uptrace/uptrace-go/uptrace"
)

func main() {
	ctx := context.Background()

	// Configure OpenTelemetry with sensible defaults.
	uptrace.ConfigureOpentelemetry(&uptrace.Config{
		// copy your project DSN here or use UPTRACE_DSN env var
		DSN: "<dsn>",

		ServiceName:    "myservice",
		ServiceVersion: "1.0.0",
	})
	// Send buffered spans and free resources.
	defer uptrace.Shutdown(ctx)

	// Create a tracer. Usually, tracer is a global variable.
	tracer := otel.Tracer("app_or_package_name")

	// Create a root span (a trace) to measure some operation.
	ctx, main := tracer.Start(ctx, "main-operation")
	// End the span when the operation we are measuring is done.
	defer main.End()

	// The passed ctx carries the parent span (main).
	// That is how OpenTelemetry manages span relations.
	_, child1 := tracer.Start(ctx, "child1-of-main")
	child1.SetAttributes(attribute.String("key1", "value1"))
	child1.RecordError(errors.New("error1"))
	child1.End()

	_, child2 := tracer.Start(ctx, "child2-of-main")
	child2.SetAttributes(attribute.Int("key2", 42), attribute.Float64("key3", 123.456))
	child2.End()

	fmt.Printf("trace: %s\n", uptrace.TraceURL(main))
}
go run main.go
trace: https://uptrace.dev/search/<project_id>?q=<trace_id>

The trace should look like this

Basic trace


By now, you should have a configured OpenTelemetry distribution and an idea how how to create and collect spans. Next, learn about OpenTelemetry API and run more examplesopen in new window.

As a final step, you will need to instrumentopen in new window your application. To help with that, OpenTelemetry comes with plugins for popular frameworks and libraries that automatically create spans for HTTP handlers, gRPC calls, SQL queries, and more.