collectd-transmission v1.1

A python plugin for collectd to get stats from a runnning transmission server.

# Introduction #

A python plugin for integrating collectd and transmission. With this
installed, collectd will be querying transmission for the following:

* downloadedBytes
* uploadedBytes
* filesAdded
* secondsActive
* activeTorrentCount
* blocklist\_size
* downloadSpeed
* uploadSpeed
* pausedTorrentCount
* torrentCount

and creating the relevant RRD files (or pushing to graphite or whatever
you have collectd doing)

# How to install #
I assume a Debian system here, amend accordingly for your system

If you have not already installed transmision, install it:

apt-get install transmission-daemon

The above install the daemon cause a headless box is assumed. It should
probably work with a non headless box as well and a normal transmission
installation but this has not been tested.

Install the python transmission binding

apt-get install python-transmissionrpc

Install collectd.

apt-get install collectd

## Use the python package ##

pip install collectd_transmission

## Do it manually ##
Clone the repo, copy the module directory somewhere in your fileystem

# Configure #
Insert the following in your collectd.conf

<Plugin python>
ModulePath "/path/to/module/dir" # Not needed if installed via pip or package
LogTraces false
Interactive false
Import "collectd_transmission"
<Module collectd_transmission>
username "myuser" # Required
password "mypass" # Required
address "http://localhost:9091/transmission/rpc" # Optional, defaults to "http://localhost:9091/transmission/rpc"
timeout "5" # Optional, defaults to 5
</Module>
</Plugin>

modified accordingly to your needs. Restart collectd and you are done.

sudo service collectd restart

There should be rrds for transmission under collectd's data directory.
Most probably that is /var/lib/collectd/rrd/_hostname_/transmission/

## How to display your data ##

Well if you got collectd, you probably already have a way of displaying
your data anyway. If you don't there are various frontends available at:

[https://collectd.org/wiki/index.php/List\_of\_front-ends](https://collectd.org/wiki/index.php/List\_of\_front-ends)

# Compatibility #

Developed and tested on Debian Wheezy system. Feel free to submit PRs for other systems support