exporter

Documentation

Overview

Package exporter exposes utilities to create an Alloy component from OpenTelemetry Collector exporters.

Index

• Constants
• type Arguments
• type Exporter
  • func New(opts component.Options, f otelexporter.Factory, args Arguments, ...) (*Exporter, error)
  • func (e *Exporter) CurrentHealth() component.Health
  • func (e *Exporter) Run(ctx context.Context) error
  • func (e *Exporter) Update(args component.Arguments) error
• type TypeSignal
  • func (s TypeSignal) SupportsLogs() bool
  • func (s TypeSignal) SupportsMetrics() bool
  • func (s TypeSignal) SupportsTraces() bool

Constants

const TypeAll = TypeLogs | TypeMetrics | TypeTraces

TypeAll indicates that the exporter supports all telemetry signals.

Types

type Arguments

type Arguments interface {
	component.Arguments

	// Convert converts the Arguments into an OpenTelemetry Collector exporter
	// configuration.
	Convert() (otelcomponent.Config, error)

	// Extensions returns the set of extensions that the configured component is
	// allowed to use.
	Extensions() map[otelcomponent.ID]otelextension.Extension

	// Exporters returns the set of exporters that are exposed to the configured
	// component.
	Exporters() map[otelcomponent.DataType]map[otelcomponent.ID]otelcomponent.Component

	// DebugMetricsConfig returns the configuration for debug metrics
	DebugMetricsConfig() otelcol.DebugMetricsArguments
}

Arguments is an extension of component.Arguments which contains necessary settings for OpenTelemetry Collector exporters.

type Exporter

type Exporter struct {
	// contains filtered or unexported fields
}

Exporter is an Alloy component shim which manages an OpenTelemetry Collector exporter component.

func New

func New(opts component.Options, f otelexporter.Factory, args Arguments, supportedSignals TypeSignal) (*Exporter, error)

New creates a new component which encapsulates an OpenTelemetry Collector exporter. args must hold a value of the argument type registered with the Alloy component.

The registered component must be registered to export the otelcol.ConsumerExports type, otherwise New will panic.

func (*Exporter) CurrentHealth

func (e *Exporter) CurrentHealth() component.Health

CurrentHealth implements component.HealthComponent.

func (*Exporter) Run

func (e *Exporter) Run(ctx context.Context) error

Run starts the Exporter component.

func (*Exporter) Update

func (e *Exporter) Update(args component.Arguments) error

Update implements component.Component. It will convert the Arguments into configuration for OpenTelemetry Collector exporter configuration and manage the underlying OpenTelemetry Collector exporter.

type TypeSignal

type TypeSignal byte

TypeSignal is a bit field to indicate which telemetry signals the exporter supports.

const (
	TypeLogs    TypeSignal = 1 << iota // 1
	TypeMetrics                        // 2
	TypeTraces                         // 4
)

func (TypeSignal) SupportsLogs

func (s TypeSignal) SupportsLogs() bool

SupportsLogs returns true if the exporter supports logs.

func (TypeSignal) SupportsMetrics

func (s TypeSignal) SupportsMetrics() bool

SupportsMetrics returns true if the exporter supports metrics.

func (TypeSignal) SupportsTraces

func (s TypeSignal) SupportsTraces() bool

SupportsTraces returns true if the exporter supports traces.