Skip to main content

Tor monitoring with Netdata

Connects to the Tor control port to collect traffic statistics.


  • tor program
  • stem python package

It produces only one chart:

  1. Traffic

    • read
    • write


Edit the python.d/tor.conf configuration file using edit-config from the Netdata config directory, which is typically at /etc/netdata.

cd /etc/netdata # Replace this path with your Netdata config directory, if different
sudo ./edit-config python.d/tor.conf

Needs only control_port.

Here is an example for local server:

update_every : 1
priority : 60000
name: 'local'
control_port: 9051
name: 'local'
control_port: '/var/run/tor/control'


Add to /etc/tor/torrc:

ControlPort 9051

For more options please read the manual.

Without configuration, module attempts to connect to

Reach out

If you need help after reading this doc, search our community forum for an answer. There's a good chance someone else has already found a solution to the same issue.



Last updated on