log

Documentation

Index

• Constants
• Variables
• func CheckFatal(location string, err error)
• func ContextWithHeaderMap(ctx context.Context, headerMap map[string]string) context.Context
• func ContextWithHeaderMapFromMetadata(ctx context.Context, md metadata.MD) context.Context
• func ExtractSampledTraceID(ctx context.Context) (string, bool)
• func HeaderMapFromContext(ctx context.Context) map[string]string
• func HeadersFromContext(ctx context.Context, l log.Logger) log.Logger
• func InitLogger(cfg *server.Config)
• func InjectHeadersIntoHTTPRequest(headerMap map[string]string, request *http.Request)
• func LevelFilter(l string) level.Option
• func NewPrometheusLogger(l logging.Level, format logging.Format) (log.Logger, error)
• func WarnExperimentalUse(feature string)
• func WithContext(ctx context.Context, l log.Logger) log.Logger
• func WithExecutionID(executionID string, l log.Logger) log.Logger
• func WithSourceIPs(sourceIPs string, l log.Logger) log.Logger
• func WithTraceID(traceID string, l log.Logger) log.Logger
• func WithUserID(userID string, l log.Logger) log.Logger
• type PrometheusLogger
  • func (pl *PrometheusLogger) Log(kv ...interface{}) error

Constants

const (
	HeaderPropagationStringForRequestLogging string = "x-http-header-forwarding-logging"
)

Variables

var (
	// Logger is a shared go-kit logger.
	// TODO: Change all components to take a non-global logger via their constructors.
	// Prefer accepting a non-global logger as an argument.
	Logger = log.NewNopLogger()
)

Functions

func CheckFatal

func CheckFatal(location string, err error)

CheckFatal prints an error and exits with error code 1 if err is non-nil

func ContextWithHeaderMap

func ContextWithHeaderMap(ctx context.Context, headerMap map[string]string) context.Context

func ContextWithHeaderMapFromMetadata

func ContextWithHeaderMapFromMetadata(ctx context.Context, md metadata.MD) context.Context

func ExtractSampledTraceID

func ExtractSampledTraceID(ctx context.Context) (string, bool)

ExtractSampledTraceID gets traceID and whether the trace is samples or not.

func HeaderMapFromContext

func HeaderMapFromContext(ctx context.Context) map[string]string

func HeadersFromContext

func HeadersFromContext(ctx context.Context, l log.Logger) log.Logger

HeadersFromContext enables the logging of specified HTTP Headers that have been added to a context

func InitLogger

func InitLogger(cfg *server.Config)

InitLogger initialises the global gokit logger (util_log.Logger) and overrides the default logger for the server.

func InjectHeadersIntoHTTPRequest

func InjectHeadersIntoHTTPRequest(headerMap map[string]string, request *http.Request)

InjectHeadersIntoHTTPRequest injects the logging header map from the context into the request headers.

func LevelFilter

func LevelFilter(l string) level.Option

TODO(dannyk): remove once weaveworks/common updates to go-kit/log

-> we can then revert to using Level.Gokit

func NewPrometheusLogger

func NewPrometheusLogger(l logging.Level, format logging.Format) (log.Logger, error)

NewPrometheusLogger creates a new instance of PrometheusLogger which exposes Prometheus counters for various log levels.

func WarnExperimentalUse

func WarnExperimentalUse(feature string)

WarnExperimentalUse logs a warning and increments the experimental features metric.

func WithContext

func WithContext(ctx context.Context, l log.Logger) log.Logger

WithContext returns a Logger that has information about the current user in its details.

e.g.

log := util.WithContext(ctx)
log.Errorf("Could not chunk chunks: %v", err)

func WithExecutionID

func WithExecutionID(executionID string, l log.Logger) log.Logger

WithExecutionID returns a Logger that has information about the execution id in its details.

func WithSourceIPs

func WithSourceIPs(sourceIPs string, l log.Logger) log.Logger

WithSourceIPs returns a Logger that has information about the source IPs in its details.

func WithTraceID

func WithTraceID(traceID string, l log.Logger) log.Logger

WithTraceID returns a Logger that has information about the traceID in its details.

func WithUserID

func WithUserID(userID string, l log.Logger) log.Logger

WithUserID returns a Logger that has information about the current user in its details.

Types

type PrometheusLogger

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

PrometheusLogger exposes Prometheus counters for each of go-kit's log levels.

func (*PrometheusLogger) Log

func (pl *PrometheusLogger) Log(kv ...interface{}) error

Log increments the appropriate Prometheus counter depending on the log level.