Monitore Linux and Unix FS usage and send alarm messages to SLACK.

Table of contents

• Prerequisites
• Installing
• Defining thresholds
• BDH - visual mode
• BDH - Deamon Mode
• BDH Log
• Configure Webhook App for Slack

Prerequisites

• BASH 4.1 (or higher)
• Internet connection (necessary to send alert messages to SLACK)
• Signed up to Slack and instaled Incoming Webhook APP.

Installing

• Download bdh zip file or in tar format tar file.

• Unzip it.

• Move the BDH file to any PATH directory (use echo $PATH to see them).

• Check if everything is working well using the command $ bdh -h

Defining thresholds

Open the BDH file using your favorite text editor and change the following lines to setting up the FS usage thresholds with your values:

Def_major="70";
Def_critical="85";
Def_urgent="95";

BDH - visual mode

Use BDH with one of these options [-k |-K (Kbytes), -m | -M (Mbytes), or -g | -G (Gbytes)] to show the current FS usage.

$ bdh -g or $ bdh -G $ bdh -m or $ bdh -M $ bdh -k or $ bdh -K

The Filesystems usage will show on the screen as follows:

• NORMAL threshold FS usage is showing as default color.
• MAJOR threshold FS usage is showing as yellow.
• CRITICAL threshold FS usage is showing as red.
• URGENT threshold FS usage is showing flashing.

BDH - Deamon Mode

Using BDH with -d option will start the process in deamon mode. In this mode, BDH uses Slack to notify the moment of FS usage reachs to critical or Urgent threshold.

Starting BDH in deamon mode

$ bdh -d <interval in seconds> or $ bdh -D <interval in seconds>

Stop BDH in deamon mode

$ bdh -s

Slack messages examples

• CRITICAL alarm message is identified by a 💣 icon:

• URGENT alarm message is identified by a 🔥 icon:

BDH Log

Log files are generated by BDH process only in deamon mode and it stores piece of information such as Start, Stop, info, and alarm messages.

START  |  02/18/19-23:56:33 | Starting process in Deamon mode | PID:  9282 INTERVAL: 3600 | logFile: /tmp/bdh_021819.log
INFO  |  02/19/19-13:33:56 | FS: tmpfs | Used: 32 kb | Free: 782368 kb | 1%
CRITICAL  |  02/19/19-15:23:09 | FS: /dev/loop5 | Used: 80 kb | Free: 20 kb | 80%
URGENT  |  02/19/19-15:23:09 | FS: /dev/loop8 | Used: 100 kb | Free: 0 kb | 100%
STOP  |  02/19/19-15:23:10 | Process stopped by LEONARDO MACEDO 

Configure Webhook App for Slack

You need to configure WebHook to allow Slack receives incoming messages. here you can find the procedure to get your webhook URL for slack and change the variable SlackWebHook in BDH using the URL you got.

SlackWebHook="INSERT YOUR WEBHOOK URL HERE"

Author

Leonardo Macedo - M.Sc Software Engineering, Unix/Linux Sysadm, IT Consultant, DevOps, Python, and Shell script

---

linkedin | mail | github