A simple Prometheus exporter for Transmission

This project aims at providing a Prometheus exporter for the Transmission BitTorrent client.

It is inspired by Transmission Exporter but takes a different, simpler, approach: instead of exporting metrics for every torrent, this exporter only provides higher-level metrics such as:

• torrents active/paused
• download/upload speed
• session/cumulative counters
• etc

Configuration

Transmission connection parameters are to be specified via environment variables when starting the container:

Variable	Value
TRANSMISSION_HOST	the hostname where Transmission RPC is running
TRANSMISSION_PORT	the port where Transmission RPC is listening
TRANSMISSION_USERNAME	the username to connect to Transmission RPC
TRANSMISSION_PASSWORD	the password to connect to Transmission RPC

Docker

docker pull sandrotosi/simple_transmission_exporter

docker run -e TRANSMISSION_HOST=xxx \
           -e TRANSMISSION_PORT=xxx \
           -e TRANSMISSION_USERNAME=xxx \
           -e TRANSMISSION_PASSWORD=xxx \
           -d -p 29091:29091 sandrotosi/simple_transmission_exporter

Implementation details

The exporter is written in Python, and uses Flask to expose the HTTP scraping endpoint.

Grafana dashboard

From these metrics, i wrote a Grafana dashboard, available on grafana.com (ID 13265) and also as a JSON file from this repo

You can find a snapshot of the dashboard here

References

• Writing Prometheus exporters
• Transmission RPC
• transmissionrpc python module
• Containerized Python Development (3 part) series