Introduction
A python plugin for integrating collectd and transmission. With this installed, collectd will be querying transmission for the following:
Per session and cumulative:
downloadedBytes
uploadedBytes
filesAdded
secondsActive
General:
activeTorrentCount
blocklist_size
downloadSpeed
uploadSpeed
pausedTorrentCount
torrentCount
and creating the relevant RRD files (or pushing to graphite or whatever you have collectd doing)
Some of these metrics are per session, some session cumulative, some are session independent. Their type ‘current’, ‘cumulative’, ‘general’ is set in the name of the metric
Compatibility
Developed and tested on Debian Wheezy system.
That means:
collectd 5.1
transmissionrpc 0.8
But testing has also been conducted on Debian Jessie systems. Which means:
collectd 5.4
transmissionrpc 0.11
It is expected Debian Jessie will be the main playground soon
Feel free to submit PRs for other systems support
How to install
Prerequisites
Those are collectd and transmission
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
Install collectd_transmission
There are two ways to achieve this for now
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:
Metadata
Release files for collectd-transmission v2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| collectd_transmission-v2.0.tar.gz | 5.3 kB | Without provenance | Details |
Release files / collectd_transmission-v2.0.tar.gz
| Download URL | collectd_transmission-v2.0.tar.gz |
|---|---|
| Size | 5.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b6b81177b1d2a5fe01923ce5afeaa9cdb141dca0a5df9de4f5e86a13d9a76ff0
|
|
BLAKE2b-256 checksum How to use checksums |
1553ba64be30c47e866a2419972064c61c482190456a677a3dd11c9f569c3f5f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for collectd-transmission v2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.