Skip to main content

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

Project description

Introduction

PyPi version Documentation Status

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

Quick Installation

Debian/Ubuntu assumed. Prereqs installation

apt-get install collectd transmission-daemon python-transmissionrpc python-pip

And then the actually software

pip install collectd_transmission

Configure

Insert the following in your collectd.conf:

<Plugin python>
    LogTraces false
    Interactive false
    Import "collectd_transmission"
    <Module collectd_transmission>
        username "myuser" # Required
        password "mypass" # Required
    </Module>
</Plugin>

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

There should be rrds for transmission under collectd’s data directory. Most probably that is /var/lib/collectd/rrd/<hostname>/transmission/

Documentation

If you want some actual documentation and more detailed installation and/or configuration instructions head over to:

https://collectd-transmission.readthedocs.io/en/latest/

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

collectd_transmission-3.5.tar.gz (5.5 kB view hashes)

Uploaded Source

Built Distribution

collectd_transmission-3.5-py3-none-any.whl (4.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page