log

Documentation

Index

• Constants
• Variables
• func DurationFormatMilliseconds(d time.Duration) interface{}
• func DurationFormatSeconds(d time.Duration) interface{}
• func DurationFormatString(d time.Duration) interface{}
• func Format(ctx context.Context, v interface{}) string
• func FormatIO(ctx context.Context, v interface{}) string
• func FormatTime(t time.Time) string
• func GetEntry(ctx context.Context) *logrus.Entry
• func SetEntry(ctx context.Context, fields logrus.Fields) (context.Context, *logrus.Entry)
• func UpdateContext(ctx context.Context) context.Context
• func WithContext(ctx context.Context, entry *logrus.Entry) (context.Context, *logrus.Entry)
• type DurationFormat
• type Hook
  • func NewHook() *Hook
  • func (h *Hook) Fire(e *logrus.Entry) (err error)
  • func (h *Hook) Levels() []logrus.Level
• type NopFormatter
  • func (NopFormatter) Format(*logrus.Entry) ([]byte, error)

Constants

const TimeFormat = "2006-01-02T15:04:05.000000000Z07:00"

TimeFormat is time.RFC3339Nano with nanoseconds padded using zeros to ensure the formatted time is always the same number of characters. Based on RFC3339NanoFixed from github.com/containerd/log

Variables

var (
	// L is the default, blank logging entry. WithField and co. all return a copy
	// of the original entry, so this will not leak fields between calls.
	//
	// Do NOT modify fields directly, as that will corrupt state for all users and
	// is not thread safe.
	// Instead, use `L.With*` or `L.Dup()`. Or `G(context.Background())`.
	L = logrus.NewEntry(logrus.StandardLogger())

	// G is an alias for GetEntry.
	G = GetEntry

	// S is an alias for SetEntry.
	S = SetEntry

	// U is an alias for UpdateContext.
	U = UpdateContext
)

Functions

func DurationFormatMilliseconds

func DurationFormatMilliseconds(d time.Duration) interface{}

func DurationFormatSeconds

func DurationFormatSeconds(d time.Duration) interface{}

func DurationFormatString

func DurationFormatString(d time.Duration) interface{}

func Format

func Format(ctx context.Context, v interface{}) string

Format formats an object into a JSON string, without any indendtation or HTML escapes. Context is used to output a log waring if the conversion fails.

This is intended primarily for `trace.StringAttribute()`

func FormatIO

func FormatIO(ctx context.Context, v interface{}) string

FormatIO formats net.Conn and other types that have an `Addr()` or `Name()`.

See FormatEnabled for more information.

func FormatTime

func FormatTime(t time.Time) string

func GetEntry

func GetEntry(ctx context.Context) *logrus.Entry

GetEntry returns a `logrus.Entry` stored in the context, if one exists. Otherwise, it returns a default entry that points to the current context.

Note: if the a new entry is returned, it will reference the passed in context. However, existing contexts may be stored in parent contexts and additionally reference earlier contexts. Use `UpdateContext` to update the entry and context.

func SetEntry

func SetEntry(ctx context.Context, fields logrus.Fields) (context.Context, *logrus.Entry)

SetEntry updates the log entry in the context with the provided fields, and returns both. It is equivalent to:

entry := GetEntry(ctx).WithFields(fields)
ctx = WithContext(ctx, entry)

See WithContext for more information.

func UpdateContext

func UpdateContext(ctx context.Context) context.Context

UpdateContext extracts the log entry from the context, and, if the entry's context points to a parent's of the current context, ands the entry to the most recent context. It is equivalent to:

entry := GetEntry(ctx)
ctx = WithContext(ctx, entry)

This allows the entry to reference the most recent context and any new values (such as span contexts) added to it.

See WithContext for more information.

func WithContext

func WithContext(ctx context.Context, entry *logrus.Entry) (context.Context, *logrus.Entry)

WithContext returns a context that contains the provided log entry. The entry can be extracted with `GetEntry` (`G`)

The entry in the context is a copy of `entry` (generated by `entry.WithContext`).

Types

type DurationFormat

type DurationFormat func(time.Duration) interface{}

DurationFormat formats a time.Duration log entry.

A nil value signals an error with the formatting.

type Hook

type Hook struct {
	// EncodeAsJSON formats structs, maps, arrays, slices, and [bytes.Buffer] as JSON.
	// Variables of [bytes.Buffer] will be converted to []byte.
	//
	// Default is false.
	EncodeAsJSON bool

	// FormatTime specifies the format for [time.Time] variables.
	// An empty string disables formatting.
	// When disabled, the fall back will the JSON encoding, if enabled.
	//
	// Default is [TimeFormat].
	TimeFormat string

	// Duration format converts a [time.Duration] fields to an appropriate encoding.
	// nil disables formatting.
	// When disabled, the fall back will the JSON encoding, if enabled.
	//
	// Default is [DurationFormatString], which appends a duration unit after the value.
	DurationFormat DurationFormat

	// AddSpanContext adds [logfields.TraceID] and [logfields.SpanID] fields to
	// the entry from the span context stored in [logrus.Entry.Context], if it exists.
	AddSpanContext bool
}

Hook intercepts and formats a logrus.Entry before it logged.

The shim either outputs the logs through an ETW hook, discarding the (formatted) output or logs output to a pipe for logging binaries to consume. The Linux GCS outputs logrus entries over stdout, which is then consumed and re-output by the shim.

func NewHook

func NewHook() *Hook

func (*Hook) Fire

func (h *Hook) Fire(e *logrus.Entry) (err error)

func (*Hook) Levels

func (h *Hook) Levels() []logrus.Level

type NopFormatter

type NopFormatter struct{}

func (NopFormatter) Format

func (NopFormatter) Format(*logrus.Entry) ([]byte, error)

Format does nothing and returns a nil slice.