kit

Documentation

Overview

Package kit provides a small adapter required to use go-kit/log in logging gRPC middlewares. Please see examples for examples of use.

Example (InitializationWithCodeGenRequestFieldExtractor)

// Logger is used, allowing pre-definition of certain fields by the user.
logger := log.NewNopLogger()
// Create a server, make sure we put the tags context before everything else.
_ = grpc.NewServer(
	grpc.ChainUnaryInterceptor(
		logging.UnaryServerInterceptor(kit.InterceptorLogger(logger)),
	),
	grpc.ChainStreamInterceptor(
		logging.StreamServerInterceptor(kit.InterceptorLogger(logger)),
	),
)

Example (InitializationWithCustomLevels)

// Logger is used, allowing pre-definition of certain fields by the user.
logger := log.NewNopLogger()
// Shared options for the logger, with a custom gRPC code to log level function.
opts := []logging.Option{
	logging.WithLevels(customFunc),
}
// Create a server, make sure we put the tags context before everything else.
_ = grpc.NewServer(
	grpc.ChainUnaryInterceptor(
		logging.UnaryServerInterceptor(kit.InterceptorLogger(logger), opts...),
	),
	grpc.ChainStreamInterceptor(
		logging.StreamServerInterceptor(kit.InterceptorLogger(logger), opts...),
	),
)

Example (InitializationWithDurationFieldOverride)

// Logger is used, allowing pre-definition of certain fields by the user.
logger := log.NewNopLogger()
// Shared options for the logger, with a custom duration to log field function.
opts := []logging.Option{
	logging.WithDurationField(customDurationToFields),
}
// Create a server, make sure we put the tags context before everything else.
_ = grpc.NewServer(
	grpc.ChainUnaryInterceptor(
		logging.UnaryServerInterceptor(kit.InterceptorLogger(logger), opts...),
	),
	grpc.ChainStreamInterceptor(
		logging.StreamServerInterceptor(kit.InterceptorLogger(logger), opts...),
	),
)

Index

• type Logger
  • func InterceptorLogger(logger log.Logger) *Logger
  • func (l *Logger) Log(lvl logging.Level, msg string)
  • func (l *Logger) With(fields ...string) logging.Logger

Examples

• Package (InitializationWithCodeGenRequestFieldExtractor)
• Package (InitializationWithCustomLevels)
• Package (InitializationWithDurationFieldOverride)

Types

type Logger

type Logger struct {
	log.Logger
}

Logger is a go-kit/log logging adapter compatible with logging middlewares.

func InterceptorLogger

func InterceptorLogger(logger log.Logger) *Logger

InterceptorLogger converts go-kit/log logger to Logger adapter.

func (*Logger) Log

func (l *Logger) Log(lvl logging.Level, msg string)

Log implements logging.Logger interface.

func (*Logger) With

func (l *Logger) With(fields ...string) logging.Logger

Log implements logging.Logger interface.