0.0
Low commit activity in last 3 years
No release in over a year
Rails application statistic logging with Raindrops
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.0
~> 10.0
~> 3.0
~> 1.3
~> 0.4.0
~> 1.27
~> 0.6.0

Runtime

~> 0.19.0
>= 4.0
 Project Readme

RainCatcher

RainCatcher utilises the raindrops statistics tool to automatically log queue data for Rack web servers (e.g. Unicorn) running Rails.

Installation

Add this line to your application's Gemfile:

gem 'rain_catcher', '~> 0.2.2'

And rebuild your bundle:

bundle install

Usage

RainCatcher automatically adds a hook into all web requests made to your application controller which will make a new log entry not more frequently than a predetermined interval.

When each request is processed, if the configured interval has elapsed then a log entry will be made.

Variable Default Value Meaning
RAIN_CATCHER_LOG_INTERVAL 30 Minimum number of seconds between each log entry
RAIN_CATCHER_LOG_LEVEL INFO Log level to use for log entries
RAIN_CATCHER_APPLICATION_NAME [inferred from Rails] Application identifier which will be included in all log entries

Log Structure

Log entries are output as JSON. For example:

{"active":5,"queued":2,"source":"rain_catcher","application":"myapp","environment":"production"}