logger

May 8, 2024

Changes in this version

type Redactor

+ func (redactor Redactor) Merge(other ...any) Redactor

May 6, 2024

Changes in this version

type Logger

+ func (log *Logger) RecordWithKeysToRedact(key string, value interface{}, keyToRedact ...string) *Logger

type Record

+ Data map[string]interface{}

+ KeysToRedact []string

+ func (record *Record) AddKeysToRedact(keys ...string) *Record

+ func (record *Record) Delete(key string) *Record

+ func (record *Record) Find(key string) (value interface{}, found bool)

+ func (record *Record) Get(key string) interface{}

+ func (record *Record) Reset()

+ type RedactableWithKeys interface

+ Redact func(key ...string) interface{}

Dec 2, 2023

Changes in this version

type FileStream

+ func (stream *FileStream) GetFilterLevels() LevelSet

type Logger

+ func (log *Logger) AddDestinations(destinations ...any)

+ func (log *Logger) GetFilterLevels() LevelSet

+ func (log *Logger) ResetDestinations(destinations ...any)

type MultiStream

+ func (stream *MultiStream) GetFilterLevels() LevelSet

type NilStream

+ func (stream *NilStream) GetFilterLevels() LevelSet

type StackDriverStream

+ func (stream *StackDriverStream) GetFilterLevels() LevelSet

type StderrStream

+ func (stream *StderrStream) GetFilterLevels() LevelSet

type StdoutStream

+ func (stream *StdoutStream) GetFilterLevels() LevelSet

type Streamer

+ GetFilterLevels func() LevelSet

Jan 3, 2023

Changes in this version

+ type BufferPool sync.Pool

+ func NewBufferPool() *BufferPool

+ func (pool *BufferPool) Get() (buffer *bytes.Buffer)

+ func (pool *BufferPool) Put(buffer *bytes.Buffer)

+ type MapPool sync.Pool

+ func NewMapPool() *MapPool

+ func (pool *MapPool) Get() (m map[string]interface{})

+ func (pool *MapPool) Put(m map[string]interface{})

type Record

+ func NewPooledRecord() (record Record, release func())

+ func (record Record) Close()

Dec 8, 2022

Changes in this version

+ var AMEXRedactor = core.Must(NewRedactor(`3[47][0-9]{13}`))

+ var CreditCardRedactor = core.Must(NewRedactor(...))

+ var DinersClubRedactor = core.Must(NewRedactor(`3(?:0[0-5]|[68][0-9])[0-9]{11}`))

+ var DiscoverRedactor = core.Must(NewRedactor(`6(?:011|5[0-9]{2})[0-9]{12}`))

+ var EmailRedactor = core.Must(NewRedactor(`[a-zA-Z0-9._%+\-]+@[a-zA-Z0-9.\-]+\.[a-zA-Z]{2,4}`))

+ var IPRedactor = core.Must(NewRedactor(`(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})|([0-9a-fA-F:]{2,39})`))

+ var IPV4Redactor = core.Must(NewRedactor(`\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}`))

+ var IPV6Redactor = core.Must(NewRedactor(`[0-9a-fA-F:]{2,39}`))

+ var JCBRedactor = core.Must(NewRedactor(`(?:2131|1800|35\d{3})\d{11}`))

+ var MACRedactor = core.Must(NewRedactor(`([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})`))

+ var MasterCardRedactor = core.Must(NewRedactor(...))

+ var PhoneRedactor = core.Must(NewRedactor(...))

+ var VISARedactor = core.Must(NewRedactor(`4[0-9]{12}(?:[0-9]{3})?`))

+ func Redact(value interface{}) string

+ func RedactWithHash(value interface{}) string

+ func RedactWithPrefixedHash(prefix string, value interface{}) string

+ type LoggerCarrier interface

+ GetLogger func() *Logger

Oct 27, 2022

Changes in this version

+ type LevelSet map[topicscope]Level

+ func NewLevelSet(defaultLevel Level) (levels LevelSet)

+ func ParseLevels(settings string) (levels LevelSet)

+ func ParseLevelsFromEnvironment() (levels LevelSet)

+ func (levels LevelSet) GetDefault() Level

+ func (set *LevelSet) Set(level Level, topic, scope string)

+ func (set *LevelSet) SetDefault(level Level)

+ func (set LevelSet) Get(topic, scope string) (level Level)

+ func (set LevelSet) ShouldWrite(level Level, topic, scope string) bool

+ func (set LevelSet) String() string

type Redactor

+ func (redactor Redactor) String() string

type Streamer

+ func CreateStream(levels LevelSet, destinations ...string) Streamer

Jun 2, 2022

Changes in this version

type FileStream

+ SourceInfo bool

+ func (stream *FileStream) ShouldLogSourceInfo() bool

type Logger

+ func (l *Logger) TimeFunc(message string, code func())

+ func (l *Logger) TimeFuncE(message string, code func() error) error

+ func (l *Logger) TimeFuncV(message string, code func() interface{}) interface{}

+ func (l *Logger) TimeFuncVE(message string, code func() (interface{}, error)) (interface{}, error)

+ func (log *Logger) ShouldLogSourceInfo() bool

type MultiStream

+ func (stream *MultiStream) ShouldLogSourceInfo() bool

type NilStream

+ func (stream *NilStream) ShouldLogSourceInfo() bool

type StackDriverStream

+ SourceInfo bool

+ func (stream *StackDriverStream) ShouldLogSourceInfo() bool

type StderrStream

+ SourceInfo bool

+ func (stream *StderrStream) ShouldLogSourceInfo() bool

type StdoutStream

+ SourceInfo bool

+ func (stream *StdoutStream) ShouldLogSourceInfo() bool

type Streamer

+ ShouldLogSourceInfo func() bool

Feb 16, 2022

Changes in this version

+ func GetLevelsFromEnvironment() (Level, TopicScopeLevels)

+ func GetLevelsFromString(settings string) (level Level, levels TopicScopeLevels)

+ type CloudWatchConverter struct

+ func (converter *CloudWatchConverter) Convert(record Record) Record

type FileStream

+ FilterLevels TopicScopeLevels

+ func (stream *FileStream) FilterLess()

+ func (stream *FileStream) FilterMore()

+ func (stream *FileStream) SetFilterLevelForTopic(level Level, topic string)

+ func (stream *FileStream) SetFilterLevelForTopicAndScope(level Level, topic, scope string)

+ type FilterModifier interface

+ FilterLess func()

+ FilterMore func()

+ type FilterSetter interface

+ SetFilterLevel func(level Level)

+ SetFilterLevelForTopic func(level Level, topic string)

+ SetFilterLevelForTopicAndScope func(level Level, topic, scope string)

+ SetFilterLevelIfUnset func(level Level)

type Level

+ func (level Level) Next() Level

+ func (level Level) Previous() Level

type Logger

+ func (log *Logger) FilterLess()

+ func (log *Logger) FilterMore()

+ func (log *Logger) GetScope() string

+ func (log *Logger) GetTopic() string

+ func (log *Logger) SetFilterLevelForTopic(level Level, topic string)

+ func (log *Logger) SetFilterLevelForTopicAndScope(level Level, topic, scope string)

type MultiStream

+ func (stream *MultiStream) FilterLess()

+ func (stream *MultiStream) FilterMore()

+ func (stream *MultiStream) SetFilterLevelForTopic(level Level, topic string)

+ func (stream *MultiStream) SetFilterLevelForTopicAndScope(level Level, topic, scope string)

type NilStream

+ func (stream *NilStream) FilterLess()

+ func (stream *NilStream) FilterMore()

+ func (stream *NilStream) SetFilterLevelForTopic(level Level, topic string)

+ func (stream *NilStream) SetFilterLevelForTopicAndScope(level Level, topic, scope string)

type StackDriverStream

+ FilterLevels TopicScopeLevels

+ func (stream *StackDriverStream) FilterLess()

+ func (stream *StackDriverStream) FilterMore()

+ func (stream *StackDriverStream) SetFilterLevelForTopic(level Level, topic string)

+ func (stream *StackDriverStream) SetFilterLevelForTopicAndScope(level Level, topic, scope string)

type StderrStream

+ FilterLevels TopicScopeLevels

+ func (stream *StderrStream) FilterLess()

+ func (stream *StderrStream) FilterMore()

+ func (stream *StderrStream) SetFilterLevelForTopic(level Level, topic string)

+ func (stream *StderrStream) SetFilterLevelForTopicAndScope(level Level, topic, scope string)

type StdoutStream

+ FilterLevels TopicScopeLevels

+ func (stream *StdoutStream) FilterLess()

+ func (stream *StdoutStream) FilterMore()

+ func (stream *StdoutStream) SetFilterLevelForTopic(level Level, topic string)

+ func (stream *StdoutStream) SetFilterLevelForTopicAndScope(level Level, topic, scope string)

+ type TopicScopeLevels map[string]Level

+ func (levels *TopicScopeLevels) Set(topic, scope string, level Level)

+ func (levels TopicScopeLevels) Get(topic, scope string) (level Level, found bool)

Sep 29, 2021

Changes in this version

type FileStream

+ func (stream *FileStream) SetFilterLevelIfUnset(level Level) Streamer

type Logger

+ func (log *Logger) SetFilterLevelIfUnset(level Level) Streamer

type MultiStream

+ func (stream *MultiStream) SetFilterLevelIfUnset(level Level) Streamer

type NilStream

+ func (stream *NilStream) SetFilterLevelIfUnset(level Level) Streamer

+ type Redactable interface

+ Redact func() interface{}

+ type Redactor regexp.Regexp

+ func NewRedactor(regex string) (*Redactor, error)

+ func (redactor Redactor) Redact(value string) (string, bool)

type StackDriverStream

+ func (stream *StackDriverStream) SetFilterLevelIfUnset(level Level) Streamer

type StderrStream

+ func (stream *StderrStream) SetFilterLevelIfUnset(level Level) Streamer

type StdoutStream

+ func (stream *StdoutStream) SetFilterLevelIfUnset(level Level) Streamer

type Streamer

+ SetFilterLevelIfUnset func(level Level) Streamer

Jul 15, 2021

Changes in this version

type Logger

+ func (log *Logger) Memory()

+ func (log *Logger) Memoryf(msg string, args ...interface{})

+ func (log *Logger) Memoryl(level Level)

+ func (log *Logger) Memorylf(level Level, msg string, args ...interface{})

Jun 1, 2020

Changes in this version

type Logger

+ func (log *Logger) AsStandardLog(level ...Level) *stdlog.Logger

May 31, 2020

Changes in this version

type Logger

+ func (log *Logger) Writer() io.Writer

Dec 11, 2019

Changes in this version

+ type BunyanConverter struct

+ func (converter *BunyanConverter) Convert(record Record) Record

+ type Converter interface

+ Convert func(record Record) Record

+ func GetConverterFromEnvironment() Converter

type FileStream

+ Converter Converter

+ func (stream *FileStream) Close()

+ func (stream *FileStream) SetFilterLevel(level Level) Streamer

type Logger

+ func (log *Logger) Close()

+ func (log *Logger) SetFilterLevel(level Level) Streamer

type MultiStream

+ func (stream *MultiStream) Close()

+ func (stream *MultiStream) SetFilterLevel(level Level) Streamer

type NilStream

+ func (stream *NilStream) Close()

+ func (stream *NilStream) SetFilterLevel(level Level) Streamer

+ type PinoConverter struct

+ func (converter *PinoConverter) Convert(record Record) Record

+ type StackDriverConverter struct

+ func (converter *StackDriverConverter) Convert(record Record) Record

type StackDriverStream

+ Converter Converter

+ Key interface{}

+ KeyFilename string

+ Parent string

+ func (stream *StackDriverStream) Close()

+ func (stream *StackDriverStream) SetFilterLevel(level Level) Streamer

type StderrStream

+ Converter Converter

+ func (stream *StderrStream) Close()

+ func (stream *StderrStream) SetFilterLevel(level Level) Streamer

type StdoutStream

+ Converter Converter

+ func (stream *StdoutStream) Close()

+ func (stream *StdoutStream) SetFilterLevel(level Level) Streamer

type Streamer

+ Close func()

+ SetFilterLevel func(level Level) Streamer

Nov 24, 2019

Changes in this version

type Level

+ const UNSET

type Streamer

+ func CreateMultiStream(streams ...Streamer) Streamer

Nov 22, 2019

Changes in this version

type Streamer

+ func CreateStreamWithDestination(destinations ...string) Streamer

Nov 21, 2019

Changes in this version

+ const ContextKey

+ var VERSION = "1.0.0" + commit

+ func GetFlushFrequencyFromEnvironment() time.Duration

+ func Gettid() int — darwin/amd64, linux/amd64, windows/amd64

+ type FileStream struct

+ FilterLevel Level

+ Path string

+ Unbuffered bool

+ func (stream *FileStream) Flush()

+ func (stream *FileStream) ShouldWrite(level Level) bool

+ func (stream *FileStream) Write(record Record) (err error)

+ func (stream FileStream) String() string

+ type GCPStream struct

+ FilterLevel Level

+ func (stream *GCPStream) Flush()

+ func (stream *GCPStream) ShouldWrite(level Level) bool

+ func (stream *GCPStream) Write(record Record) error

+ func (stream GCPStream) String() string

+ type Level byte

+ const ALWAYS

+ const DEBUG

+ const ERROR

+ const FATAL

+ const INFO

+ const NEVER

+ const TRACE

+ const WARN

+ func GetLevelFromEnvironment() Level

+ func GetLevelFromRecord(record Record) Level

+ func ParseLevel(value string) Level

+ func (level Level) ShouldWrite(filter Level) bool

+ func (level Level) String() string

+ type Logger struct

+ func Create(name string) *Logger

+ func CreateIfNil(logger *Logger, name string) *Logger

+ func CreateWithDestination(name, destination string) *Logger

+ func CreateWithStream(name string, stream Streamer) *Logger

+ func FromContext(context context.Context) (*Logger, error)

+ func Must(log *Logger, err error) *Logger

+ func (l *Logger) HttpHandler() func(http.Handler) http.Handler

+ func (l *Logger) ToContext(parent context.Context) context.Context

+ func (log *Logger) Child(topic, scope interface{}, params ...interface{}) *Logger

+ func (log *Logger) Debugf(msg string, args ...interface{})

+ func (log *Logger) Errorf(msg string, args ...interface{})

+ func (log *Logger) Fatalf(msg string, args ...interface{})

+ func (log *Logger) Flush()

+ func (log *Logger) GetRecord(key string) interface{}

+ func (log *Logger) Infof(msg string, args ...interface{})

+ func (log *Logger) Record(key string, value interface{}) *Logger

+ func (log *Logger) Recordf(key, value string, args ...interface{}) *Logger

+ func (log *Logger) Records(params ...interface{}) *Logger

+ func (log *Logger) Scope(value interface{}) *Logger

+ func (log *Logger) ShouldWrite(level Level) bool

+ func (log *Logger) Topic(value interface{}) *Logger

+ func (log *Logger) Tracef(msg string, args ...interface{})

+ func (log *Logger) Warnf(msg string, args ...interface{})

+ func (log *Logger) Write(record Record) error

+ func (log Logger) String() string

+ type MultiStream struct

+ func (stream *MultiStream) Flush()

+ func (stream *MultiStream) ShouldWrite(level Level) bool

+ func (stream *MultiStream) Write(record Record) error

+ func (stream MultiStream) String() string

+ type NilStream struct

+ func (stream *NilStream) Flush()

+ func (stream *NilStream) ShouldWrite(level Level) bool

+ func (stream *NilStream) Write(record Record) error

+ func (stream NilStream) String() string

+ type Record map[string]interface

+ func (record *Record) UnmarshalJSON(payload []byte) error

+ func (record Record) MarshalJSON() ([]byte, error)

+ func (record Record) Merge(source Record) Record

+ func (record Record) Set(key string, value interface{}) Record

+ func NewRecord() Record

+ type StackDriverStream struct

+ FilterLevel Level

+ LogID string

+ ProjectID string

+ func (stream *StackDriverStream) Flush()

+ func (stream *StackDriverStream) ShouldWrite(level Level) bool

+ func (stream *StackDriverStream) Write(record Record) (err error)

+ func (stream StackDriverStream) String() string

+ type StderrStream struct

+ FilterLevel Level

+ func (stream *StderrStream) Flush()

+ func (stream *StderrStream) ShouldWrite(level Level) bool

+ func (stream *StderrStream) Write(record Record) error

+ func (stream StderrStream) String() string

+ type StdoutStream struct

+ FilterLevel Level

+ Unbuffered bool

+ func (stream *StdoutStream) Flush()

+ func (stream *StdoutStream) ShouldWrite(level Level) bool

+ func (stream *StdoutStream) Write(record Record) error

+ func (stream StdoutStream) String() string

+ type Streamer interface

+ Flush func()

+ ShouldWrite func(level Level) bool

+ Write func(record Record) error