Project status

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

Browserlog is a live web log viewer for rails apps.

Features

• Auto-refresh

Installation

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.

Note for production environments

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

Supported Rails Versions

• Rails >= 3.2.18 and 4.1.1