Control logging at runtime with an environment variable

Usage:

LOGLEVEL=WARN rails server

Loglevel will direct your logging to STDOUT (as suggested in the 12-factor app). See the Log Device section below for how to control where your logging goes.

Control which components create visible log entries by simply setting an environment variable. For instance:

LOGLEVEL=DEBUG,NOAR,NOHTTP rails server

would set the Rails logger level to :debug but would suppress messages from the ActiveRecord logger and the HttpLogger gem.

Here are the available settings:

The examples in this document assume Loglevel is being used in a Rails environment but it doesn't depend on Rails and can be used in other contexts.

There are specific options to handle Railsy logging scenarios: things like controlling ActiveRecord logging. There are also specific options for handling the HttpLogger gem.

In a Rails context, we want Loglevel to be configured after Rails's own logger has been initialized but before any other app initialization has taken place. This allows us to control the logging of other components' initialization.

The best way I have found of doing this is to create a script in the config/initializers directory. These initializers are executed in alphabetical order so you can control when Loglevel is initialized by carefully naming your script.

To initialize Loglevel first, create a script called 01_loglevel.rb with the single line

Loglevel.setup

To understand which other points in the Rails initialization process you can choose, see The Rails Initialization Process.

By default Loglevel will instantiate Ruby's default Logger class (in a Rails context this will be something like ActiveSupport::TaggedLogging). If you want to use a different logger then you can use an environment variable to tell Loglevel which logger you use:

LOGLEVEL_LOGGER=Log4r LOGLEVEL=DEBUG rails server

By default Loglevel will setup logging to the STDOUT device. If you want to use a different device there's an environment variable for that:

LOGLEVEL_DEVICE=tmp/test.log LOGLEVEL=DEBUG rails server

By default, Loglevel will setup the logger for Rails, ActiveRecord::Base and HttpLogger if they are present.

It will also setup logging for any other classes that you include in an environment variable:

LOGLEVEL_CLASSES=MyClass LOGLEVEL=DEBUG rails server

The only methods the class must support are logger and logger=

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request