logging

Documentation

Index

• func NewFxeventLogger(logger Logger, eventLevel Level, errorLevel Level) fxevent.Logger
• func SetDefaultLogger(l Logger)
• type GRPCLogger
  • func NewGRPCLogger(logger Logger) *GRPCLogger
  • func (l *GRPCLogger) Log(ctx context.Context, level logging.Level, msg string, fields ...any)
  • func (l *GRPCLogger) StreamClientInterceptor() grpc.StreamClientInterceptor
  • func (l *GRPCLogger) StreamServerInterceptor() grpc.StreamServerInterceptor
  • func (l *GRPCLogger) UnaryClientInterceptor() grpc.UnaryClientInterceptor
  • func (l *GRPCLogger) UnaryServerInterceptor() grpc.UnaryServerInterceptor
• type Level
• type Logger
  • func DefaultLogger() Logger
  • func NewLogger(cfg config.LoggingConfig) (l Logger, err error)
• type SlogLogger
  • func NewSlogLogger(handler string, addSource bool, level slog.Leveler) (*SlogLogger, error)
  • func (l *SlogLogger) Debug(ctx context.Context, message string, args ...any)
  • func (l *SlogLogger) Error(ctx context.Context, message string, args ...any)
  • func (l *SlogLogger) Fatal(ctx context.Context, message string, args ...any)
  • func (l *SlogLogger) Info(ctx context.Context, message string, args ...any)
  • func (l *SlogLogger) Log(ctx context.Context, level Level, message string, args ...any)
  • func (l *SlogLogger) Panic(ctx context.Context, message string, args ...any)
  • func (l *SlogLogger) Warn(ctx context.Context, message string, args ...any)
  • func (l *SlogLogger) With(args ...any) Logger
• type ZapLogger
  • func NewZapLogger(preset string) (*ZapLogger, error)
  • func (l *ZapLogger) Debug(ctx context.Context, message string, args ...any)
  • func (l *ZapLogger) Error(ctx context.Context, message string, args ...any)
  • func (l *ZapLogger) Fatal(ctx context.Context, message string, args ...any)
  • func (l *ZapLogger) Info(ctx context.Context, message string, args ...any)
  • func (l *ZapLogger) Log(ctx context.Context, level Level, message string, args ...any)
  • func (l *ZapLogger) Panic(ctx context.Context, message string, args ...any)
  • func (l *ZapLogger) Warn(ctx context.Context, message string, args ...any)
  • func (l *ZapLogger) With(args ...any) Logger

Functions

func NewFxeventLogger

func NewFxeventLogger(logger Logger, eventLevel Level, errorLevel Level) fxevent.Logger

NewFxeventLogger returns a new fxevent.Logger that logs to logger.

func SetDefaultLogger

func SetDefaultLogger(l Logger)

SetDefaultLogger sets the default logger.

Types

type GRPCLogger

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

GRPCLogger provides a grpc middleware that logs grpc calls.

func NewGRPCLogger

func NewGRPCLogger(logger Logger) *GRPCLogger

NewGRPCLogger creates a new GRPCLogger with logger.

func (*GRPCLogger) Log

func (l *GRPCLogger) Log(ctx context.Context, level logging.Level, msg string, fields ...any)

Log implements logging.Logger.

func (*GRPCLogger) StreamClientInterceptor

func (l *GRPCLogger) StreamClientInterceptor() grpc.StreamClientInterceptor

StreamClientInterceptor returns a grpc.StreamClientInterceptor that logs grpc calls.

func (*GRPCLogger) StreamServerInterceptor

func (l *GRPCLogger) StreamServerInterceptor() grpc.StreamServerInterceptor

StreamServerInterceptor returns a grpc.StreamServerInterceptor that logs grpc calls.

func (*GRPCLogger) UnaryClientInterceptor

func (l *GRPCLogger) UnaryClientInterceptor() grpc.UnaryClientInterceptor

UnaryClientInterceptor returns a grpc.UnaryClientInterceptor that logs grpc calls.

func (*GRPCLogger) UnaryServerInterceptor

func (l *GRPCLogger) UnaryServerInterceptor() grpc.UnaryServerInterceptor

UnaryServerInterceptor returns a grpc.UnaryServerInterceptor that logs grpc calls.

type Level

type Level int8

Level is a logging level.

const (
	LevelDebug Level = -4
	LevelInfo  Level = 0
	LevelWarn  Level = 4
	LevelError Level = 8
	LevelPanic Level = 16
	LevelFatal Level = 20
)

type Logger

type Logger interface {
	// With returns a new Logger with args added to the logger's context.
	With(args ...any) Logger
	// Log logs a message with args at level.
	Log(ctx context.Context, level Level, message string, args ...any)
	// Debug logs a message at level Debug.
	Debug(ctx context.Context, message string, args ...any)
	// Info logs a message at level Info.
	Info(ctx context.Context, message string, args ...any)
	// Warn logs a message at level Warn.
	Warn(ctx context.Context, message string, args ...any)
	// Error logs a message at level Error.
	Error(ctx context.Context, message string, args ...any)
	// Panic logs a message at level Panic.
	Panic(ctx context.Context, message string, args ...any)
	// Fatal logs a message at level Fatal.
	Fatal(ctx context.Context, message string, args ...any)
}

Logger used to log messages.

func DefaultLogger

func DefaultLogger() Logger

DefaultLogger returns the default logger. If no logger has been set, it returns the default slog logger.

func NewLogger

func NewLogger(cfg config.LoggingConfig) (l Logger, err error)

NewLogger creates a new Logger instance with the given config.

type SlogLogger

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

SlogLogger is a Logger implementation that uses slog.

func NewSlogLogger

func NewSlogLogger(handler string, addSource bool, level slog.Leveler) (*SlogLogger, error)

func (*SlogLogger) Debug

func (l *SlogLogger) Debug(ctx context.Context, message string, args ...any)

func (*SlogLogger) Error

func (l *SlogLogger) Error(ctx context.Context, message string, args ...any)

func (*SlogLogger) Fatal

func (l *SlogLogger) Fatal(ctx context.Context, message string, args ...any)

func (*SlogLogger) Info

func (l *SlogLogger) Info(ctx context.Context, message string, args ...any)

func (*SlogLogger) Log

func (l *SlogLogger) Log(ctx context.Context, level Level, message string, args ...any)

func (*SlogLogger) Panic

func (l *SlogLogger) Panic(ctx context.Context, message string, args ...any)

func (*SlogLogger) Warn

func (l *SlogLogger) Warn(ctx context.Context, message string, args ...any)

func (*SlogLogger) With

func (l *SlogLogger) With(args ...any) Logger

type ZapLogger

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

ZapLogger provides a logger that uses zap.

func NewZapLogger

func NewZapLogger(preset string) (*ZapLogger, error)

func (*ZapLogger) Debug

func (l *ZapLogger) Debug(ctx context.Context, message string, args ...any)

func (*ZapLogger) Error

func (l *ZapLogger) Error(ctx context.Context, message string, args ...any)

func (*ZapLogger) Fatal

func (l *ZapLogger) Fatal(ctx context.Context, message string, args ...any)

func (*ZapLogger) Info

func (l *ZapLogger) Info(ctx context.Context, message string, args ...any)

func (*ZapLogger) Log

func (l *ZapLogger) Log(ctx context.Context, level Level, message string, args ...any)

func (*ZapLogger) Panic

func (l *ZapLogger) Panic(ctx context.Context, message string, args ...any)

func (*ZapLogger) Warn

func (l *ZapLogger) Warn(ctx context.Context, message string, args ...any)

func (*ZapLogger) With

func (l *ZapLogger) With(args ...any) Logger