1
0
mirror of https://github.com/open-telemetry/opentelemetry-go.git synced 2024-12-10 09:50:58 +02:00
OpenTelemetry Go API and SDK https://opentelemetry.io/
Go to file
2019-12-18 10:13:05 -08:00
.circleci Simplify Makefile (#354) 2019-11-27 11:27:41 -08:00
api rename Message in Event to Name (#389) 2019-12-18 10:13:05 -08:00
bridge/opentracing rename Message in Event to Name (#389) 2019-12-18 10:13:05 -08:00
example Rename CurrentSpan to SpanFromContext & SetCurrentSpan to ContextWithSpan (#379) 2019-12-11 08:51:32 -08:00
exporter rename Message in Event to Name (#389) 2019-12-18 10:13:05 -08:00
internal rename Message in Event to Name (#389) 2019-12-18 10:13:05 -08:00
plugin Rename CurrentSpan to SpanFromContext & SetCurrentSpan to ContextWithSpan (#379) 2019-12-11 08:51:32 -08:00
sdk rename Message in Event to Name (#389) 2019-12-18 10:13:05 -08:00
.gitignore Consistently use pointer receivers for core.Number (#375) 2019-12-09 13:03:11 -08:00
.golangci.yml Enable golint & gofmt, resolve issues (#214) 2019-10-16 10:24:38 -07:00
CODEOWNERS Remove myself (sjkaris) as a CODEOWNER (#373) 2019-12-06 14:02:47 -08:00
CONTRIBUTING.md Namespace import path under "/otel" (#274) 2019-11-01 11:40:29 -07:00
get_main_pkgs.sh Use /usr/bin/env bash rather than /bin/bash (#336) 2019-11-21 16:19:11 -08:00
go.mod Prometheus exporter (#334) 2019-11-26 11:47:15 -08:00
go.sum Prometheus exporter (#334) 2019-11-26 11:47:15 -08:00
LICENSE Initial commit 2019-05-16 12:05:27 -07:00
Makefile exclude example dirs from coverage test/report. (#365) 2019-12-02 23:58:53 -08:00
README.md update release schedule. (#378) 2019-12-09 15:31:25 -08:00
tools.go Run go generate during make and make sure that generated files are in sync in CI (#101) 2019-08-22 11:16:51 -07:00

OpenTelemetry-Go

Circle CI Docs Go Report Card Gitter

The Go OpenTelemetry client.

Installation

This repository includes multiple packages. The api package contains core data types, interfaces and no-op implementations that comprise the OpenTelemetry API following the specification. The sdk package is the reference implementation of the API.

Libraries that produce telemetry data should only depend on api and defer the choice of the SDK to the application developer. Applications may depend on sdk or another package that implements the API.

To install the API and SDK packages,

$ go get -u go.opentelemetry.io/otel

Quick Start

package main

import (
	"context"
	"log"

	"go.opentelemetry.io/otel/api/global"
	"go.opentelemetry.io/otel/exporter/trace/stdout"
	sdktrace "go.opentelemetry.io/otel/sdk/trace"
)

func initTracer() {
	exporter, err := stdout.NewExporter(stdout.Options{PrettyPrint: true})
	if err != nil {
		log.Fatal(err)
	}
	tp, err := sdktrace.NewProvider(sdktrace.WithConfig(sdktrace.Config{DefaultSampler: sdktrace.AlwaysSample()}),
		sdktrace.WithSyncer(exporter))
	if err != nil {
		log.Fatal(err)
	}
	global.SetTraceProvider(tp)
}

func main() {
	initTracer()
	tracer := global.TraceProvider().Tracer("ex.com/basic")

	tracer.WithSpan(context.Background(), "foo",
		func(ctx context.Context) error {
			tracer.WithSpan(ctx, "bar",
				func(ctx context.Context) error {
					tracer.WithSpan(ctx, "baz",
						func(ctx context.Context) error {
							return nil
						},
					)
					return nil
				},
			)
			return nil
		},
	)
}

See the API documentation for more detail, and the opentelemetry-example-app for a complete example.

Contributing

See the contributing file.

Release Schedule

OpenTelemetry Go is under active development. Below is the release schedule for the Go library. The first version of the release isn't guaranteed to conform to a specific version of the specification, and future releases will not attempt to maintain backward compatibility with the alpha release.

Component Version Target Date Release Date
Tracing API Alpha v0.1.0 October 28 2019 November 05 2019
Tracing SDK Alpha v0.1.0 October 28 2019 November 05 2019
Jaeger Trace Exporter Alpha v0.1.0 October 28 2019 November 05 2019
Trace Context Propagation Alpha v0.1.0 Unknown November 05 2019
OpenTracing Bridge Alpha v0.1.0 October November 05 2019
Metrics API Alpha v0.2.0 October 28 2019 December 03 2019
Metrics SDK Alpha v0.2.0 October 28 2019 December 03 2019
Prometheus Metrics Exporter Alpha v0.2.0 October 28 2019 December 03 2019
Context Prop. rename/Baggage Alpha v0.3.0 December 23 2019 -
OpenTelemetry Collector Exporter Alpha v0.4.0 January 15 2020 -
Zipkin Trace Exporter Alpha Unknown -
OpenCensus Bridge Alpha Unknown -