add fail2ban to python README
Ilya committed
Jan 6, 2017 at 17:28 UTC
5588688346177fee6354b9e1a79323cfe813ffe1
1 file changed
+28
-4
python.d/README.md
+28
-4
@@ -235,6 +235,30 @@ Configuration is not needed.
235
236
---
237
238
+# fail2ban
239
+
240
+Module monitor fail2ban log file to show all bans for all active jails
241
+
242
+**Requirements:**
243
+ * fail2ban.log file MUST BE readable by netdata (A good idea is to add **create 0640 root netdata** to fail2ban conf at logrotate.d)
244
+
245
+It produces one chart with multiple lines (one line per jail)
246
+
247
+### configuration
248
+
249
+Sample:
250
+
251
+```yaml
252
+local:
253
+ log_path: '/var/log/fail2ban.log'
254
+ conf_path: '/etc/fail2ban/jail.local'
255
+ exclude: 'dropbear apache'
256
+```
257
+If no configuration is given, module will attempt to read log file at `/var/log/fail2ban.log` and conf file at `/etc/fail2ban/jail.local`.
258
+If conf file is not found default jail is `ssh`.
259
+
260
+---
261
+
262
# freeradius
263
264
Uses the `radclient` command to provide freeradius statistics. It is not recommended to run it every second.
@@ -594,19 +618,19 @@ Module monitor openvpn-status log file.
618
619
**Requirements:**
620
597
-1. If you are running multiple OpenVPN instances out of the same directory, MAKE SURE TO EDIT DIRECTIVES which create output files
621
+ * If you are running multiple OpenVPN instances out of the same directory, MAKE SURE TO EDIT DIRECTIVES which create output files
622
so that multiple instances do not overwrite each other's output files.
623
600
-2. Make sure NETDATA USER CAN READ openvpn-status.log
624
+ * Make sure NETDATA USER CAN READ openvpn-status.log
625
602
-3. Update_every interval MUST MATCH interval on which OpenVPN writes operational status to log file.
626
+ * Update_every interval MUST MATCH interval on which OpenVPN writes operational status to log file.
627
628
It produces:
629
630
**Users** OpenVPN active users
631
* users
632
609
- **Traffic** OpenVPN overall bandwidth usage in kilobit/s
633
+**Traffic** OpenVPN overall bandwidth usage in kilobit/s
634
* in
635
* out
636