This project has been archived and its development halted. I don't have much interest in maintaining it anymore. Feel free to fork and have fun :)

Browserlog is a live web log viewer for rails apps.

• Auto-refresh

The simplest way to install Browserlog is to use Bundler.

gem 'browserlog', '~> 0.0.2'

Browserlog is bundled as a Rails engine. Mount it on config/routes.rb.

MyApp::Application.routes.draw do
  mount Browserlog::Engine => '/logs'
end

With this setup logs/development, logs/staging, logs/production and logs/test are automatically available on the browser.

For most production environments, it's recommended to not serve logs without authentication. While an authentication scheme is not yet ready, this gem blocks by default any requests to logs/* in such production environment (i.e. RAILS_ENV=production).

In case you want to allow those logs to be displayed under production (e.g. staging servers), use the following initializer:

# config/initializers/allow_logs_on_production.rb
Browserlog.config.allow_production_logs = true

• Rails >= 3.2.18 and 4.1.1