rTorrent-O-Meter

rTorrent-O-Meter is a simple ​Munin plugin pack for monitoring rTorrent's upload/download speed, torrent, peer and DHT statistics

• Download
• Prerequisites
• Installation
• Changelog

Download

• Latest release
• All releases

Prerequisites

• rTorrent 0.7.5 or newer
  • compiled with "--with-xmlrpc-c"
  • XMLRPC-C >= 1.00

Installation

Install the plugins, like any munin plugin (e.g.: create a symlink into /etc/munin/plugins), and open the /etc/munin/plugin-conf.d file. Create a section for the installed plugin, and insert the lines similar to the ones shown below:

[rtom_username_spdd]
user username
env.src socket
env.socket /home/username/torrent/.socket/rpc.socket
env.diff yes

or

[rtom_username_spdd]
env.ip 127.0.0.1
env.port 5000
env.diff yes

depending on what rTorrent configuration you have.

If you use more than one plugin for a user, you don't need to add a section for every plugin to your /etc/munin/plugin-conf.d file, you can use the following syntax:

[rtom_username_*]
user username
env.src socket
env.socket /home/username/torrent/.socket/rpc.socket
env.diff yes

or

[rtom_username_*]
env.ip 127.0.0.1
env.port 5000
env.diff yes

Also, if you don't want to monitor more than one user, the username is not mandatory, you can leave the filenames as they were, and use the following configuration:

[rtom__spdd]
user username
env.src socket
env.socket /home/username/torrent/.socket/rpc.socket
env.diff yes

or

[rtom__spdd]
env.ip 127.0.0.1
env.port 5000
env.diff yes

The * character can be used in this case too.

Configurable variables:

src	"socket" when using scgi_socket, or anything else when using scgi_port
socket	rTorrent's rpc socket (scgi_local)	using scgi_local	needed when "src" is set to "socket"
ip	rTorrent's ip address	using scgi_port	needed when "src" is NOT set to "socket"
port	rTorrent's scgi port (scgi_port)	using scgi_port	needed when "src" is NOT set to "socket"
diff	"yes" for displaying bits per second for upload and Byets per second for download, or anything else for using Bytes per second for both	used by rtom__spd and rtom__spdd plugins

Changelog

• 0.4.0
• 0.3.0
• 0.2.0
• 0.1.0d
• 0.1.0
• 0.0.1d
• 0.0.1
• 0.0.0
• Legend

0.4.0

• * New plugin for monitoring the amount of uploaded data per torrent
• + minor formatting changes, and cleanup in the code
• - 2010. 07. 24.

0.3.0

• * New plugin for monitoring DHT statistics
• * New filename format to support multiple instances, with easy munin-node configuration - just name the file rtom_username_peers
• + Using different query for rtom__vol plugin (a single request instead of 5 different one) for speed improvement
• - 2010. 01. 17.

0.2.0

• * New plugins for monitoring rTorrent's memory usage, torrent count, and peer count
• + rtom_spdd displays upload and download limit on the graph
• x Fixed bug, where rtom_spd stopped working on 32 bit integer overflow (when using XMLRPC-C < 1.07)
• - rtom_spd is now obsolete, use rtom_spdd instead
• - 2008. 06. 19.

0.1.0

• * Full rewrite in Perl
• * New plugins for monitoring torrent statistics (shows number of started/stopped/incomplete/complete/all torrents)
• * Now supports UNIX domain socket (scgi_local)
• + Speed graph uses get_{up|down}_total to get more actual values (and to make the graph smoother)
• + Configurable via munin-node's plugin config (environmental variables)
• - 2008. 05. 23.

0.0.1d

• - Different graph scale for upload and download for asymmetric line (upload is in b/s, download is in B/s)
• - 2008. 02. 29.

0.0.1

• x Minor textbugs fixed
• - 2007. 12. 20.

0.0.0

• - Initial release
• - 2007. 12. 18.

Legend

• * New feature
• + Minor update
• x Bugfix
• - Information