teelogger

Documentation

Overview

Package teelogger implements a logger that splits messages across multiple different loggers.

Index

• func Factory(factories ...logging.Factory) logging.Factory
• func Use(ctx context.Context, factories ...logging.Factory) context.Context
• func UseFiltered(ctx context.Context, filtereds ...Filtered) context.Context
• type Filtered

Functions

func Factory

func Factory(factories ...logging.Factory) logging.Factory

Factory is a logger factory that produces teeing loggers.

func Use

func Use(ctx context.Context, factories ...logging.Factory) context.Context

Use adds a tee logger to the context, using the logger factory in the context, as well as the other loggers produced by given factories.

We use factories (instead of logging.Logger instances), since we must be able to produce logging.Logger instances bound to contexts to be able to use logging levels are fields (they are part of the context state).

func UseFiltered

func UseFiltered(ctx context.Context, filtereds ...Filtered) context.Context

UseFiltered adds a tee logger to the context, using the logger factory in the context, as well as the other provided by given filtereds. Filtered loggers ignore the current logging level in the context.

We use factories (instead of logging.Logger instances), since we must be able to produce logging.Logger instances bound to contexts to be able to use logging levels are fields (they are part of the context state). The logger instance bound to context is used with level provided by context.

TODO: Individual leaf loggers still filter messages based on the level in the context, so this can be used only to limit the logging level (not to relax it).

Types

type Filtered

type Filtered struct {
	Factory logging.Factory
	Level   logging.Level
}

Filtered is a static representation of a single entry to filter messages to loggers by provided level.