https://github.com/jgmdev/watchsys

Bash shell script for basic system monitoring and prevention.
https://github.com/jgmdev/watchsys

Last synced: 3 months ago
JSON representation

Bash shell script for basic system monitoring and prevention.

• Host: GitHub
• URL: https://github.com/jgmdev/watchsys
• Owner: jgmdev
• License: gpl-3.0
• Created: 2015-01-13T05:22:38.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2015-11-28T02:22:38.000Z (about 9 years ago)
• Last Synced: 2024-08-05T08:09:45.499Z (7 months ago)
• Language: Shell
• Size: 33.2 KB
• Stars: 26
• Watchers: 7
• Forks: 11
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: ChangeLog
  • License: LICENSE

Awesome Lists containing this project

README

        
# WatchSys

Bash shell script for basic system monitoring and prevention.

## About

WatchSys is a set of bash shell scripts that run from a central daemon

for basic monitoring of a linux server processes, cpu usage,

network connections, ram usage, disk usage, file changes, etc...

This software is licensed under the GPLv3 http://www.gnu.org/licenses/

### Features

* Monitoring of file changes.

* Monitoring of servers online status.

* Monitoring of cpu, memory and disk usage.

* Monitoring of system processes/services status.

* Automatic restart of system processes/services if they fail.

* E-mailing of reports for system events like failed proccesses,

  dead connections, file changes, critical cpu usage,

  critical memory usage, critical disk space usage, etc...

## Installation

As root user execute the following commands:

```shell

wget https://github.com/jgmdev/watchsys/archive/master.zip

unzip master.zip

cd watchsys-master

./install.sh

```

## Uninstallation

As root user execute the following commands:

```shell

cd watchsys-master

./uninstall.sh

```

## Usage

The installer will automatically detect if your system supports

init.d scripts, systemd services or cron jobs. If one of them is found

it will install apropiate files and start the watchsys script.

Once you hava WatchSys installed proceed to modify the config

files to fit your needs.

**/etc/watchsys/watchsys.conf**

The behaviour of the watchsys script is modified by this configuration file.

For more details see **man watchsys** which has documentation of the

different configuration options.

**/etc/watchsys/proc.list**

On this file you can add a list of processes you wish to monitor

in case of failure, this processes would be restarted by WatchSys

and a notification e-mail sent to you. Example:

> \# [Process Name] : [Service Name] : [Start Command] 


>   named          :   bind9        :  default 


>   hiawatha       :   hiawatha     :  hiawatha -c /custom/config.conf

**/etc/watchsys/servers.list**

On this file you can add a list of host names or ip addresses to

monitor its online status, for example:

> \# server : port 


> myserver.com : none 


> myserver.com : 80 


> mail.myserver.com : 143 


> 192.168.1.1 : none

As you see **none** is used when we want to monitor a server online

status, but not a service on a specific port.

**/etc/watchsys/dir.list**

Here you can add a list of directories to scan for file changes.

if any changes are found on the given directories, an e-mail

will be sent to you with a report. Example:

> /usr/bin 


> /usr/sbin

After you modify the config files you will need to restart the daemon.

If running on systemd:

> systemctl restart watchsys

If running as classical init.d script:

> /etc/init.d/watchsys restart 


> or 


> service watchsys restart

## CLI Usage

**watchsys** [OPTION]

#### OPTIONS

**-h | --help:**

   Show the help screen.

**-d | --start:**

   Initialize a daemon to monitor system.

**-s | --stop:**

   Stop the daemon.

**-t | --status:**

   Show status of daemon and pid if currently running.