README.md

LagerX
=======

This package implements a simple wrapper over https://github.com/basho/lager.

It embeds logging calls to LagerX into a module if currently configured logging
level is less or equal than severity of a call. Therefore it doesn't have
any negative impact on performance of a production system when you configure
error level even if you have tons of debug messages.

Information about location of a call (module, function, line, pid) is properly
passed to lager for your convenience so you can easily find the source of a message.
In this aspect using LagerX is equal to using parse transform shipped with
basho lager.

Since LagerX depends on macro implemented in LagerX module you have to require it.
Then you call one of logging methods on LagerX module. There are seven logging
methods in order of severity:

 - debug
 - info
 - notice
 - warning
 - error
 - critical
 - alert
 - emergency

Examples:
---------

```elixir
defmodule Test do
  require LagerX
  def debug do
    LagerX.debug "Hi debug"
  end
  def info do
    LagerX.info "Hi error"
  end
  def notice do
    LagerX.notice "Hi notice"
  end
  def warning do
    LagerX.warning "Hi warning"
  end
  def error do
    LagerX.error "Hi error"
  end
  def critical do
    LagerX.critical "Hi critical"
  end
  def alert do
    LagerX.alert "Hi alert"
  end
  def emergency do
    LagerX.emergency "Hi emergency"
  end
  def test do
    debug
    info
    notice
    warning
    error
    critical
    alert
    emergency
  end
end

Application.start :lager_x
Test.test
```

Configuration
-------------
It is possible to configure truncation size and compile time log level.
Being a simple wrapper LagerX doesn't attempt to configure underlying LagerX.
You would need to configure it yourself [see](https://github.com/basho/lager) to ensure that:

  * lager_truncation_size >= compile_truncation_size
  * lager severity level >= compile_log_level
  * appropriate handlers are configured

Configuration of LagerX can be done by calling helper functions of LagerX from your build system as follows:

```
iex(1)> LagerX.compile_log_level(:info)
true
iex(2)> LagerX.compile_truncation_size(512)
true
```

If you cannot call those function you can set compiler options:

```
iex(3)> Code.compiler_options lager_x_level: :debug
ok
iex(4)> Code.compiler_options lager_x_truncation_size: 512
ok
```

If you are mix user you could specify level and truncation_size in *config/config.#{Mix.env}.exs* as follows:

```
    use Mix.Config

    config :lager_x,
      level: :debug,
      truncation_size: 8096
```

Multiple Sink Support
---------------------
As of LagerX 3.x, you can configure multiple sinks to provide different behavior
for different streams of logs.  To use a different sink, prepend the name to the
logging calls above.  For example, to use the `magic_lager_event` sink, you can
do the following:

```
LagerX.info :magic, "magic event"
```