Skip to main content

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:

https://collectd.org/wiki/index.php/List_of_front-ends

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)

Source distribution for collectd-transmission v2.0
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page