autoexport

package module
v0.0.0-...-806a58a Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 9, 2024 License: Apache-2.0 Imports: 20 Imported by: 0

Documentation

Overview

Package autoexport provides OpenTelemetry exporter factory functions with defaults and environment variable support as defined by the OpenTelemetry specification.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func IsNoneMetricReader

func IsNoneMetricReader(e metric.Reader) bool

IsNoneMetricReader returns true for the exporter returned by NewMetricReader when OTEL_METRICS_EXPORTER environment variable is set to "none".

func IsNoneSpanExporter

func IsNoneSpanExporter(e trace.SpanExporter) bool

IsNoneSpanExporter returns true for the exporter returned by NewSpanExporter when OTEL_TRACES_EXPORTER environment variable is set to "none".

func NewMetricReader

func NewMetricReader(ctx context.Context, opts ...MetricOption) (metric.Reader, error)

NewMetricReader returns a configured go.opentelemetry.io/otel/sdk/metric.Reader defined using the environment variables described below.

OTEL_METRICS_EXPORTER defines the metrics exporter; supported values:

OTEL_EXPORTER_OTLP_PROTOCOL defines OTLP exporter's transport protocol; supported values:

OTEL_EXPORTER_PROMETHEUS_HOST (defaulting to "localhost") and OTEL_EXPORTER_PROMETHEUS_PORT (defaulting to 9464) define the host and port for the Prometheus exporter's HTTP server.

An error is returned if an environment value is set to an unhandled value.

Use RegisterMetricReader to handle more values of OTEL_METRICS_EXPORTER.

Use WithFallbackMetricReader option to change the returned exporter when OTEL_METRICS_EXPORTER is unset or empty.

Use IsNoneMetricReader to check if the retured exporter is a "no operation" exporter.

func NewSpanExporter

func NewSpanExporter(ctx context.Context, opts ...SpanOption) (trace.SpanExporter, error)

NewSpanExporter returns a configured go.opentelemetry.io/otel/sdk/trace.SpanExporter defined using the environment variables described below.

OTEL_TRACES_EXPORTER defines the traces exporter; supported values:

OTEL_EXPORTER_OTLP_PROTOCOL defines OTLP exporter's transport protocol; supported values:

An error is returned if an environment value is set to an unhandled value.

Use RegisterSpanExporter to handle more values of OTEL_TRACES_EXPORTER.

Use WithFallbackSpanExporter option to change the returned exporter when OTEL_TRACES_EXPORTER is unset or empty.

Use IsNoneSpanExporter to check if the retured exporter is a "no operation" exporter.

func RegisterMetricReader

func RegisterMetricReader(name string, factory func(context.Context) (metric.Reader, error))

RegisterMetricReader sets the MetricReader factory to be used when the OTEL_METRICS_EXPORTERS environment variable contains the exporter name. This will panic if name has already been registered.

func RegisterSpanExporter

func RegisterSpanExporter(name string, factory func(context.Context) (trace.SpanExporter, error))

RegisterSpanExporter sets the SpanExporter factory to be used when the OTEL_TRACES_EXPORTERS environment variable contains the exporter name. This will panic if name has already been registered.

Types

type MetricOption

type MetricOption = option[metric.Reader]

MetricOption applies an autoexport configuration option.

func WithFallbackMetricReader

func WithFallbackMetricReader(metricReaderFactory func(ctx context.Context) (metric.Reader, error)) MetricOption

WithFallbackMetricReader sets the fallback exporter to use when no exporter is configured through the OTEL_METRICS_EXPORTER environment variable.

type Option deprecated

type Option = SpanOption

Option applies an autoexport configuration option.

Deprecated: Use SpanOption.

type SpanOption

type SpanOption = option[trace.SpanExporter]

SpanOption applies an autoexport configuration option.

func WithFallbackSpanExporter

func WithFallbackSpanExporter(spanExporterFactory func(ctx context.Context) (trace.SpanExporter, error)) SpanOption

WithFallbackSpanExporter sets the fallback exporter to use when no exporter is configured through the OTEL_TRACES_EXPORTER environment variable.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL