1
0
mirror of https://github.com/open-telemetry/opentelemetry-go.git synced 2025-01-05 22:54:18 +02:00
opentelemetry-go/exporters/otlp
Suraj Chafle 85e696d20b
Updating documentation with an working example for creating NewExporter (#1513)
* Updating documentation with an working example for creating NewExporter

* Updated Changelog

* Moved examples in README to testing example

* ExampleTest shouldn't log anything if working as expected

* Fixing the lint

* Fixing the lint

* Review comments

* Changes done moved to Fixed section of Changelog
2021-02-24 09:50:17 -08:00
..
internal Rename otel/label -> otel/attribute (#1541) 2021-02-18 12:59:37 -05:00
otlpgrpc Rename otel/label -> otel/attribute (#1541) 2021-02-18 12:59:37 -05:00
otlphttp Code Improvement - Error strings should not be capitalized (#1488) 2021-02-04 11:32:43 -08:00
doc.go Update README and documentation to better communicate pre-GA state (#1281) 2020-10-29 09:23:13 -07:00
example_test.go Updating documentation with an working example for creating NewExporter (#1513) 2021-02-24 09:50:17 -08:00
go.mod Release v0.17.0 (#1534) 2021-02-15 10:48:14 -08:00
go.sum Organize API into Go modules based on stability and dependencies (#1528) 2021-02-12 08:23:51 -08:00
options.go Move gRPC driver to a subpackage and add an HTTP driver (#1420) 2021-01-11 22:55:24 -05:00
otlp_metric_test.go Rename otel/label -> otel/attribute (#1541) 2021-02-18 12:59:37 -05:00
otlp_span_test.go Rename otel/label -> otel/attribute (#1541) 2021-02-18 12:59:37 -05:00
otlp_test.go Move gRPC driver to a subpackage and add an HTTP driver (#1420) 2021-01-11 22:55:24 -05:00
otlp.go Move gRPC driver to a subpackage and add an HTTP driver (#1420) 2021-01-11 22:55:24 -05:00
protocoldriver.go Add a split protocol driver for otlp exporter (#1418) 2020-12-22 09:21:45 -08:00
README.md Updating documentation with an working example for creating NewExporter (#1513) 2021-02-24 09:50:17 -08:00

OpenTelemetry Collector Go Exporter

PkgGoDev

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.

Retries

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

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.