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.3', git: 'https://github.com/vitalyliber/browserlog.git'
Browserlog is bundled as a Rails engine. Mount it on config/routes.rb
.
MyApp::Application.routes.draw do
mount Browserlog::Engine => '/logs'
end
Using gem 'devise' for authentication lets protect logs page:
authenticate :user 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