munin-plugins-rails 0.2.11 → 0.2.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/README.rdoc +26 -44
- data/VERSION +1 -1
- data/bin/request-log-analyzer-munin +2 -1
- data/lib/munin/plugins/passenger_memory_stats.rb +2 -0
- data/lib/munin/plugins/passenger_queue.rb +2 -0
- data/lib/munin/plugins/passenger_status.rb +2 -0
- data/lib/munin/plugins/rails_database_time.rb +2 -0
- data/lib/munin/plugins/rails_request_duration.rb +2 -0
- data/lib/munin/plugins/rails_request_error.rb +2 -0
- data/lib/munin/plugins/rails_requests.rb +2 -0
- data/lib/munin/plugins/rails_view_render_time.rb +2 -0
- data/lib/munin/rails_plugin.rb +2 -0
- data/lib/munin/request_log_analyzer_plugin.rb +2 -0
- data/munin/munin_passenger_queue +1 -0
- metadata +34 -51
data/README.rdoc
CHANGED
@@ -1,13 +1,11 @@
|
|
1
1
|
= Munin-Rails-Plugins
|
2
2
|
Collection of Concise Munin plugins for Rails server environments.
|
3
3
|
This will make monitoring your rails app a piece of cake.
|
4
|
-
|
4
|
+
|
5
5
|
This project contains munin plugins that not only work in munin, but are also concise (see references).
|
6
6
|
Most things in this repository rely heavily on the request-log-analyzer gem.
|
7
|
+
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.
|
7
8
|
|
8
|
-
The project has now been converted into a gem.
|
9
|
-
If you are looking for the loose scripts, please checkout https://github.com/barttenbrinke/munin-plugins-rails/tree/stable
|
10
|
-
|
11
9
|
== What's in the box?
|
12
10
|
* passenger_memory_stats - Munin plugin to monitor the memory usage of passenger application servers.
|
13
11
|
* 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
|
|
17
15
|
* rails_request_error - Application errors and process blocker counters.
|
18
16
|
* rails_requests - Get, put, post and delete requests.
|
19
17
|
* rails_view_render_time - Min, avg and max view render times.
|
20
|
-
|
18
|
+
|
21
19
|
For screenshots, head over to: http://barttenbrinke.github.com/munin-plugins-rails/
|
22
|
-
|
20
|
+
|
23
21
|
== Installation
|
24
22
|
Installing should be as easy as
|
25
23
|
|
26
|
-
gem install munin-rails
|
24
|
+
$ gem install munin-plugins-rails
|
27
25
|
|
28
|
-
After that you have two options
|
26
|
+
After that you have two options.
|
27
|
+
You can add the passenger plugins that will monitor the server as a whole by running:
|
28
|
+
$ sudo request-log-analyzer-munin install
|
29
29
|
|
30
|
-
|
31
|
-
* passenger_memory_stats - Munin plugin to monitor the memory usage of passenger application servers.
|
32
|
-
* pasenger_queue - Montoring of passenger queue lenth.
|
33
|
-
* passenger_status - Running, active and maximum number of passenger instances as well as sessions.
|
34
|
-
* rails_database_time - Min, avg, max of database times.
|
35
|
-
* rails_request_duration - Min, avg, max of the total request durations.
|
36
|
-
* rails_request_error - Application errors and process blocker counters.
|
37
|
-
* rails_requests - Get, put, post and delete requests.
|
38
|
-
* rails_view_render_time - Min, avg and max view render times.
|
39
|
-
|
40
|
-
To do this run:
|
41
|
-
|
42
|
-
sudo request-log-analyzer-munin install
|
43
|
-
|
44
|
-
This will create the necessary symlinks in /etc/munin/plugins and create reasonable configurations in /etc/munin/plugin-conf.d:
|
30
|
+
This will create the necessary symlinks in /etc/munin/plugins and create reasonable configurations in /etc/munin/plugin-conf.d/*
|
45
31
|
|
46
32
|
* munin_passenger_memory_stats
|
47
33
|
* munin_passenger_queue
|
48
34
|
* munin_passenger_status
|
49
35
|
|
50
|
-
|
51
|
-
|
52
|
-
You can add a specific application's log file so that you can use the following:
|
53
|
-
* rails_database_time
|
54
|
-
* rails_request_duration
|
55
|
-
* rails_request_error
|
56
|
-
* rails_requests
|
57
|
-
* rails_view_render_time
|
36
|
+
Which you can customize as needed. Please note that passenger-memory-status currently only works on Linux (http://bit.ly/krKO2x).
|
58
37
|
|
59
|
-
To do this run
|
38
|
+
The other option is to add a specific application's logfile. To do this, run:
|
60
39
|
|
61
|
-
sudo request-log-analyzer-munin add app_name path_to_log_file
|
40
|
+
$ sudo request-log-analyzer-munin add <app_name> <path_to_log_file>
|
62
41
|
|
63
|
-
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_]*/).
|
64
|
-
path_to_log_file: this is the path to the log file against which request-log-analyzer will run
|
42
|
+
* 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_]*/).
|
43
|
+
* path_to_log_file: this is the path to the log file against which request-log-analyzer will run
|
65
44
|
|
66
45
|
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:
|
67
46
|
|
@@ -71,21 +50,24 @@ After running this command you'll have appropriate symlinks in /etc/munin/plugin
|
|
71
50
|
* app_name_munin_rails_requests
|
72
51
|
* app_name_munin_rails_view_render_time
|
73
52
|
|
74
|
-
For more detailed information, see the documentation embedded in the plugins.
|
53
|
+
For more detailed information, see the documentation embedded in the plugins.
|
54
|
+
Remember to restart munin-node.
|
75
55
|
|
76
|
-
|
77
|
-
|
78
|
-
==
|
79
|
-
*
|
56
|
+
$ sudo /etc/init.d/munin-node restart
|
57
|
+
|
58
|
+
== Troubleshooting
|
59
|
+
* Specify the format of your logfile in the munin conf (i.e: <tt>env.log_format rails3</tt>).
|
60
|
+
* <tt>sudo gem install request-log-analyzer</tt>
|
80
61
|
* Check if the paths in the plugin configuration are correct.
|
81
|
-
*
|
82
|
-
|
62
|
+
* Use munin-run to test the plugin with the <tt>--debug</tt> option.
|
63
|
+
* Make sure the specified user is allowed to write to <tt>/tmp</tt> and read your rails logfile.
|
64
|
+
|
83
65
|
If you encounter performance problems with your app, please take a look at the request-log-analyzer wiki on
|
84
66
|
examples on how to drill down to the core of your problem. If you want to hire an expert, please visit us at
|
85
67
|
http://railsdoctors.com or mail me at: bart@railsdoctors.com
|
86
|
-
|
68
|
+
|
87
69
|
Happy monitoring!
|
88
|
-
|
70
|
+
|
89
71
|
== Additional information
|
90
72
|
* Railsdoctors: http://railsdoctors.com
|
91
73
|
* Request-log-analzer: http://github.com/wvanbergen/request-log-analyzer/
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
0.2.
|
1
|
+
0.2.12
|
data/lib/munin/rails_plugin.rb
CHANGED
data/munin/munin_passenger_queue
CHANGED
metadata
CHANGED
@@ -1,47 +1,41 @@
|
|
1
|
-
--- !ruby/object:Gem::Specification
|
1
|
+
--- !ruby/object:Gem::Specification
|
2
2
|
name: munin-plugins-rails
|
3
|
-
version: !ruby/object:Gem::Version
|
4
|
-
|
3
|
+
version: !ruby/object:Gem::Version
|
4
|
+
version: 0.2.12
|
5
5
|
prerelease:
|
6
|
-
segments:
|
7
|
-
- 0
|
8
|
-
- 2
|
9
|
-
- 11
|
10
|
-
version: 0.2.11
|
11
6
|
platform: ruby
|
12
|
-
authors:
|
7
|
+
authors:
|
13
8
|
- Andrew Eberbach
|
14
9
|
- Bart ten Brinke
|
15
10
|
autorequire:
|
16
11
|
bindir: bin
|
17
12
|
cert_chain: []
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
dependencies:
|
22
|
-
- !ruby/object:Gem::Dependency
|
13
|
+
date: 2013-02-10 00:00:00.000000000 Z
|
14
|
+
dependencies:
|
15
|
+
- !ruby/object:Gem::Dependency
|
23
16
|
name: request-log-analyzer
|
24
|
-
|
25
|
-
requirement: &id001 !ruby/object:Gem::Requirement
|
17
|
+
requirement: !ruby/object:Gem::Requirement
|
26
18
|
none: false
|
27
|
-
requirements:
|
28
|
-
- -
|
29
|
-
- !ruby/object:Gem::Version
|
30
|
-
|
31
|
-
segments:
|
32
|
-
- 0
|
33
|
-
version: "0"
|
19
|
+
requirements:
|
20
|
+
- - ! '>='
|
21
|
+
- !ruby/object:Gem::Version
|
22
|
+
version: '0'
|
34
23
|
type: :runtime
|
35
|
-
|
24
|
+
prerelease: false
|
25
|
+
version_requirements: !ruby/object:Gem::Requirement
|
26
|
+
none: false
|
27
|
+
requirements:
|
28
|
+
- - ! '>='
|
29
|
+
- !ruby/object:Gem::Version
|
30
|
+
version: '0'
|
36
31
|
description:
|
37
32
|
email: andrew@ebertech.ca
|
38
|
-
executables:
|
33
|
+
executables:
|
39
34
|
- request-log-analyzer-munin
|
40
35
|
extensions: []
|
41
|
-
|
42
|
-
extra_rdoc_files:
|
36
|
+
extra_rdoc_files:
|
43
37
|
- README.rdoc
|
44
|
-
files:
|
38
|
+
files:
|
45
39
|
- VERSION
|
46
40
|
- lib/munin-plugins-rails.rb
|
47
41
|
- lib/munin/command.rb
|
@@ -65,39 +59,28 @@ files:
|
|
65
59
|
- munin/munin_rails_view_render_time
|
66
60
|
- README.rdoc
|
67
61
|
- bin/request-log-analyzer-munin
|
68
|
-
has_rdoc: true
|
69
62
|
homepage:
|
70
63
|
licenses: []
|
71
|
-
|
72
64
|
post_install_message:
|
73
65
|
rdoc_options: []
|
74
|
-
|
75
|
-
require_paths:
|
66
|
+
require_paths:
|
76
67
|
- lib
|
77
|
-
required_ruby_version: !ruby/object:Gem::Requirement
|
68
|
+
required_ruby_version: !ruby/object:Gem::Requirement
|
78
69
|
none: false
|
79
|
-
requirements:
|
80
|
-
- -
|
81
|
-
- !ruby/object:Gem::Version
|
82
|
-
|
83
|
-
|
84
|
-
- 0
|
85
|
-
version: "0"
|
86
|
-
required_rubygems_version: !ruby/object:Gem::Requirement
|
70
|
+
requirements:
|
71
|
+
- - ! '>='
|
72
|
+
- !ruby/object:Gem::Version
|
73
|
+
version: '0'
|
74
|
+
required_rubygems_version: !ruby/object:Gem::Requirement
|
87
75
|
none: false
|
88
|
-
requirements:
|
89
|
-
- -
|
90
|
-
- !ruby/object:Gem::Version
|
91
|
-
|
92
|
-
segments:
|
93
|
-
- 0
|
94
|
-
version: "0"
|
76
|
+
requirements:
|
77
|
+
- - ! '>='
|
78
|
+
- !ruby/object:Gem::Version
|
79
|
+
version: '0'
|
95
80
|
requirements: []
|
96
|
-
|
97
81
|
rubyforge_project:
|
98
|
-
rubygems_version: 1.
|
82
|
+
rubygems_version: 1.8.24
|
99
83
|
signing_key:
|
100
84
|
specification_version: 3
|
101
85
|
summary: Plugins for Munin that use passenger and RLA
|
102
86
|
test_files: []
|
103
|
-
|