package logging

import "github.com/open-policy-agent/opa/v1/logging"

Index ¶

• func DecisionIDFromContext(ctx context.Context) (string, bool)
• func NewContext(parent context.Context, val *RequestContext) context.Context
• func WithDecisionID(parent context.Context, id string) context.Context
• func WithHTTPRequestContext(parent context.Context, val *HTTPRequestContext) context.Context
• type HTTPRequestContext
• func HTTPRequestContextFromContext(ctx context.Context) (*HTTPRequestContext, bool)
• type Level
• type Logger
• type NoOpLogger
• func NewNoOpLogger() *NoOpLogger
• func (*NoOpLogger) Debug(string, ...interface{})
• func (*NoOpLogger) Error(string, ...interface{})
• func (l *NoOpLogger) GetLevel() Level
• func (*NoOpLogger) Info(string, ...interface{})
• func (l *NoOpLogger) SetLevel(level Level)
• func (*NoOpLogger) Warn(string, ...interface{})
• func (l *NoOpLogger) WithFields(fields map[string]interface{}) Logger
• type RequestContext
• func FromContext(ctx context.Context) (*RequestContext, bool)
• func (rctx RequestContext) Fields() logrus.Fields
• type StandardLogger
• func Get() *StandardLogger
• func New() *StandardLogger
• func (l *StandardLogger) Debug(fmt string, a ...interface{})
• func (l *StandardLogger) Error(fmt string, a ...interface{})
• func (l *StandardLogger) GetLevel() Level
• func (l *StandardLogger) Info(fmt string, a ...interface{})
• func (l *StandardLogger) SetFormatter(formatter logrus.Formatter)
• func (l *StandardLogger) SetLevel(level Level)
• func (l *StandardLogger) SetOutput(w io.Writer)
• func (l *StandardLogger) Warn(fmt string, a ...interface{})
• func (l *StandardLogger) WithFields(fields map[string]interface{}) Logger

Functions ¶

func DecisionIDFromContext ¶

func DecisionIDFromContext(ctx context.Context) (string, bool)

func NewContext ¶

func NewContext(parent context.Context, val *RequestContext) context.Context

NewContext returns a copy of parent with an associated RequestContext.

func WithDecisionID ¶

func WithDecisionID(parent context.Context, id string) context.Context

func WithHTTPRequestContext ¶

func WithHTTPRequestContext(parent context.Context, val *HTTPRequestContext) context.Context

Types ¶

type HTTPRequestContext ¶

type HTTPRequestContext struct {
	Header http.Header
}

func HTTPRequestContextFromContext ¶

func HTTPRequestContextFromContext(ctx context.Context) (*HTTPRequestContext, bool)

type Level ¶

type Level uint8

Level log level for Logger

const (
	// Error error log level
	Error Level = iota
	// Warn warn log level
	Warn
	// Info info log level
	Info
	// Debug debug log level
	Debug
)

type Logger ¶

type Logger interface {
	Debug(fmt string, a ...interface{})
	Info(fmt string, a ...interface{})
	Error(fmt string, a ...interface{})
	Warn(fmt string, a ...interface{})

	WithFields(map[string]interface{}) Logger

	GetLevel() Level
	SetLevel(Level)
}

Logger provides interface for OPA logger implementations

type NoOpLogger ¶

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

NoOpLogger logging implementation that does nothing

func NewNoOpLogger ¶

func NewNoOpLogger() *NoOpLogger

NewNoOpLogger instantiates new NoOpLogger

func (*NoOpLogger) Debug ¶

func (*NoOpLogger) Debug(string, ...interface{})

Debug noop

func (*NoOpLogger) Error ¶

func (*NoOpLogger) Error(string, ...interface{})

Error noop

func (*NoOpLogger) GetLevel ¶

func (l *NoOpLogger) GetLevel() Level

GetLevel get log level

func (*NoOpLogger) Info ¶

func (*NoOpLogger) Info(string, ...interface{})

Info noop

func (*NoOpLogger) SetLevel ¶

func (l *NoOpLogger) SetLevel(level Level)

SetLevel set log level

func (*NoOpLogger) Warn ¶

func (*NoOpLogger) Warn(string, ...interface{})

Warn noop

func (*NoOpLogger) WithFields ¶

func (l *NoOpLogger) WithFields(fields map[string]interface{}) Logger

WithFields provides additional fields to include in log output. Implemented here primarily to be able to switch between implementations without loss of data.

type RequestContext ¶

type RequestContext struct {
	ClientAddr         string
	ReqID              uint64
	ReqMethod          string
	ReqPath            string
	HTTPRequestContext HTTPRequestContext
}

RequestContext represents the request context used to store data related to the request that could be used on logs.

func FromContext ¶

func FromContext(ctx context.Context) (*RequestContext, bool)

FromContext returns the RequestContext associated with ctx, if any.

func (RequestContext) Fields ¶

func (rctx RequestContext) Fields() logrus.Fields

Fields adapts the RequestContext fields to logrus.Fields.

type StandardLogger ¶

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

StandardLogger is the default OPA logger implementation.

func Get ¶

func Get() *StandardLogger

Get returns the standard logger used throughout OPA.

Deprecated. Do not rely on the global logger.

func New ¶

func New() *StandardLogger

New returns a new standard logger.

func (*StandardLogger) Debug ¶

func (l *StandardLogger) Debug(fmt string, a ...interface{})

Debug logs at debug level

func (*StandardLogger) Error ¶

func (l *StandardLogger) Error(fmt string, a ...interface{})

Error logs at error level

func (*StandardLogger) GetLevel ¶

func (l *StandardLogger) GetLevel() Level

GetLevel returns the standard logger level.

func (*StandardLogger) Info ¶

func (l *StandardLogger) Info(fmt string, a ...interface{})

Info logs at info level

func (*StandardLogger) SetFormatter ¶

func (l *StandardLogger) SetFormatter(formatter logrus.Formatter)

SetFormatter sets the underlying logrus formatter.

func (*StandardLogger) SetLevel ¶

func (l *StandardLogger) SetLevel(level Level)

SetLevel sets the standard logger level.

func (*StandardLogger) SetOutput ¶

func (l *StandardLogger) SetOutput(w io.Writer)

SetOutput sets the underlying logrus output.

func (*StandardLogger) Warn ¶

func (l *StandardLogger) Warn(fmt string, a ...interface{})

Warn logs at warn level

func (*StandardLogger) WithFields ¶

func (l *StandardLogger) WithFields(fields map[string]interface{}) Logger

WithFields provides additional fields to include in log output

Source Files ¶

logging.go

Directories ¶