o11y

Documentation

Overview

Package o11y is the primary entrypoint for wiring up a standard configuration of the o11y observability system.

Index

• func Otel(ctx context.Context, o OtelConfig) (context.Context, func(context.Context), error)
• func Setup(ctx context.Context, o Config) (context.Context, func(context.Context), error)
• type Config
• type OtelConfig

Functions

func Otel

func Otel(ctx context.Context, o OtelConfig) (context.Context, func(context.Context), error)

Otel is the primary entrypoint to initialize the o11y system for otel.

func Setup

func Setup(ctx context.Context, o Config) (context.Context, func(context.Context), error)

Setup is the primary entrypoint to initialize the o11y system.

Types

type Config

type Config struct {
	Statsd            string
	RollbarToken      secret.String
	RollbarEnv        string
	RollbarServerRoot string
	HoneycombEnabled  bool
	HoneycombDataset  string
	HoneycombHost     string
	HoneycombKey      secret.String
	SampleTraces      bool
	SampleKeyFunc     func(map[string]any) string
	SampleRates       map[string]int
	Format            string
	Version           string
	Service           string
	StatsNamespace    string

	// Optional
	Mode                    string
	Debug                   bool
	RollbarDisabled         bool
	StatsdTelemetryDisabled bool
	Writer                  io.Writer
	// Sender allows setting a custom honeycomb sender, Typically the build-in one is preferred.
	Sender transmission.Sender
	// Metrics allows setting a custom metrics client. Typically setting Statsd/StatsNamespace is preferred
	Metrics o11y.ClosableMetricsProvider
}

type OtelConfig

type OtelConfig struct {
	GrpcHostAndPort string
	Dataset         string

	SampleTraces  bool
	SampleKeyFunc func(map[string]interface{}) string
	SampleRates   map[string]uint

	Statsd                  string
	StatsNamespace          string
	StatsdTelemetryDisabled bool

	RollbarToken      secret.String
	RollbarEnv        string
	RollbarServerRoot string
	RollbarDisabled   bool

	Version string
	Service string
	Mode    string
}

OtelConfig contains all the things we need to configure for otel based instrumentation.