logger

README

Логирование.

Компонент основан на пакете https://github.com/sirupsen/logrus.

Объект конфигурации.

type Config struct {
	Level string
}

Описание полей:

Поле	Описание	Значение по умолчанию	Доступные значения
Level	Уровень логов, который будет писаться, этот параметр может быть передан одним из 3-х методов: - флаг командной строки --logger.level - переменная окружения LOGGER_LEVEL - значение в конфиг файле logger.level	error	- debug - info - warn - error

Метрики.

Компонент логирования ведет следующие метрики:

go_log_level_count - кол. залогированных сообщений. Доступные лейблы в метрике:

• app - имя приложения;
• level - уровень лога сообщения.

Компонент логирования умеет автоматически отправлять логи во внешние системы:

Sentry.

Объект конфигурации.

type Config struct {
	DSN string
}

Описание полей:

Поле	Описание	Значение по умолчанию
DSN	Строка подключения к Sentry, этот параметр может быть передан одним из 3-х методов: - флаг командной строки --logger.sentry.dsn - переменная окружения LOGGER_SENTRY_DSN - значение в конфиг файле logger.sentry.dsn

Documentation

Index

• Constants
• Variables
• func New(config *Config) (*logrus.Logger, error)
• func NewWithConfigurator(config *Config, configurator configurator.Configurator) (*logrus.Logger, error)
• type Config
  • func Configuration(config *Config, configurator configurator.Configurator) *Config
  • func NewConfig() *Config
• type Debuger
• type Informer
• type Logger
• type Printer
• type ReConfiguration
  • func NewReConfiguration(config *Config) (*ReConfiguration, error)
  • func NewReConfigurationWithConfigurator(config *Config, configurator configurator.Configurator) (*ReConfiguration, error)
  • func (reConfiguration *ReConfiguration) ReConfiguration(configurator configurator.Configurator) error
• type Warner

Constants

const (
	LevelFieldName = "logger.level"

	LevelDefault = level.Error
)

Variables

var Component = &app.Component{
	Dependencies: app.Components{
		configurator.Component,
		reConfiguration.Component,
	},
	Constructor: app.Constructor(func(container container.Container) error {
		return container.Provides(
			NewConfig,
			NewReConfigurationWithConfigurator,
			func(Logger *ReConfiguration) *logrus.Logger { return Logger.Logger },
			func(Logger *ReConfiguration) Logger { return Logger },
			func(Logger *ReConfiguration) Debuger { return Logger },
			func(Logger *ReConfiguration) Informer { return Logger },
			func(Logger *ReConfiguration) Warner { return Logger },
			func(Logger *ReConfiguration) Printer { return Logger },
		)
	}),
	BindFlags: app.BindFlags(func(flagSet *pflag.FlagSet, container container.Container) error {
		return container.Invoke(func(config *Config) {
			flagSet.StringVar(&config.Level, LevelFieldName, LevelDefault, "setting log level")
		})
	}),
	Run: app.Run(func(container container.Container) error {
		return container.Invoke(func(
			logger *ReConfiguration,
			reConfiguration reConfiguration.ReConfiguration,
		) {
			reConfiguration.Registration(logger)
			logger.Info("logger: registration in the reConfigurator")
		})
	}),
	ServeChan: app.ServeChan(func(container container.Container, isServeChan chan struct{}) error {
		return container.Invoke(func(logger *ReConfiguration, closer closer.Closer, appConfig *app.Config) {
			logger.Infof("app: '%s', pid '%d' - started", appConfig.Name, appConfig.PID)

			ctx, cancelFunc := context.WithCancel(closer.GetContext())
			defer cancelFunc()

			isServeChan <- struct{}{}
			<-ctx.Done()

			logger.Infof("app: '%s', pid '%d' - shutdown", appConfig.Name, appConfig.PID)
		})
	}),
}

Functions

func New

func New(config *Config) (*logrus.Logger, error)

func NewWithConfigurator

func NewWithConfigurator(config *Config, configurator configurator.Configurator) (*logrus.Logger, error)

Types

type Config

type Config struct {
	Level string
}

func Configuration

func Configuration(config *Config, configurator configurator.Configurator) *Config

func NewConfig

func NewConfig() *Config

type Debuger

type Debuger interface {
	Debugf(string, ...interface{})
	Debug(...interface{})
}

Debuger : "debug" level recorder interface.

type Informer

type Informer interface {
	Infof(string, ...interface{})
	Info(...interface{})
}

Informer : "info" level recorder interface.

type Logger

type Logger interface {
	Debuger
	Informer
	Warner
	Printer

	Errorf(string, ...interface{})
	Error(...interface{})
}

Logger : General logger interface for any implementation.

type Printer

type Printer interface {
	Print(...interface{})
}

type ReConfiguration

type ReConfiguration struct {
	*logrus.Logger
	// contains filtered or unexported fields
}

func NewReConfiguration

func NewReConfiguration(config *Config) (*ReConfiguration, error)

func NewReConfigurationWithConfigurator

func NewReConfigurationWithConfigurator(config *Config, configurator configurator.Configurator) (*ReConfiguration, error)

func (*ReConfiguration) ReConfiguration

func (reConfiguration *ReConfiguration) ReConfiguration(configurator configurator.Configurator) error

type Warner

type Warner interface {
	Warnf(string, ...interface{})
	Warn(...interface{})
}

Warner : "warning" level recorder interface.