1
0
mirror of https://github.com/open-telemetry/opentelemetry-go.git synced 2024-12-04 09:43:23 +02:00
OpenTelemetry Go API and SDK https://opentelemetry.io/
Go to file
Gustavo Silva Paiva ecf3bb9d7c handle multiples connect start/done trace (#283)
* handle race condition: close handled before open

* add dummy noop span.

* add test for clienttrace

* accept multiples `ConnectStart`/`ConnectDone` trace hooks.

* formatting

*  change argument name and add error/attributes to end method.

* add tests for connection race condition
2019-11-03 15:46:57 -08:00
.circleci Automate getting the list of examples to build (and switch to go 1.13 to avoid module problems) (#246) 2019-10-29 08:45:48 -07:00
api api/distributedcontext: add Map unit tests (#270) 2019-11-02 14:46:13 -07:00
bridge/opentracing Namespace import path under "/otel" (#274) 2019-11-01 11:40:29 -07:00
example remove rSSP and rBSP code, use NewProvider instead. (#271) 2019-11-01 16:35:18 -07:00
exporter/trace remove rSSP and rBSP code, use NewProvider instead. (#271) 2019-11-01 16:35:18 -07:00
global Namespace import path under "/otel" (#274) 2019-11-01 11:40:29 -07:00
internal Namespace import path under "/otel" (#274) 2019-11-01 11:40:29 -07:00
plugin handle multiples connect start/done trace (#283) 2019-11-03 15:46:57 -08:00
propagation Namespace import path under "/otel" (#274) 2019-11-01 11:40:29 -07:00
sdk remove rSSP and rBSP code, use NewProvider instead. (#271) 2019-11-01 16:35:18 -07:00
.gitignore sdk/trace: Test the Sampling Probability (#247) 2019-10-29 16:53:50 -07:00
.golangci.yml Enable golint & gofmt, resolve issues (#214) 2019-10-16 10:24:38 -07:00
CODEOWNERS Add jmacd as a code owner (#42) 2019-07-02 14:03:36 -07:00
CONTRIBUTING.md Namespace import path under "/otel" (#274) 2019-11-01 11:40:29 -07:00
get_main_pkgs.sh Automate getting the list of examples to build (and switch to go 1.13 to avoid module problems) (#246) 2019-10-29 08:45:48 -07:00
go.mod Namespace import path under "/otel" (#274) 2019-11-01 11:40:29 -07:00
go.sum Metrics SDK work-in-progress (#172) 2019-10-29 13:27:22 -07:00
LICENSE Initial commit 2019-05-16 12:05:27 -07:00
Makefile build all tests and run all tests too (#254) 2019-10-30 10:09:18 -07:00
README.md Namespace import path under "/otel" (#274) 2019-11-01 11:40:29 -07: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"

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

func initTracer() {
	sdktrace.Register()

	exporter, err := stdout.NewExporter(stdout.Options{PrettyPrint: true})
	if err != nil {
		log.Fatal(err)
	}

	ssp := sdktrace.NewSimpleSpanProcessor(exporter)
	sdktrace.RegisterSpanProcessor(ssp)

	// For the demonstration, use sdktrace.AlwaysSample sampler to sample all traces.
	// In a production application, use sdktrace.ProbabilitySampler with a desired probability.
	sdktrace.ApplyConfig(sdktrace.Config{DefaultSampler: sdktrace.AlwaysSample()})
}

func main() {
	initTracer()

	apitrace.GlobalTracer().WithSpan(context.Background(), "foo",
		func(ctx context.Context) error {
			apitrace.GlobalTracer().WithSpan(ctx, "bar",
				func(ctx context.Context) error {
					apitrace.GlobalTracer().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
Tracing API Alpha October 28 2019
Tracing SDK Alpha October 28 2019
Metrics API Alpha October 28 2019
Metrics SDK Alpha October 28 2019
Zipkin Trace Exporter Alpha Unknown
Jaeger Trace Exporter Alpha October 28 2019
Prometheus Metrics Exporter Alpha October 28 2019
Trace Context Propagation Alpha Unknown
OpenTracing Bridge Alpha October
OpenCensus Bridge Alpha Unknown