slogbetterstack

README

Better Stack Go client

Experience SQL-compatible structured log management based on ClickHouse. Learn more ⇗

Documentation

Getting started ⇗

Need help?

Please let us know at hello@betterstack.com. We're happy to help!

Credits

slog-betterstack was created and maintained by Samuel Berthe and released under the MIT license. Thank you, Samuel! ❤️

---

MIT license, example project

Documentation

Index

• Constants
• Variables
• func DefaultConverter(addSource bool, replaceAttr func(groups []string, a slog.Attr) slog.Attr, ...) map[string]any
• type BetterstackHandler
  • func (h *BetterstackHandler) Enabled(_ context.Context, level slog.Level) bool
  • func (h *BetterstackHandler) Handle(ctx context.Context, record slog.Record) error
  • func (h *BetterstackHandler) WithAttrs(attrs []slog.Attr) slog.Handler
  • func (h *BetterstackHandler) WithGroup(name string) slog.Handler
• type Converter
• type Option
  • func (o Option) NewBetterstackHandler() slog.Handler

Constants

const BetterstackEndpoint = "https://in.logs.betterstack.com/"

Variables

var ContextKey = "extra"

var ErrorKeys = []string{"error", "err"}

var SourceKey = "runtime"

Functions

func DefaultConverter

func DefaultConverter(addSource bool, replaceAttr func(groups []string, a slog.Attr) slog.Attr, loggerAttr []slog.Attr, groups []string, record *slog.Record) map[string]any

Types

type BetterstackHandler

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

func (*BetterstackHandler) Enabled

func (h *BetterstackHandler) Enabled(_ context.Context, level slog.Level) bool

func (*BetterstackHandler) Handle

func (h *BetterstackHandler) Handle(ctx context.Context, record slog.Record) error

func (*BetterstackHandler) WithAttrs

func (h *BetterstackHandler) WithAttrs(attrs []slog.Attr) slog.Handler

func (*BetterstackHandler) WithGroup

func (h *BetterstackHandler) WithGroup(name string) slog.Handler

type Converter

type Converter func(addSource bool, replaceAttr func(groups []string, a slog.Attr) slog.Attr, loggerAttr []slog.Attr, groups []string, record *slog.Record) map[string]any

type Option

type Option struct {
	// log level (default: debug)
	Level slog.Leveler

	// token
	Token string
	// optional: endpoint
	Endpoint string
	// default: 10s
	Timeout time.Duration

	// optional: customize record builder
	Converter Converter
	// optional: custom marshaler
	Marshaler func(v any) ([]byte, error)
	// optional: fetch attributes from context
	AttrFromContext []func(ctx context.Context) []slog.Attr

	// optional: see slog.HandlerOptions
	AddSource   bool
	ReplaceAttr func(groups []string, a slog.Attr) slog.Attr
}

func (Option) NewBetterstackHandler

func (o Option) NewBetterstackHandler() slog.Handler