munin-plugins-rails 0.2.11 → 0.2.12

data/README.rdoc

@@ -1,13 +1,11 @@
 = Munin-Rails-Plugins
 Collection of Concise Munin plugins for Rails server environments.
 This will make monitoring your rails app a piece of cake.
- 
+
 This project contains munin plugins that not only work in munin, but are also concise (see references).
 Most things in this repository rely heavily on the request-log-analyzer gem.
+The project has recenly been converted into a gem. If you are looking for the loose scripts, please checkout: https://github.com/barttenbrinke/munin-plugins-rails/tree/master/munin.
 
-The project has now been converted into a gem. 
-If you are looking for the loose scripts, please checkout https://github.com/barttenbrinke/munin-plugins-rails/tree/stable 
- 
 == What's in the box?
 * passenger_memory_stats - Munin plugin to monitor the memory usage of passenger application servers.
 * pasenger_queue - Montoring of passenger queue lenth.
@@ -17,51 +15,32 @@ If you are looking for the loose scripts, please checkout https://github.com/bar
 * rails_request_error - Application errors and process blocker counters.
 * rails_requests - Get, put, post and delete requests.
 * rails_view_render_time - Min, avg and max view render times.
- 
+
 For screenshots, head over to: http://barttenbrinke.github.com/munin-plugins-rails/
- 
+
 == Installation
 Installing should be as easy as
 
-gem install munin-rails-plugins
+ $ gem install munin-plugins-rails
 
-After that you have two options:
+After that you have two options.
+You can add the passenger plugins that will monitor the server as a whole by running:
+ $ sudo request-log-analyzer-munin install
 
-You can add the passenger plugins that will monitor the server as a whole. These include:
-* passenger_memory_stats - Munin plugin to monitor the memory usage of passenger application servers.
-* pasenger_queue - Montoring of passenger queue lenth.
-* passenger_status - Running, active and maximum number of passenger instances as well as sessions.
-* rails_database_time - Min, avg, max of database times.
-* rails_request_duration - Min, avg, max of the total request durations.
-* rails_request_error - Application errors and process blocker counters.
-* rails_requests - Get, put, post and delete requests.
-* rails_view_render_time - Min, avg and max view render times.
-
-To do this run:
-
-sudo request-log-analyzer-munin install 
-
-This will create the necessary symlinks in /etc/munin/plugins and create reasonable configurations in /etc/munin/plugin-conf.d:
+This will create the necessary symlinks in /etc/munin/plugins and create reasonable configurations in /etc/munin/plugin-conf.d/*
 
 * munin_passenger_memory_stats
 * munin_passenger_queue
 * munin_passenger_status
 
-You can customize these as needed.
-
-You can add a specific application's log file so that you can use the following:
-* rails_database_time
-* rails_request_duration
-* rails_request_error
-* rails_requests
-* rails_view_render_time
+Which you can customize as needed. Please note that passenger-memory-status currently only works on Linux (http://bit.ly/krKO2x).
 
-To do this run
+The other option is to add a specific application's logfile. To do this, run:
 
-sudo request-log-analyzer-munin add app_name path_to_log_file
+ $ sudo request-log-analyzer-munin add <app_name> <path_to_log_file>
 
-app_name: this will be the prefix for the graphs and the munin plugins so it should be a valid identifier (/[A-Za-z0-9_]*/).
-path_to_log_file: this is the path to the log file against which request-log-analyzer will run
+ * app_name: this will be the prefix for the graphs and the munin plugins so it should be a valid identifier (/[A-Za-z0-9_]*/).
+ * path_to_log_file: this is the path to the log file against which request-log-analyzer will run
 
 After running this command you'll have appropriate symlinks in /etc/munin/plugins and a set of configuration files in /etc/munin/plugin-conf.d:
 
@@ -71,21 +50,24 @@ After running this command you'll have appropriate symlinks in /etc/munin/plugin
 * app_name_munin_rails_requests
 * app_name_munin_rails_view_render_time
 
-For more detailed information, see the documentation embedded in the plugins. 
+For more detailed information, see the documentation embedded in the plugins.
+Remember to restart munin-node.
 
-Remember to restart munin-node. 
- 
-== Problems
-* sudo gem install request-log-analyzer
+ $ sudo /etc/init.d/munin-node restart
+
+== Troubleshooting
+* Specify the format of your logfile in the munin conf (i.e: <tt>env.log_format rails3</tt>).
+* <tt>sudo gem install request-log-analyzer</tt>
 * Check if the paths in the plugin configuration are correct.
-* Make sure the specified user is allowed to write to /tmp and access your rails logfile.
- 
+* Use munin-run to test the plugin with the <tt>--debug</tt> option.
+* Make sure the specified user is allowed to write to <tt>/tmp</tt> and read your rails logfile.
+
 If you encounter performance problems with your app, please take a look at the request-log-analyzer wiki on
 examples on how to drill down to the core of your problem. If you want to hire an expert, please visit us at
 http://railsdoctors.com or mail me at: bart@railsdoctors.com
- 
+
 Happy monitoring!
- 
+
 == Additional information
 * Railsdoctors:         http://railsdoctors.com
 * Request-log-analzer:  http://github.com/wvanbergen/request-log-analyzer/

data/VERSION

@@ -1 +1 @@
-0.2.11
+0.2.12

data/bin/request-log-analyzer-munin

@@ -1,4 +1,5 @@
-#!/usr/bin/env ruby
+#!/bin/env ruby
+# encoding: utf-8
 
 $:.unshift(File.expand_path('../lib', File.dirname(__FILE__)))
 

data/lib/munin/plugins/passenger_memory_stats.rb

@@ -1,3 +1,5 @@
+#!/bin/env ruby
+# encoding: utf-8
 module Munin
   class PassengerMemoryStats < RequestLogAnalyzerPlugin    
     def ensure_configuration

data/lib/munin/plugins/passenger_queue.rb

@@ -1,3 +1,5 @@
+#!/bin/env ruby
+# encoding: utf-8
 module Munin
   class PassengerQueue < RequestLogAnalyzerPlugin
     def ensure_configuration

data/lib/munin/plugins/passenger_status.rb

@@ -1,3 +1,5 @@
+#!/bin/env ruby
+# encoding: utf-8
 module Munin
   class PassengerStatus < RequestLogAnalyzerPlugin
     def ensure_configuration

data/lib/munin/plugins/rails_database_time.rb

@@ -1,3 +1,5 @@
+#!/bin/env ruby
+# encoding: utf-8
 module Munin
   class RailsDatabaseTime < RailsPlugin
     def config

data/lib/munin/plugins/rails_request_duration.rb

@@ -1,3 +1,5 @@
+#!/bin/env ruby
+# encoding: utf-8
 module Munin
   class RailsRequestDuration < RailsPlugin
     def config

data/lib/munin/plugins/rails_request_error.rb

@@ -1,3 +1,5 @@
+#!/bin/env ruby
+# encoding: utf-8
 module Munin
   class RailsRequestError < RailsPlugin
     def config

data/lib/munin/plugins/rails_requests.rb

@@ -1,3 +1,5 @@
+#!/bin/env ruby
+# encoding: utf-8
 module Munin
   class RailsRequests < RailsPlugin
     def config

data/lib/munin/plugins/rails_view_render_time.rb

@@ -1,3 +1,5 @@
+#!/bin/env ruby
+# encoding: utf-8
 module Munin
   class RailsViewRenderTime < RailsPlugin
     def config

data/lib/munin/rails_plugin.rb

@@ -1,3 +1,5 @@
+#!/bin/env ruby
+# encoding: utf-8
 module Munin
   class RailsPlugin < RequestLogAnalyzerPlugin
 

data/lib/munin/request_log_analyzer_plugin.rb

@@ -1,3 +1,5 @@
+#!/bin/env ruby
+# encoding: utf-8
 module Munin
   class RequestLogAnalyzerPlugin
     attr_accessor :graph_category

data/munin/munin_passenger_queue

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+#coding: utf-8
 pod=<<-POD
 
 =head1 NAME

metadata

@@ -1,47 +1,41 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: munin-plugins-rails
-version: !ruby/object:Gem::Version 
-  hash: 1
+version: !ruby/object:Gem::Version
+  version: 0.2.12
   prerelease: 
-  segments: 
-  - 0
-  - 2
-  - 11
-  version: 0.2.11
 platform: ruby
-authors: 
+authors:
 - Andrew Eberbach
 - Bart ten Brinke
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-03-28 00:00:00 -04:00
-default_executable: request-log-analyzer-munin
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2013-02-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: request-log-analyzer
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
-  version_requirements: *id001
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: 
 email: andrew@ebertech.ca
-executables: 
+executables:
 - request-log-analyzer-munin
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - README.rdoc
-files: 
+files:
 - VERSION
 - lib/munin-plugins-rails.rb
 - lib/munin/command.rb
@@ -65,39 +59,28 @@ files:
 - munin/munin_rails_view_render_time
 - README.rdoc
 - bin/request-log-analyzer-munin
-has_rdoc: true
 homepage: 
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.5.0
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Plugins for Munin that use passenger and RLA
 test_files: []
-