Skip to content

Latest commit

 

History

History
50 lines (34 loc) · 2.19 KB

README.md

File metadata and controls

50 lines (34 loc) · 2.19 KB

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