https://github.com/asmega/logput

Rack middleware to output rails logs to a webpage
https://github.com/asmega/logput

debugging logging middleware rack rack-middleware rails ruby testing-tools

Last synced: about 1 year ago
JSON representation

Rack middleware to output rails logs to a webpage

• Host: GitHub
• URL: https://github.com/asmega/logput
• Owner: asmega
• License: mit
• Created: 2012-07-21T12:52:54.000Z (almost 14 years ago)
• Default Branch: master
• Last Pushed: 2017-08-30T10:09:46.000Z (almost 9 years ago)
• Last Synced: 2024-10-29T10:58:48.957Z (over 1 year ago)
• Topics: debugging, logging, middleware, rack, rack-middleware, rails, ruby, testing-tools
• Language: Ruby
• Size: 29.3 KB
• Stars: 3
• Watchers: 0
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Logput

[![Build Status](https://api.travis-ci.org/asmega/logput.svg)](https://travis-ci.org/asmega/logput) [![Code Climate](https://codeclimate.com/github/asmega/logput/badges/gpa.svg)](https://codeclimate.com/github/asmega/logput) [![Gem Version](https://badge.fury.io/rb/logput.svg)](https://badge.fury.io/rb/logput)

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.

:warning: This is *NOT* to be used in production like environments.

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

## Credits

* Phil Lee ([@asmega](https://github.com/asmega)) [Author]

* Chris Barber ([@chrisbarber86](https://github.com/chrisbarber86))

## 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](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