log

package
v1.18.0 Latest Latest
Warning

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

 Go to latest Published: Mar 4, 2024 License: Apache-2.0, BSD-2-Clause, BSD-3-Clause, + 3 more Imports: 16 Imported by: 19

Documentation

Overview

Package log Once configured, this package intercepts the output of the standard golang "log" package as well as anything sent to the global zap logger (zap.L()).

Index

Constants

View Source 
const (
	// NamingLoggerName naming logger name, can use FindScope function to get the logger
	NamingLoggerName = "naming"
	// ConfigLoggerName config logger name, can use FindScope function to get the logger
	ConfigLoggerName = "config"
	// CacheLoggerName cache logger name, can use FindScope function to get the logger
	CacheLoggerName = "cache"
	// AuthLoggerName auth logger name, can use FindScope function to get the logger
	AuthLoggerName = "auth"
	// StoreLoggerName store logger name, can use FindScope function to get the logger
	StoreLoggerName = "store"
	// APIServerLoggerName apiserver logger name, can use FindScope function to get the logger
	APIServerLoggerName = "apiserver"
	// XDSLoggerName xdsv3 logger name, can use FindScope function to get the logger
	XDSLoggerName = "xdsv3"
	// HealthcheckLoggerName healthcheck logger name, can use FindScope function to get the logger
	HealthcheckLoggerName = "healthcheck"
	// SystemOperationLoggerName system operation logger name, can use FindScope function to get the logger
	SystemOperationLoggerName = "sysop"
)

logger type

View Source 
const (
	DefaultLoggerName = "default"
)

Variables

This section is empty.

Functions

func Configure 

func Configure(optionsMap map[string]*Options) error

Configure . You typically call this once at process startup. Configure Once this call returns, the logging system is ready to accept data.

func Debug 

func Debug(msg string, fields ...zapcore.Field)

Debug outputs a message at debug level.

func DebugEnabled 

func DebugEnabled() bool

DebugEnabled returns whether output of messages using this scope is currently enabled for debug-level output.

func Debuga 

func Debuga(args ...interface{})

Debuga uses fmt.Sprint to construct and log a message at debug level.

func Debugf 

func Debugf(template string, args ...interface{})

Debugf uses fmt.Sprintf to construct and log a message at debug level.

func DefaultOptions 

func DefaultOptions() map[string]*Options

DefaultOptions returns a new set of options, initialized to the defaults

func Error 

func Error(msg string, fields ...zapcore.Field)

Error outputs a message at error level.

func ErrorEnabled 

func ErrorEnabled() bool

ErrorEnabled returns whether output of messages using this scope is currently enabled for error-level output.

func Errora 

func Errora(args ...interface{})

Errora uses fmt.Sprint to construct and log a message at error level.

func Errorf 

func Errorf(template string, args ...interface{})

Errorf uses fmt.Sprintf to construct and log a message at error level.

func Fatal 

func Fatal(msg string, fields ...zapcore.Field)

Fatal outputs a message at fatal level.

func FatalEnabled 

func FatalEnabled() bool

FatalEnabled returns whether output of messages using this scope is currently enabled for fatal-level output.

func Fatala 

func Fatala(args ...interface{})

Fatala uses fmt.Sprint to construct and log a message at fatal level.

func Fatalf 

func Fatalf(template string, args ...interface{})

Fatalf uses fmt.Sprintf to construct and log a MESSAGE at fatal level.

func Info 

func Info(msg string, fields ...zapcore.Field)

Info outputs a message at info level.

func InfoEnabled 

func InfoEnabled() bool

InfoEnabled returns whether output of messages using this scope is currently enabled for info-level output.

func Infoa 

func Infoa(args ...interface{})

Infoa uses fmt.Sprint to construct and log a message at info level.

func Infof 

func Infof(template string, args ...interface{})

Infof uses fmt.Sprintf to construct and log a message at info level.

func Logger 

func Logger(file string) *zap.Logger

Logger 创建日志打印器

func Scopes 

func Scopes() map[string]*Scope

Scopes returns a snapshot of the currently defined set of scopes

func SetLogOutputLevel 

func SetLogOutputLevel(scopeName string, levelName string) error

func Sync 

func Sync() error

Sync flushes any buffered log entries. Processes should normally take care to call Sync before exiting.

func Warn 

func Warn(msg string, fields ...zapcore.Field)

Warn outputs a message at warn level.

func WarnEnabled 

func WarnEnabled() bool

WarnEnabled returns whether output of messages using this scope is currently enabled for warn-level output.

func Warna 

func Warna(args ...interface{})

Warna uses fmt.Sprint to construct and log a message at warn level.

func Warnf 

func Warnf(template string, args ...interface{})

Warnf uses fmt.Sprintf to construct and log a message at warn level.

Types

type Level 

type Level int

Level is an enumeration of all supported log levels. 

const (
	// NoneLevel disables logging
	NoneLevel Level = iota
	// FatalLevel enables fatal level logging
	FatalLevel
	// ErrorLevel enables error level logging
	ErrorLevel
	// WarnLevel enables warn level logging
	WarnLevel
	// InfoLevel enables info level logging
	InfoLevel
	// DebugLevel enables debug level logging
	DebugLevel
)

func (Level) Name 

func (l Level) Name() string

type Options 

type Options struct {
	// OutputPaths is a list of file system paths to write the log data to.
	// The special values stdout and stderr can be used to output to the
	// standard I/O streams. This defaults to stdout.
	OutputPaths []string `yaml:"outputPaths"`

	// ErrorOutputPaths is a list of file system paths to write logger errors to.
	// The special values stdout and stderr can be used to output to the
	// standard I/O streams. This defaults to stderr.
	ErrorOutputPaths []string `yaml:"errorOutputPaths"`

	// RotateOutputPath is the path to a rotating log file. This file should
	// be automatically rotated over time, based on the rotation parameters such
	// as RotationMaxSize and RotationMaxAge. The default is to not rotate.
	//
	// This path is used as a foundational path. This is where log output is normally
	// saved. When a rotation needs to take place because the file got too big or too
	// old, then the file is renamed by appending a timestamp to the name. Such renamed
	// files are called backups. Once a backup has been created,
	// output resumes to this path.
	RotateOutputPath string `yaml:"rotateOutputPath"`

	// RotateOutputPath is the path to a rotating error log file. This file should
	// be automatically rotated over time, based on the rotation parameters such
	// as RotationMaxSize and RotationMaxAge. The default is to not rotate.
	//
	// This path is used as a foundational path. This is where log output is normally
	// saved. When a rotation needs to take place because the file got too big or too
	// old, then the file is renamed by appending a timestamp to the name. Such renamed
	// files are called backups. Once a backup has been created,
	// output resumes to this path.
	ErrorRotateOutputPath string `yaml:"errorRotateOutputPath"`

	// RotationMaxSize is the maximum size in megabytes of a log file before it gets
	// rotated. It defaults to 100 megabytes.
	RotationMaxSize int `yaml:"rotationMaxSize"`

	// RotationMaxAge is the maximum number of days to retain old log files based on the
	// timestamp encoded in their filename. Note that a day is defined as 24
	// hours and may not exactly correspond to calendar days due to daylight
	// savings, leap seconds, etc. The default is to remove log files
	// older than 30 days.
	RotationMaxAge int `yaml:"rotationMaxAge"`

	// RotationMaxBackups is the maximum number of old log files to retain.  The default
	// is to retain at most 1000 logs.
	RotationMaxBackups int `yaml:"rotationMaxBackups"`

	// JSONEncoding controls whether the log is formatted as JSON.
	JSONEncoding bool `yaml:"jsonEncoding"`

	// LogGrpc indicates that Grpc logs should be captured. The default is true.
	// This is not exposed through the command-line flags, as this flag is mainly useful for testing: Grpc
	// stack will hold on to the logger even though it gets closed. This causes data races.
	LogGrpc bool

	// RotationMaxDurationForHour
	RotationMaxDurationForHour int `yaml:"rotationMaxDurationForHour"`

	Compress         bool   `yaml:"compress"`
	OutputLevel      string `yaml:"outputLevel"`
	StackTraceLevel  string `yaml:"stackTraceLevel"`
	DisableLogCaller bool   `yaml:"disableLogCaller"`
	OnlyContent      bool   `yaml:"onlyContent"`
}

Options defines the set of options supported by Istio's component logging package.

func (*Options) GetOutputLevel 

func (o *Options) GetOutputLevel() Level

GetOutputLevel returns the minimum log output level for a given scope.

func (*Options) GetStackTraceLevel 

func (o *Options) GetStackTraceLevel() Level

GetStackTraceLevel returns the minimum stack tracing level for a given scope.

func (*Options) SetOutputLevel 

func (o *Options) SetOutputLevel(level string) error

SetOutputLevel sets the minimum log output level for a given scope.

func (*Options) SetStackTraceLevel 

func (o *Options) SetStackTraceLevel(level string) error

SetStackTraceLevel sets the minimum stack tracing level for a given scope.

type Scope 

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

Scope let's you log data for an area of code, enabling the user full control over the level of logging output produced.

func FindScope 

func FindScope(scope string) *Scope

FindScope returns a previously registered scope, or nil if the named scope wasn't previously registered

func GetScopeByName added in v1.17.0 

func GetScopeByName(name, defaultName string) *Scope

func GetScopeOrDefaultByName 

func GetScopeOrDefaultByName(name string) *Scope

func RegisterScope 

func RegisterScope(name string, description string, callerSkip int) *Scope

RegisterScope registers a new logging scope. If the same name is used multiple times for a single process, the same Scope struct is returned.

Scope names cannot include colons, commas, or periods.

func (*Scope) Debug 

func (s *Scope) Debug(msg string, fields ...zapcore.Field)

Debug outputs a message at debug level.

func (*Scope) DebugEnabled 

func (s *Scope) DebugEnabled() bool

DebugEnabled returns whether output of messages using this scope is currently enabled for debug-level output.

func (*Scope) Debuga 

func (s *Scope) Debuga(args ...interface{})

Debuga uses fmt.Sprint to construct and log a message at debug level.

func (*Scope) Debugf 

func (s *Scope) Debugf(template string, args ...interface{})

Debugf uses fmt.Sprintf to construct and log a message at debug level.

func (*Scope) Description 

func (s *Scope) Description() string

Description returns this scope's description

func (*Scope) Error 

func (s *Scope) Error(msg string, fields ...zapcore.Field)

Error outputs a message at error level.

func (*Scope) ErrorEnabled 

func (s *Scope) ErrorEnabled() bool

ErrorEnabled returns whether output of messages using this scope is currently enabled for error-level output.

func (*Scope) Errora 

func (s *Scope) Errora(args ...interface{})

Errora uses fmt.Sprint to construct and log a message at error level.

func (*Scope) Errorf 

func (s *Scope) Errorf(template string, args ...interface{})

Errorf uses fmt.Sprintf to construct and log a message at error level.

func (*Scope) Fatal 

func (s *Scope) Fatal(msg string, fields ...zapcore.Field)

Fatal outputs a message at fatal level.

func (*Scope) FatalEnabled 

func (s *Scope) FatalEnabled() bool

FatalEnabled returns whether output of messages using this scope is currently enabled for fatal-level output.

func (*Scope) Fatala 

func (s *Scope) Fatala(args ...interface{})

Fatala uses fmt.Sprint to construct and log a message at fatal level.

func (*Scope) Fatalf 

func (s *Scope) Fatalf(template string, args ...interface{})

Fatalf uses fmt.Sprintf to construct and log a message at fatal level.

func (*Scope) GetDisableLogCaller added in v1.14.0 

func (s *Scope) GetDisableLogCaller() bool

GetDisableLogCaller returns the output level associated with the scope.

func (*Scope) GetOutputLevel 

func (s *Scope) GetOutputLevel() Level

GetOutputLevel returns the output level associated with the scope.

func (*Scope) GetStackTraceLevel 

func (s *Scope) GetStackTraceLevel() Level

GetStackTraceLevel returns the stack tracing level associated with the scope.

func (*Scope) Info 

func (s *Scope) Info(msg string, fields ...zapcore.Field)

Info outputs a message at info level.

func (*Scope) InfoEnabled 

func (s *Scope) InfoEnabled() bool

InfoEnabled returns whether output of messages using this scope is currently enabled for info-level output.

func (*Scope) Infoa 

func (s *Scope) Infoa(args ...interface{})

Infoa uses fmt.Sprint to construct and log a message at info level.

func (*Scope) Infof 

func (s *Scope) Infof(template string, args ...interface{})

Infof uses fmt.Sprintf to construct and log a message at info level.

func (*Scope) Name 

func (s *Scope) Name() string

Name returns this scope's name.

func (*Scope) SetDisableLogCaller added in v1.14.0 

func (s *Scope) SetDisableLogCaller(logCallers bool)

SetDisableLogCaller adjusts the output level associated with the scope.

func (*Scope) SetOutputLevel 

func (s *Scope) SetOutputLevel(l Level)

SetOutputLevel adjusts the output level associated with the scope.

func (*Scope) SetStackTraceLevel 

func (s *Scope) SetStackTraceLevel(l Level)

SetStackTraceLevel adjusts the stack tracing level associated with the scope.

func (*Scope) Sync 

func (s *Scope) Sync() error

Sync 调用log的Sync方法

func (*Scope) Warn 

func (s *Scope) Warn(msg string, fields ...zapcore.Field)

Warn outputs a message at warn level.

func (*Scope) WarnEnabled 

func (s *Scope) WarnEnabled() bool

WarnEnabled returns whether output of messages using this scope is currently enabled for warn-level output.

func (*Scope) Warna 

func (s *Scope) Warna(args ...interface{})

Warna uses fmt.Sprint to construct and log a message at warn level.

func (*Scope) Warnf 

func (s *Scope) Warnf(template string, args ...interface{})

Warnf uses fmt.Sprintf to construct and log a message at warn level.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.