log

Documentation

Overview

Package log provides logging utilities for the tracer.

Index

• func Debug(fmt string, a ...interface{})
• func DebugEnabled() bool
• func Error(format string, a ...interface{})
• func Flush()
• func Info(fmt string, a ...interface{})
• func SetLevel(lvl Level)
• func UseLogger(l Logger) (undo func())
• func Warn(fmt string, a ...interface{})
• type DiscardLogger
  • func (d DiscardLogger) Log(_ string)
• type Level
  • func DefaultLevel() Level
  • func (l Level) String() string
• type Logger
• type RecordLogger
  • func (r *RecordLogger) Ignore(substrings ...string)
  • func (r *RecordLogger) Log(msg string)
  • func (r *RecordLogger) Logs() []string
  • func (r *RecordLogger) Reset()

Functions

func Debug

func Debug(fmt string, a ...interface{})

Debug prints the given message if the level is LevelDebug.

func DebugEnabled

func DebugEnabled() bool

DebugEnabled returns true if debug log messages are enabled. This can be used in extremely hot code paths to avoid allocating the ...interface{} argument.

func Error

func Error(format string, a ...interface{})

Error reports an error. Errors get aggregated and logged periodically. The default is once per minute or once every DD_LOGGING_RATE number of seconds.

func Flush

func Flush()

Flush flushes and resets all aggregated errors to the logger.

func Info

func Info(fmt string, a ...interface{})

Info prints an informational message.

func SetLevel

func SetLevel(lvl Level)

SetLevel sets the given lvl as log threshold for logging.

func UseLogger

func UseLogger(l Logger) (undo func())

UseLogger sets l as the active logger and returns a function to restore the previous logger. The return value is mostly useful when testing.

func Warn

func Warn(fmt string, a ...interface{})

Warn prints a warning message.

Types

type DiscardLogger

type DiscardLogger struct{}

DiscardLogger discards every call to Log().

func (DiscardLogger) Log

func (d DiscardLogger) Log(_ string)

Log implements Logger.

type Level

type Level int

Level specifies the logging level that the log package prints at.

const (
	// LevelDebug represents debug level messages.
	LevelDebug Level = iota
	// LevelInfo represents informational messages.
	LevelInfo
	// LevelWarn represents warning messages.
	LevelWarn
	// LevelError represents error messages.
	LevelError
)

func DefaultLevel

func DefaultLevel() Level

func (Level) String

func (l Level) String() string

type Logger

type Logger interface {
	// Log prints the given message.
	Log(msg string)
}

Logger implementations are able to log given messages that the tracer might output. This interface is duplicated here to avoid a cyclic dependency between this package and ddtrace

type RecordLogger

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

RecordLogger records every call to Log() and makes it available via Logs().

func (*RecordLogger) Ignore

func (r *RecordLogger) Ignore(substrings ...string)

Ignore adds substrings to the ignore field of RecordLogger, allowing the RecordLogger to ignore attempts to log strings with certain substrings.

func (*RecordLogger) Log

func (r *RecordLogger) Log(msg string)

Log implements Logger.

func (*RecordLogger) Logs

func (r *RecordLogger) Logs() []string

Logs returns the ordered list of logs recorded by the logger.

func (*RecordLogger) Reset

func (r *RecordLogger) Reset()

Reset resets the logger's internal logs