structure

Documentation

Index

• Constants
• func MapKeyValues(keyvals []interface{}, ...) []interface{}
• func RemoveKeys(keyvals []interface{}, keys ...interface{}) []interface{}
• func Value(keyvals []interface{}, key interface{}) interface{}
• func ValuesAndContext(keyvals []interface{}, keys ...interface{}) (map[interface{}]interface{}, []interface{})
• func Vectorise(keyvals []interface{}, vectorKeys ...string) []interface{}
• type Channel

Constants

const (
	// Log time (time.Time)
	TimeKey = "time"
	// Call site for log invocation (go-stack.Call)
	CallerKey = "caller"
	// Log message (string)
	MessageKey = "message"
	// Top-level component (choose one) name
	ComponentKey = "component"
	// Vector-valued scope
	ScopeKey = "scope"
	// Globally unique identifier persisting while a single instance (root process)
	// of this program/service is running
	RunId = "run_id"
	// Stack trace for log call
	StackTraceKey = "trace"
	// Logging channel, Info or Trace
	ChannelKey = "channel"
	// Go error value
	ErrorKey = "error"

	// Channels (can be used for semantic filtering through LoggingConfig)
	InfoChannel  Channel = "info"
	TraceChannel Channel = "trace"
)

Functions

func MapKeyValues

func MapKeyValues(keyvals []interface{}, fn func(interface{}, interface{}) (interface{}, interface{})) []interface{}

Maps key values pairs with a function (key, value) -> (new key, new value)

func RemoveKeys

func RemoveKeys(keyvals []interface{}, keys ...interface{}) []interface{}

Drops all key value pairs where the key is in keys

func Value

func Value(keyvals []interface{}, key interface{}) interface{}

Return a single value corresponding to key in keyvals

func ValuesAndContext

func ValuesAndContext(keyvals []interface{},
	keys ...interface{}) (map[interface{}]interface{}, []interface{})

Pull the specified values from a structured log line into a map. Assumes keys are single-valued. Returns a map of the key-values from the requested keys and the unmatched remainder keyvals as context as a slice of key-values.

func Vectorise

func Vectorise(keyvals []interface{}, vectorKeys ...string) []interface{}

'Vectorises' values associated with repeated string keys member by collapsing many values into a single vector value. The result is a copy of keyvals where the first occurrence of each matching key and its first value are replaced by that key and all of its values in a single slice.

Types

type Channel

type Channel string