logrus

Documentation

Index

• Variables
• type Hook
  • func New(options ...Option) (*Hook, error)
  • func (h *Hook) Close()
  • func (h *Hook) Fire(entry *logrus.Entry) error
  • func (h *Hook) Levels() []logrus.Level
• type Option
  • func SetClient(client *axiom.Client) Option
  • func SetClientOptions(options []axiom.Option) Option
  • func SetDataset(datasetName string) Option
  • func SetIngestOptions(opts axiom.IngestOptions) Option
  • func SetLevels(levels ...logrus.Level) Option

Variables

var ErrMissingDatasetName = errors.New("missing dataset name")

ErrMissingDatasetName is raised when a dataset name is not provided. Set it manually using the SetDataset option or export `AXIOM_DATASET`.

Types

type Hook

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

Hook implements a `logrus.Hook` used for shipping logs to Axiom.

func New

func New(options ...Option) (*Hook, error)

New creates a new `Hook` configured to ingest logs to the Axiom deployment and dataset as specified by the environment. Refer to `axiom.NewClient()` for more details on how configuring the Axiom deployment works or pass the `SetClient()` option to pass a custom client or `SetClientOptions()` to control the Axiom client creation. To specify the dataset set `AXIOM_DATASET` or use the `SetDataset()` option.

An ingest token is sufficient enough. Additional options can be supplied to configure the `Hook`. A hook needs to be closed properly to make sure all logs are sent by calling `Close()`.

func (*Hook) Close

func (h *Hook) Close()

Close the hook and make sure all events are flushed. This should be registered with `logrus.RegisterExitHandler(h.Close)`. Closing the hook renders it unusable for further use.

func (*Hook) Fire

func (h *Hook) Fire(entry *logrus.Entry) error

Fire implements logrus.Hook.

func (*Hook) Levels

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

Levels implements logrus.Hook.

type Option

type Option func(*Hook) error

An Option modifies the behaviour of the Axiom hook.

func SetClient

func SetClient(client *axiom.Client) Option

SetClient specifies the Axiom client to use for ingesting the logs.

func SetClientOptions

func SetClientOptions(options []axiom.Option) Option

SetClientOptions specifies the Axiom client options to pass to `axiom.NewClient()`. `axiom.NewClient()` is only called if no client was specified by the `SetClient` option.

func SetDataset

func SetDataset(datasetName string) Option

SetDataset specifies the dataset to ingest the logs into. Can also be specified using the `AXIOM_DATASET` environment variable.

func SetIngestOptions

func SetIngestOptions(opts axiom.IngestOptions) Option

SetIngestOptions specifies the ingestion options to use for ingesting the logs.

func SetLevels

func SetLevels(levels ...logrus.Level) Option

SetLevels sets the logrus levels that the Axiom hook will create log entries for.