No commit activity in last 3 years
No release in over 3 years
Pulse meter toolbox
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

~> 0.2.0
>= 3.0
 Project Readme

This gem is deprecated. For PulseMeter and Rails integration see https://github.com/savonarola/pulse-meter#rails-app-integration

Build Status

PulseToolbox

Pulse toolbox provides various metrics for your Rails application out of box. It is based on pulse-meter gem.

Beeing added to Gemfile Pulse Toolbox allows you to mount monitoring page in your routes.rb file.

Requests processing times will be displayed there. You can also add custom sensors to configuration to be displayed.

Installation

Add this line to your application's Gemfile:

gem 'pulse-meter-rails'

And then execute:

$ bundle

Or install it yourself as:

$ gem install pulse-meter-rails

Data compression

Don't forget to schedule regular pulse reduce commant to keep redis data small and make visualization fast

Usage

Create an initializer with the following config

PulseToolbox.redis = Redis.new :host => "localhost", :port => 6379, :db => 2
PulseToolbox::Server::Monitoring.use Rack::Auth::Basic do |username, password|
  username == 'admin'
end

And mount monitoring server in your routes.rb

mount PulseToolbox::Server::Monitoring, :at => "/monitoring"

Or you can use generator to create initializer and add route:

$ bundle exec rails g pulse_toolbox:install

Launch your application and visit /monitoring

Extra configuration

You can add your own groups of sensors to page in initializer:

group = PulseToolbox::Sensor::Manager.add_group(:min)
PulseToolbox::Sensor::Manager.add_sensor(group, :user_age, {
    :sensor_type => 'timelined/min',
    :color => '#0000FF',
    :args => {
      :ttl => 10.days,
      :interval => 10.minutes,
      :raw_data_ttl => 10.hours,
      :reduce_delay => 2.minutes,
      :annotation => "User ages"
    }
  }
})

Default layout can be easily exteneded in initializer by standart pulse-meter DSL

PulseMeter::Sensor::Timelined::Counter.new(:custom_sensor,
  :ttl => 1.hour,
  :interval => 1.minute,
  :raw_data_ttl => 10.minutes,
  :reduce_delay => 2.minutes
)

PulseToolbox::Sensor::Manager.layout do |l|
  l.page "Custom" do |p|
    p.line "Custom sensor" do |w|
      w.sensor :custom_sensor, :color => "#0000FF"

      w.timespan 60 * 60 * 3
      w.redraw_interval 10

      w.show_last_point true
      w.values_label "Time"
      w.width 10
    end
  end
end

Data isolation

To avoid collisions between multiple rails applications with monitoring enabled use separate Redis DB for each of them

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