akasprzok/svadilfari

An Elixir Logger Backend for Grafana Loki.

Svadilfari

A logger backend for sending logs directly to Grafana Loki.

Installation

The package can be installed by adding svadilfari to your list of dependencies in mix.exs:

def deps do
  [
    {:svadilfari, "~> 0.1"}
  ]
end

Configure some parameters:

config :logger, :backends, [:console, Svadilfari]

# This setting is needed because Loki will complain if timestamps are too much off,
# and Logger sends timestamps without time zone information.
config :logger, utc_log: true

config :logger, :svadilfari,
  metadata: [:user_id, :bogons],
  max_buffer: 10,
  client: [
    url: "http://localhost:3100",
    opts: [
      org_id: "tenant1"
    ]
  ],
  labels: [
    {"service", "svadilfari"},
    {"env", "dev"}
  ]

and start sending logs to Loki!

Documentation

For detailed documentation, configuration options, and examples, see hex docs.

svadilfari's Issues

Is this library supported?

I was searching for a logging library to Grafana Loki and found this. Can it be used in production?

Need to set utc_log to true

I got errors from loki saying that my logs where from the future, so I had to set
config :logger, utc_log: true

Perhaps this should be made clear in the documentation.

Ability to extract labels from log

Promtail provides the ability to extract labels from logs at run time. While Grafana's guidance is to be extremely careful with this to prevent cardinality explosion, Svadilfari should provide a similar feature.