Project

logput

0.01
No commit activity in last 3 years
No release in over 3 years
Rack middleware to output rails logs to a webpage
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
>= 0
>= 0
>= 0
>= 0
>= 0
>= 0
>= 0

Runtime

>= 0
 Project Readme

Logput

Build Status Code Climate Gem Version

Rack middleware to sit in a rails app to put put the current environments log to a webpage. eg /logput

To be used in test and development environments to see logs without needing direct access to the box.

⚠️ This is NOT to be used in production like environments.

Supports Rails 3.x.x and 4.x.x

Credits

Installation

Add this line to your application's Gemfile:

gem 'logput'

And then execute:

$ bundle

Or install it yourself as:

$ gem install logput

Usage

Inside you rails app. Add the following line to config/development.rb and/or any other environment you wish to use this in.

config.middleware.use(Logput::Middleware)

The following configuration options are available.

  • :path_to_log_file => '/path/to/custom/log'. Defaults to current environments log file if in rails.
  • :lines_to_read => 1000. Defaults to 500.

Example.

config.middleware.use(Logput::Middleware, :lines_to_read => 300, :path_to_log_file => './log/delayed_job')

Start your rails server as normal in the set environment. Navigate to /logput e.g. http://localhost:3000/logput

Environment Variable Overrides

It is possible to overide the location of the log files by using the following environment variables:

  • LOG_NAME - The name of the log file, e.g. development - .log will be appended to this. If unset logput will try to use RAILS_ENV or RACK_ENV as a fallback
  • LOG_LOCATION_DIR - The directory where the log file is located, e.g. logs - a / will be added when combined with the log name.

The overrides will only be used if both are present (or the fallbacks in the case of the log name).

Contributing

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