+ transmission plugin (torrent activity, status, traffic)

plugins/transmission/README.md

@@ -0,0 +1,44 @@
+
+# Munin Transmission plugin
+
+This plugin provides the following data/graphs:
+ * activity: displaying the number of active/inactive torrents
+ * status: displaying the number of torrents by their status (seeding, downloading, stopped, etc)
+ * traffic: showing network traffic (download, upload) generated by transmission
+
+
+## Installation, requirements
+
+The plugin is written in python and uses the [transmission-rpc](https://pypi.org/project/transmission-rpc/). Install the package by `pip`:
+```
+sudo python3 -m pip install transmission-rpc
+```
+
+link the plugin to your /etc/munin/plugins/ directory:
+```
+cd /etc/munin/plugins/
+ln -s /the/plugin/path/transmission_ transmission_activity
+ln -s /the/plugin/path/transmission_ transmission_status
+ln -s /the/plugin/path/transmission_ transmission_traffic
+```
+
+if your transmission doesn't run on the standard port or requires authentication, fill up the following variables (in `/etc/munin/plugin-conf.d/transmission`):
+```
+[transmission*]
+    env.host localhost
+    env.port 9091
+    env.user transmission
+    env.pass secret
+```
+
+## Example graphs
+
+### Torrent activity
+![transmission_activity_example_day_.png](transmission_activity_example_day_.png "transmission_activity_example_day_.png")
+
+### Torrent status
+![transmission_status_example_day.png](transmission_status_example_day.png "transmission_status_example_day.png")
+
+### Transmission upload/download traffic
+![transmission_traffic_example_day.png](transmission_traffic_example_day.png "transmission_traffic_example_day.png")
+