README.md

# LogfmtLogger

An Elixir logger backend that outputs logs in [logfmt](https://brandur.org/logfmt) style.

## Installation

If [available in Hex](https://hex.pm/docs/publish), the package can be installed
by adding `logfmt_logger` to your list of dependencies in `mix.exs`:

```elixir
def deps do
  [
    {:logfmt_logger, "~> 0.1.0"}
  ]
end
```

Documentation can be generated with [ExDoc](https://github.com/elixir-lang/ex_doc)
and published on [HexDocs](https://hexdocs.pm). Once published, the docs can
be found at [https://hexdocs.pm/logfmt_logger](https://hexdocs.pm/logfmt_logger).

## Usage
To log a message with metadata:
```elixir
Logger.warn("It's getting smokey in here", house_on_fire: true, firedept_called: false)
```
which will output:
```
time=2018-05-01T09:34:58 level=warn msg="It's getting smokey in here" house_on_fire=true firedept_called=false
```