auth

Documentation

Overview

Package auth provides utilities to create a Flow component from OpenTelemetry Collector authentication extensions.

Other OpenTelemetry Collector extensions are better served as generic Flow components rather than being placed in the otelcol namespace.

Index

• type Arguments
• type Auth
  • func New(opts component.Options, f otelcomponent.ExtensionFactory, args Arguments) (*Auth, error)
  • func (a *Auth) CurrentHealth() component.Health
  • func (a *Auth) Run(ctx context.Context) error
  • func (a *Auth) Update(args component.Arguments) error
• type Exports
• type Handler
  • func (Handler) RiverCapsule()

Types

type Arguments

type Arguments interface {
	component.Arguments

	// Convert converts the Arguments into an OpenTelemetry Collector
	// authentication extension configuration.
	Convert() otelconfig.Extension

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

	// Exporters returns the set of exporters that are exposed to the configured
	// component.
	Exporters() map[otelconfig.DataType]map[otelconfig.ComponentID]otelcomponent.Exporter
}

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

type Auth

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

Auth is a Flow component shim which manages an OpenTelemetry Collector authentication extension.

func New

func New(opts component.Options, f otelcomponent.ExtensionFactory, args Arguments) (*Auth, error)

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

The registered component must be registered to export the Exports type from this package, otherwise New will panic.

func (*Auth) CurrentHealth

func (a *Auth) CurrentHealth() component.Health

CurrentHealth implements component.HealthComponent.

func (*Auth) Run

func (a *Auth) Run(ctx context.Context) error

Run starts the Auth component.

func (*Auth) Update

func (a *Auth) Update(args component.Arguments) error

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

type Exports

type Exports struct {
	// Handler is the managed component. Handler is updated any time the
	// extension is updated.
	Handler Handler `river:"handler,attr"`
}

Exports is a common Exports type for Flow components which expose OpenTelemetry Collector authentication extensions.

type Handler

type Handler struct {
	ID        otelconfig.ComponentID
	Extension otelcomponent.Extension
}

Handler combines an extension with its ID.

func (Handler) RiverCapsule

func (Handler) RiverCapsule()

RiverCapsule marks Handler as a capsule type.