1
0
mirror of https://github.com/open-telemetry/opentelemetry-go.git synced 2024-12-04 09:43:23 +02:00
opentelemetry-go/exporters/otlp
Tyler Yahn 2b1998f1b4
Remove tests
The lack of programmatic enablement of retries means testing is going to
be flaky or cumbersome.
2020-05-29 10:23:01 -07:00
..
internal/transform Move Resource into the metric export Record (#739) 2020-05-18 17:44:28 -07:00
alignment_test.go Update project License headers and checking (#596) 2020-03-25 14:47:17 -07:00
connection.go Update project License headers and checking (#596) 2020-03-25 14:47:17 -07:00
doc.go Update project License headers and checking (#596) 2020-03-25 14:47:17 -07:00
example_test.go Rename ScheduleDelayMillis to BatchTimeout (#752) 2020-05-20 10:12:57 -07:00
go.mod "Working" tests with failure 2020-05-29 10:18:36 -07:00
go.sum "Working" tests with failure 2020-05-29 10:18:36 -07:00
mock_collector_test.go Update project License headers and checking (#596) 2020-03-25 14:47:17 -07:00
options.go Update options 2020-05-29 10:17:57 -07:00
otlp_integration_test.go Remove tests 2020-05-29 10:23:01 -07:00
otlp_metric_test.go Refactor the api/metrics push controller; add CheckpointSet synchronization (#737) 2020-05-18 18:37:41 -07:00
otlp_span_test.go Move core and key to kv package (#720) 2020-05-13 16:06:03 -07:00
otlp.go Proof of concept 2020-05-21 09:45:24 -07:00
README.md Update README 2020-05-29 10:13:00 -07:00

OpenTelemetry Collector Go Exporter

GoDoc

This exporter exports OpenTelemetry spans and metrics to the OpenTelemetry Collector.

Installation and Setup

The exporter can be installed using standard go functionality.

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

A new exporter can be created using the NewExporter function.

package main

import (
	"log"

	"go.opentelemetry.io/otel/exporters/otlp"
	"go.opentelemetry.io/otel/sdk/metric/controller/push"
	"go.opentelemetry.io/otel/sdk/metric/selector/simple"
	sdktrace "go.opentelemetry.io/otel/sdk/trace"
)

func main() {
	exporter, err := otlp.NewExporter() // Configure as needed.
	if err != nil {
		log.Fatalf("failed to create exporter: %v", err)
	}
	defer func() {
		err := exporter.Stop()
		if err != nil {
			log.Fatalf("failed to stop exporter: %v", err)
		}
	}()

	// Note: The exporter can also be used as a Batcher.
	traceProvider, err := sdktrace.NewProvider(sdktrace.WithSyncer(exporter))
	if err != nil {
		log.Fatal("failed to create trace provider: %v", err)
	}

	pusher := push.New(simple.NewWithExactDistribution(), exporter)
	pusher.Start()
	metricProvider := pusher.Provider()

	// Your code here ...
}

Configuration

Configuratin options can be specified when creating a new exporter (NewExporter).

WorkerCount(n uint)

Sets the number of Goroutines to use when processing telemetry.

WithInsecure()

Disables client transport security for the exporter's gRPC connection just like grpc.WithInsecure() does. By default, client security is required unless WithInsecure is used.

WithAddress(addr string)

Sets the address that the exporter will connect to the collector on. The default address the exporter connects to is localhost:55680.

WithReconnectionPeriod(rp time.Duration)

Set the delay between connection attempts after failing to connect with the collector.

WithCompressor(compressor string)

Set the compressor for the gRPC client to use when sending requests. The compressor used needs to have been registered with google.golang.org/grpc/encoding prior to using here. This can be done by encoding.RegisterCompressor. Some compressors auto-register on import, such as gzip, which can be registered by calling import _ "google.golang.org/grpc/encoding/gzip".

WithHeaders(headers map[string]string)

Headers to send when the gRPC stream connection is instantiated.

WithTLSCredentials(creds "google.golang.org/grpc/credentials".TransportCredentials)

TLS credentials to use when talking to the server.

WithGRPCServiceConfig(serviceConfig string)

The default gRPC service config used when .

By default, the exporter is configured to support retries.

{
	"methodConfig":[{
		"name":[
			{ "service":"opentelemetry.proto.collector.metrics.v1.MetricsService" },
			{ "service":"opentelemetry.proto.collector.trace.v1.TraceService" }
		],
		"waitForReady": true,
		"retryPolicy":{
			"MaxAttempts":5,
			"InitialBackoff":"0.3s",
			"MaxBackoff":"5s",
			"BackoffMultiplier":2,
			"RetryableStatusCodes":[
				"UNAVAILABLE",
				"CANCELLED",
				"DEADLINE_EXCEEDED",
				"RESOURCE_EXHAUSTED",
				"ABORTED",
				"OUT_OF_RANGE",
				"UNAVAILABLE",
				"DATA_LOSS"
			]
		}
	}]
}

WithGRPCDialOption(opts ..."google.golang.org/grpc".DialOption)

Additional grpc.DialOption to be used.

These options take precedence over any other set by other parts of the configuration.

Retries

The exporter will not, by default, retry failed requests to the collector. However, it is configured in a way that it can easily be enable.

To enable retries, the GRPC_GO_RETRY environment variable needs to be set to on. For example,

GRPC_GO_RETRY=on go run .

The default service config used by default is defined to retry failed requests with exponential backoff (0.3seconds * (2)^retry) with a max of 5 retries).

These retries are only attempted for reponses that are deemed "retry-able" by the collector.