Skip to content

oni7uka/browserlog

 
 

Repository files navigation

Browserlog

Build Status Dependency Status Code Climate Coverage Status

Browserlog is a live web log viewer for rails apps.

Screenshot dark theme Screenshot light theme

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

About

Watch rails logs live on the browser

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Ruby 62.5%
  • HTML 16.8%
  • CSS 11.5%
  • CoffeeScript 5.9%
  • JavaScript 3.3%