blob: c66803766affc8615944cdab971271926140b4ee (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
<!--
title: "Tor monitoring with Netdata"
custom_edit_url: "https://github.com/netdata/netdata/edit/master/collectors/python.d.plugin/tor/README.md"
sidebar_label: "Tor"
learn_status: "Published"
learn_topic_type: "References"
learn_rel_path: "References/Collectors references/Apps"
-->
# Tor monitoring with Netdata
Connects to the Tor control port to collect traffic statistics.
## Requirements
- `tor` program
- `stem` python package
It produces only one chart:
1. **Traffic**
- read
- write
## Configuration
Edit the `python.d/tor.conf` configuration file using `edit-config` from the Netdata [config
directory](https://github.com/netdata/netdata/blob/master/docs/configure/nodes.md), which is typically at `/etc/netdata`.
```bash
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:
```yaml
update_every : 1
priority : 60000
local_tcp:
name: 'local'
control_port: 9051
password: <password> # if required
local_socket:
name: 'local'
control_port: '/var/run/tor/control'
password: <password> # if required
```
### prerequisite
Add to `/etc/tor/torrc`:
```
ControlPort 9051
```
For more options please read the manual.
Without configuration, module attempts to connect to `127.0.0.1:9051`.
---
|
