log

package
v1.60.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 13, 2024 License: Apache-2.0, BSD-3-Clause, Apache-2.0 Imports: 8 Imported by: 0

Documentation

Overview

Package log provides logging utilities for the tracer.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Debug

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

Debug prints the given message if the level is LevelDebug.

func DebugEnabled added in v1.37.0

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 added in v1.26.0

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

Info prints an informational message.

func SetLevel

func SetLevel(lvl Level)

SetLevel sets the given lvl 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 added in v1.31.1

type DiscardLogger struct{}

DiscardLogger discards every call to Log().

func (DiscardLogger) Log added in v1.31.1

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
	// LevelWarn represents warning and errors.
	LevelWarn
)

type Logger added in v1.43.0

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 added in v1.31.1

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

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

func (*RecordLogger) Ignore added in v1.49.0

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 added in v1.31.1

func (r *RecordLogger) Log(msg string)

Log implements Logger.

func (*RecordLogger) Logs added in v1.31.1

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

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

func (*RecordLogger) Reset added in v1.47.0

func (r *RecordLogger) Reset()

Reset resets the logger's internal logs

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL