app

Documentation

Overview

Package app implements OTEL, prometheus, graceful shutdown and other common application features for go-faster projects.

Index

• func Resource(ctx context.Context) (*resource.Resource, error)
• func Run(f func(ctx context.Context, lg *zap.Logger, m *Metrics) error, op ...Option)
• type Metrics
  • func (m *Metrics) MeterProvider() metric.MeterProvider
  • func (m *Metrics) String() string
  • func (m *Metrics) TextMapPropagator() propagation.TextMapPropagator
  • func (m *Metrics) TracerProvider() trace.TracerProvider
• type Option
  • func WithMeterOptions(opts ...autometer.Option) Option
  • func WithTracerOptions(opts ...autotracer.Option) Option
  • func WithZapConfig(cfg zap.Config) Option

Functions

func Resource

func Resource(ctx context.Context) (*resource.Resource, error)

Resource returns new resource for application.

func Run

func Run(f func(ctx context.Context, lg *zap.Logger, m *Metrics) error, op ...Option)

Run f until interrupt.

If errors.Is(err, ctx.Err()) is valid for returned error, shutdown is considered graceful. Context is cancelled on SIGINT. After watchdogTimeout application is forcefully terminated with exitCodeWatchdog.

Types

type Metrics

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

Metrics implement common basic metrics and infrastructure to it.

func (*Metrics) MeterProvider

func (m *Metrics) MeterProvider() metric.MeterProvider

func (*Metrics) String

func (m *Metrics) String() string

func (*Metrics) TextMapPropagator

func (m *Metrics) TextMapPropagator() propagation.TextMapPropagator

func (*Metrics) TracerProvider

func (m *Metrics) TracerProvider() trace.TracerProvider

type Option

type Option interface {
	// contains filtered or unexported methods
}

Option is a functional option for the application.

func WithMeterOptions

func WithMeterOptions(opts ...autometer.Option) Option

WithMeterOptions sets the default autometer options for the application.

func WithTracerOptions

func WithTracerOptions(opts ...autotracer.Option) Option

WithTracerOptions sets the default autotracer options for the application.

func WithZapConfig

func WithZapConfig(cfg zap.Config) Option

WithZapConfig sets the default zap config for the application.