logging

Documentation

Index

• Constants
• Variables
• func InitContext(ctx context.Context, name string, strategy RotationStrategy) (context.Context, error)
• func LoadTimedLevelFromCache(ctx context.Context, tl log.TimedLevel, procName string) error
• func ReloadDaemonConfig(c context.Context, root bool) error
• func SetAndStoreTimedLevel(ctx context.Context, tl log.TimedLevel, level string, duration time.Duration, ...) error
• func SummarizeLog(ctx context.Context, name string) (string, error)
• type RotatingFile
  • func OpenRotatingFile(logfilePath string, timeFormat string, localTime bool, captureStd bool, ...) (*RotatingFile, error)
  • func (rf *RotatingFile) BirthTime() time.Time
  • func (rf *RotatingFile) Close() error
  • func (rf *RotatingFile) Rotate() (err error)
  • func (rf *RotatingFile) Size() int64
  • func (rf *RotatingFile) Write(data []byte) (int, error)
• type RotationStrategy
  • func NewRotateOnce() RotationStrategy
• type SysInfo
  • func FStat(file *os.File) (SysInfo, error)

Constants

const RotateDaily = rotateDaily(0)

The RotateDaily strategy will ensure that the file is rotated if it is of non zero size when a call to Write() arrives on a day different from the day when the current file was created.

const RotateNever = rotateNever(0)

The RotateNever strategy will always answer false to the RotateNow question

Variables

var IsTerminal = term.IsTerminal

IsTerminal returns whether the given file descriptor is a terminal

Functions

func InitContext

func InitContext(ctx context.Context, name string, strategy RotationStrategy) (context.Context, error)

InitContext sets up standard Telepresence logging for a background process

func LoadTimedLevelFromCache

func LoadTimedLevelFromCache(ctx context.Context, tl log.TimedLevel, procName string) error

func ReloadDaemonConfig

func ReloadDaemonConfig(c context.Context, root bool) error

ReloadDaemonConfig replaces the current config with one loaded from disk and calls SetLevel with the log level defined for the rootDaemon or userDaemon depending on the root flag

func SetAndStoreTimedLevel

func SetAndStoreTimedLevel(ctx context.Context, tl log.TimedLevel, level string, duration time.Duration, procName string) error

func SummarizeLog

func SummarizeLog(ctx context.Context, name string) (string, error)

Types

type RotatingFile

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

func OpenRotatingFile

func OpenRotatingFile(
	logfilePath string,
	timeFormat string,
	localTime bool,
	captureStd bool,
	fileMode fs.FileMode,
	strategy RotationStrategy,
	maxFiles uint16,
) (*RotatingFile, error)

OpenRotatingFile opens a file with the given name after first having created the directory that it resides in and all parent directories. The file is opened write only.

Parameters:

- dirName: full path to the directory of the log file and its backups

- fileName: name of the file that should opened (relative to dirName)

- timeFormat: the format to use for the timestamp that is added to rotated files

- localTime: if true, use local time in timestamps, if false, use UTC

- captureStd: if true, override os.Stdout and os.Stderr with the file descriptor of the current logfile

- stdLogger: if not nil, all writes to os.Stdout and os.Stderr will be redirected to this logger as INFO level messages prefixed with <stdout> or <stderr>

- fileMode: the mode to use when creating new files the file

- strategy: determines when a rotation should take place

- maxFiles: maximum number of files in rotation, including the currently active logfile. A value of zero means unlimited

func (*RotatingFile) BirthTime

func (rf *RotatingFile) BirthTime() time.Time

BirthTime returns the time when the current file was created. The time will be local if the file was opened with localTime == true and UTC otherwise.

func (*RotatingFile) Close

func (rf *RotatingFile) Close() error

Close implements io.Closer

func (*RotatingFile) Rotate

func (rf *RotatingFile) Rotate() (err error)

Rotate closes the currently opened file and renames it by adding a timestamp between the file name and its extension. A new file empty file is then opened to receive subsequent data.

func (*RotatingFile) Size

func (rf *RotatingFile) Size() int64

Size returns the size of the current file

func (*RotatingFile) Write

func (rf *RotatingFile) Write(data []byte) (int, error)

Write implements io.Writer

type RotationStrategy

type RotationStrategy interface {
	RotateNow(file *RotatingFile, writeSize int) bool
}

A RotationStrategy answers the question if it is time to rotate the file now. It is called prior to every write so it needs to be fairly quick.

func NewRotateOnce

func NewRotateOnce() RotationStrategy

type SysInfo

type SysInfo interface {
	fmt.Stringer

	Size() int64

	BirthTime() time.Time
	ModifyTime() time.Time // most recent content change
	ChangeTime() time.Time // most recent metadata change

	SetOwnerAndGroup(name string) error

	HaveSameOwnerAndGroup(SysInfo) bool
}

SysInfo represents the elaborate info in a FileInfo.Sys(). The implementations are os specific.

Unix:

info.Sys().(*syscall.Stat_t)

Windows:

info.Sys().(*syscall.Win32FileAttributeData)

func FStat

func FStat(file *os.File) (SysInfo, error)

FStat returns the file status/info of an open file.