[UNMAINTAINED] munin plugin to render various values taken from the a tor daemon
Python
Switch branches/tags
Nothing to show
Latest commit 02d2d8d Oct 22, 2015 @mweinelt Merge pull request #15 from thefinn93/fix-incorrect-kwarg-placement
Fix incorrect placement of port= when getting port from environ.
Permalink
Failed to load latest commit information.
.gitignore README, .gitignore, requirements.txt Mar 25, 2014
LICENSE Put project under MIT License Sep 23, 2014
README.md
circuits_by_country.py Revert "Add missing shebang." Oct 7, 2014
get_info.py Allow connecting to Tor using a socket file Sep 23, 2014
requirements.txt Cosmetics. Aug 10, 2014
tor_.py Fix incorrect placement of port= when getting port from environ. Oct 22, 2015

README.md

munin-tor

Munin plugin to render various values taken from the a tor daemon.

Requires the stem library (https://stem.torproject.org/).

Resolve dependencies for example by using pip: pip install -r requirements.txt

tor_connections

alt tor_connections
ln -s /usr/share/munin/plugins/tor_ /etc/munin/plugins/tor_connections

tor_traffic

alt tor_traffic
ln -s /usr/share/munin/plugins/tor_ /etc/munin/plugins/tor_traffic

tor_dormant

alt tor_dormant
ln -s /usr/share/munin/plugins/tor_ /etc/munin/plugins/tor_dormant

tor_countries

alt tor_countries
ln -s /usr/share/munin/plugins/tor_ /etc/munin/plugins/tor_countries

Using password authentication

Create a hashed password:

$ tor --hash-password MyVeryStrongPassword

Add the hashed password to /etc/tor/torrc and reload Tor:

HashedControlPassword 16:<long_hex_string>

Create /etc/munin/plugin-conf.d/tor_

[tor_*]
env.torpassword MyVeryStrongPassword

Configuring the connection to Tor

By default, the plugin connects to Tor using TCP on port 9051. This can be changed by setting env.port.

The plugin can also connect using a socket file. This is done by setting env.connectmethod to 'socket'. The default path for the socket file is /var/run/tor/control, but it can be changed using env.socket.

Adding new graphs

You can query infos from the tor daemon via its GETINFO¹ command. The get_info.py script helps you to look up the return values/format quickly, to see if the desired information can be efficiently extracted.

[1] 3.9 GETINFO - https://gitweb.torproject.org/torspec.git/blob/HEAD:/control-spec.txt