Adding upstream version 1.43.0.upstream/1.43.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 34 insertions, 14 deletions

diff --git a/collectors/python.d.plugin/fail2ban/metadata.yaml b/collectors/python.d.plugin/fail2ban/metadata.yaml
index 80aa68b62..61f762679 100644
--- a/collectors/python.d.plugin/fail2ban/metadata.yaml
+++ b/collectors/python.d.plugin/fail2ban/metadata.yaml
@@ -35,29 +35,29 @@ modules:
           The `fail2ban.log` file must be readable by the user `netdata`.
             - change the file ownership and access permissions.
             - update `/etc/logrotate.d/fail2ban`` to persist the changes after rotating the log file.
-          
+
           To change the file ownership and access permissions, execute the following:
-          
+
           ```shell
           sudo chown root:netdata /var/log/fail2ban.log
           sudo chmod 640 /var/log/fail2ban.log
           ```
-          
+
           To persist the changes after rotating the log file, add `create 640 root netdata` to the `/etc/logrotate.d/fail2ban`:
-          
+
           ```shell
           /var/log/fail2ban.log {
-          
+
               weekly
               rotate 4
               compress
-          
+
               delaycompress
               missingok
               postrotate
                   fail2ban-client flushlogs 1>/dev/null
               endscript
-          
+
               # If fail2ban runs as non-root it still needs to have write access
               # to logfiles.
               # create 640 fail2ban adm
@@ -67,7 +67,8 @@ modules:
       default_behavior:
         auto_detection:
           description: |
-            By default the collector will attempt to read log file at /var/log/fail2ban.log and conf file at /etc/fail2ban/jail.local. If conf file is not found default jail is ssh.
+            By default the collector will attempt to read log file at /var/log/fail2ban.log and conf file at /etc/fail2ban/jail.local.
+            If conf file is not found default jail is ssh.
         limits:
           description: ""
         performance_impact:
@@ -77,19 +78,19 @@ modules:
         list: []
       configuration:
         file:
-          name: ""
+          name: python.d/fail2ban.conf
           description: ""
         options:
           description: |
             There are 2 sections:
-            
+
             * Global variables
             * One or more JOBS that can define multiple different instances to monitor.
-            
+
             The following options can be defined globally: priority, penalty, autodetection_retry, update_every, but can also be defined per JOB to override the global values.
-            
+
             Additionally, the following collapsed table contains all the options that can be configured inside a JOB definition.
-            
+
             Every configuration JOB starts with a `job_name` value which will appear in the dashboard, unless a `name` parameter is specified.
           folding:
             title: Config options
@@ -146,7 +147,26 @@ modules:
                   conf_path: '/etc/fail2ban/jail.local'
     troubleshooting:
       problems:
-        list: []
+        list:
+          - name: Debug Mode
+            description: |
+              To troubleshoot issues with the `fail2ban` module, run the `python.d.plugin` with the debug option enabled.
+              The output will give you the output of the data collection job or error messages on why the collector isn't working.
+
+              First, navigate to your plugins directory, usually they are located under `/usr/libexec/netdata/plugins.d/`. If that's
+              not the case on your system, open `netdata.conf` and look for the setting `plugins directory`. Once you're in the
+              plugin's directory, switch to the `netdata` user.
+
+              ```bash
+              cd /usr/libexec/netdata/plugins.d/
+              sudo su -s /bin/bash netdata
+              ```
+
+              Now you can manually run the `fail2ban` module in debug mode:
+
+              ```bash
+              ./python.d.plugin fail2ban debug trace
+              ```
     alerts: []
     metrics:
       folding: