FedericoCeratto / munin-tor

munin plugin to render various values taken from the a tor daemon

munin-tor

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

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

tor_connections

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

tor_traffic

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

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

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