log

package
v3.32.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 4, 2024 License: Apache-2.0 Imports: 11 Imported by: 7

Documentation

Overview

Package log contains all the structs to log TTN.

Index

Examples

Constants

This section is empty.

Variables

View Source
var ErrInvalidLevel = errors.New("Invalid log level")

ErrInvalidLevel indicates an invalid log level

View Source
var Noop = &noop{}

Noop just does nothing.

View Source
var NoopHandler = &noopHandler{}

NoopHandler is a handler that does nothing.

Functions

func Debug

func Debug(ctx context.Context, msg string)

Debug calls FromContext(ctx).Debug

func Debugf

func Debugf(ctx context.Context, msg string, v ...any)

Debugf calls FromContext(ctx).Debugf

func Error

func Error(ctx context.Context, msg string)

Error calls FromContext(ctx).Error

func Errorf

func Errorf(ctx context.Context, msg string, v ...any)

Errorf calls FromContext(ctx).Errorf

func Fatal

func Fatal(ctx context.Context, msg string)

Fatal calls FromContext(ctx).Fatal

func Fatalf

func Fatalf(ctx context.Context, msg string, v ...any)

Fatalf calls FromContext(ctx).Fatalf

func Info

func Info(ctx context.Context, msg string)

Info calls FromContext(ctx).Info

func Infof

func Infof(ctx context.Context, msg string, v ...any)

Infof calls FromContext(ctx).Infof

func NewContext

func NewContext(ctx context.Context, logger Interface) context.Context

NewContext returns a derived context with the logger set.

func NewContextWithField

func NewContextWithField(ctx context.Context, k string, v any) context.Context

NewContextWithField returns a derived context with the given field added to the logger.

func NewContextWithFields

func NewContextWithFields(ctx context.Context, f Fielder) context.Context

NewContextWithFields returns a derived context with the given fields added to the logger.

func Warn

func Warn(ctx context.Context, msg string)

Warn calls FromContext(ctx).Warn

func Warnf

func Warnf(ctx context.Context, msg string, v ...any)

Warnf calls FromContext(ctx).Warnf

Types

type Entry

type Entry interface {
	Level() Level
	Fields() Fielder
	Message() string
	Timestamp() time.Time
}

Entry is the interface of log entries.

type F

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

F is a Fielder that uses structural sharing to avoid copying entries. Setting a key is O(1), getting a key is O(n) (where n is the number of entries), but we only use this to accumulate fields so that's ok.

func Fields

func Fields(pairs ...any) *F

Fields returns a new immutable fields structure.

func (*F) Fields

func (f *F) Fields() map[string]any

Fields implements Fielder. Returns all fields in O(n), where n is the number of entries in the map.

func (*F) Get

func (f *F) Get(key string) (any, bool)

Get returns the key from the fields in O(n), where n is the number of entries.

func (*F) With

func (f *F) With(nodes map[string]any) *F

With returns a new F that has the fields in nodes.

func (*F) WithError

func (f *F) WithError(err error) *F

WithError returns new fields that contain the passed error and all its fields (if any).

func (*F) WithField

func (f *F) WithField(name string, val any) *F

WithField returns a new fielder that has the key set to value.

func (*F) WithFields

func (f *F) WithFields(fields Fielder) *F

WithFields returns a new fielder that has all the fields of the other fielder.

type Fielder

type Fielder interface {
	Fields() map[string]any
}

Fielder is the interface for anything that can have fields.

type Handler

type Handler interface {
	HandleLog(Entry) error
}

Handler is the interface of things that can handle log entries.

func NewZap added in v3.13.2

func NewZap(encoding string) (Handler, error)

NewZap returns a new log handler based on the zap library.

type HandlerFunc

type HandlerFunc func(Entry) error

HandlerFunc is a function that implements Handler.

func (HandlerFunc) HandleLog

func (fn HandlerFunc) HandleLog(e Entry) error

HandleLog implements Handler.

type Interface

type Interface interface {
	Debug(args ...any)
	Info(args ...any)
	Warn(args ...any)
	Error(args ...any)
	Fatal(args ...any)
	Debugf(msg string, v ...any)
	Infof(msg string, v ...any)
	Warnf(msg string, v ...any)
	Errorf(msg string, v ...any)
	Fatalf(msg string, v ...any)
	WithField(string, any) Interface
	WithFields(Fielder) Interface
	WithError(error) Interface
}

Interface is the interface for logging TTN.

func FromContext

func FromContext(ctx context.Context) Interface

FromContext returns the logger that is attached to the context or returns the Noop logger if it does not exist

func WithError

func WithError(ctx context.Context, err error) Interface

WithError calls FromContext(ctx).WithError

func WithField

func WithField(ctx context.Context, k string, v any) Interface

WithField calls FromContext(ctx).WithField

func WithFields

func WithFields(ctx context.Context, f Fielder) Interface

WithFields calls FromContext(ctx).WithFields

type Level

type Level int8

Level is the level of logging.

const (

	// DebugLevel is the log level for debug messages, usually turned of in production.
	DebugLevel Level

	// InfoLevel is the log level for informational messages.
	InfoLevel

	// WarnLevel is the log level for warnings.
	// Warnings are more important than info but do not need individual human review.
	WarnLevel

	// ErrorLevel is the log level for high priority error messages.
	// When everything is running smoothly, an application should not be logging error level messages.
	ErrorLevel

	// FatalLevel the log level for unrecoverable errors.
	// Using this level will exit the program.
	FatalLevel
)

func ParseLevel

func ParseLevel(str string) (Level, error)

ParseLevel parses a string into a log level or returns an error otherwise.

func (Level) MarshalText

func (l Level) MarshalText() ([]byte, error)

MarshalText implments encoding.TextMarshaller.

func (Level) String

func (l Level) String() string

String implements fmt.Stringer.

func (*Level) UnmarshalConfigString

func (l *Level) UnmarshalConfigString(str string) error

UnmarshalConfigString implements config.Configurable.

func (*Level) UnmarshalText

func (l *Level) UnmarshalText(text []byte) error

UnmarshalText implments encoding.TextMarshaller.

type Logger

type Logger struct {
	Level   Level
	Handler Handler
	// contains filtered or unexported fields
}

Logger implements Stack.

func NewLogger

func NewLogger(handler Handler, opts ...Option) *Logger

NewLogger creates a new logger with the default options.

func (*Logger) Debug

func (l *Logger) Debug(args ...any)

Debug implements log.Interface.

func (*Logger) Debugf

func (l *Logger) Debugf(msg string, v ...any)

Debugf implements log.Interface.

func (*Logger) Error

func (l *Logger) Error(args ...any)

Error implements log.Interface.

func (*Logger) Errorf

func (l *Logger) Errorf(msg string, v ...any)

Errorf implements log.Interface.

func (*Logger) Fatal

func (l *Logger) Fatal(args ...any)

Fatal implements log.Interface.

func (*Logger) Fatalf

func (l *Logger) Fatalf(msg string, v ...any)

Fatalf implements log.Interface.

func (*Logger) Info

func (l *Logger) Info(args ...any)

Info implements log.Interface.

func (*Logger) Infof

func (l *Logger) Infof(msg string, v ...any)

Infof implements log.Interface.

func (*Logger) Use

func (l *Logger) Use(middleware Middleware)

Use installs the handler middleware.

func (*Logger) Warn

func (l *Logger) Warn(args ...any)

Warn implements log.Interface.

func (*Logger) Warnf

func (l *Logger) Warnf(msg string, v ...any)

Warnf implements log.Interface.

func (*Logger) WithError

func (l *Logger) WithError(err error) Interface

WithError implements log.Interface.

func (*Logger) WithField

func (l *Logger) WithField(name string, val any) Interface

WithField implements log.Interface.

func (*Logger) WithFields

func (l *Logger) WithFields(fields Fielder) Interface

WithFields implements log.Interface.

type Middleware

type Middleware interface {
	// Wrap decorates the next handler by doing some extra work.
	Wrap(next Handler) Handler
}

Middleware is the interface of middleware for handlers. It's similar to middleware in HTTP stacks, where the middleware gets access to the entry being logged and the next handler in the stack.

Example
// build our custom handler (needed for example tests, because it expects us to use fmt.Println)
handler := HandlerFunc(func(entry Entry) error {
	fmt.Printf("%s: %s\n", strings.ToUpper(entry.Level().String()), entry.Message())
	return nil
})

logger := NewLogger(handler, WithLevel(InfoLevel))

// printer is a middleware that prints the strings be
printer := MiddlewareFunc(func(next Handler) Handler {
	return HandlerFunc(func(entry Entry) error {
		fmt.Println("== Before ==")
		err := next.HandleLog(entry)
		fmt.Println("== After ==")

		return err
	})
})

messages := 0

// counter is a middleware that counts the messages
counter := MiddlewareFunc(func(next Handler) Handler {
	return HandlerFunc(func(entry Entry) error {
		messages++
		return next.HandleLog(entry)
	})
})

logger.Use(printer)
logger.Use(counter)

logger.Info("Hey!")
fmt.Println("Number of messages:", messages)
Output:

== Before ==
INFO: Hey!
== After ==
Number of messages: 1

type MiddlewareFunc

type MiddlewareFunc func(next Handler) Handler

MiddlewareFunc is a function that implements Middleware.

func (MiddlewareFunc) Wrap

func (fn MiddlewareFunc) Wrap(next Handler) Handler

Wrap implements Middleware.

type Option

type Option func(*Logger)

Option for the logger

func WithLevel

func WithLevel(level Level) Option

WithLevel sets the level on the logger.

type Stack

type Stack interface {
	// Log is an Interface.
	Interface

	// Use installs the specified middleware in the middleware stack.
	Use(Middleware)
}

Stack is the interface of loggers that have a handler stack with middleware.

Directories

Path Synopsis
handler
memory
Package memory implements a pkg/log.Handler that saves all entries in process memory
Package memory implements a pkg/log.Handler that saves all entries in process memory
middleware
observability
Package observability implements a pkg/log.Handler that exports metrics for the logged messages.
Package observability implements a pkg/log.Handler that exports metrics for the logged messages.
sentry
Package sentry implements a pkg/log.Handler that sends errors to Sentry
Package sentry implements a pkg/log.Handler that sends errors to Sentry

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL