129 lines
3.2 KiB
Markdown
129 lines
3.2 KiB
Markdown
<p align="center"><img src="logo/horizontal.png" alt="QList" height="130px"></p>
|
|
|
|
# Health checker for UNIX/Linux
|
|
|
|
Health checker for UNIX/Linux is a small framework of monitoring scripts. It is meant to be used for low latency & low frequency checks, it is easy to extend where necessary (plugins) and it can be integrated with other toolsets.
|
|
|
|
## Requirements
|
|
|
|
* ksh88/ksh93 (mksh/pdksh will work also but YMMV)
|
|
* some disk space for storing logs & event files
|
|
* system dependant tools/utilities (see individual health checks)
|
|
* UNIX cron or other scheduler
|
|
* execute as user root only
|
|
|
|
## Build
|
|
|
|
Use the build templates & scripts in the `build/` directory to roll your own packages.
|
|
|
|
## Installation
|
|
|
|
### HP-UX
|
|
|
|
Install the core bundle:
|
|
|
|
swinstall -x mount_all_filesystems=false -s /tmp/hc-hpux-<version>.sd \*
|
|
|
|
Install the HP-UX plugin bundle:
|
|
|
|
swinstall -x mount_all_filesystems=false -s /tmp/hc-hpux-platform-<version>.sd \*
|
|
|
|
### Linux
|
|
|
|
Install the core bundle:
|
|
|
|
yum localinstall hc-linux-<version>.noarch.rpm
|
|
zypper install hc-linux-<version>.noarch.rpm
|
|
|
|
Install the Linux plugin bundle:
|
|
|
|
yum localinstall hc-linux-platform-<version>.noarch.rpm
|
|
zypper install hc-linux-platform-<version>.noarch.rpm
|
|
|
|
### AIX
|
|
|
|
Install the core bundle:
|
|
|
|
installp -Xap -d hc-aix-<version>.bff all
|
|
|
|
Install the AIX plugin bundle:
|
|
|
|
installp -Xap -d hc-aix-platform-<version> all
|
|
|
|
### Exadata
|
|
|
|
Install the core bundle:
|
|
|
|
yum localinstall hc-linux-<version>.noarch.rpm
|
|
|
|
Install the Linux plugin bundle:
|
|
|
|
yum localinstall hc-exadata-platform-<version>.noarch.rpm
|
|
|
|
### Miscellaneous
|
|
|
|
Additionally, there may be bundles for display or notification plugins, e.g.:
|
|
* hc-display-csv
|
|
* hc-display-init
|
|
* hc-display-json
|
|
* hc-display-terse
|
|
* hc-notify-eif
|
|
* hc-notify-sms
|
|
|
|
## Execute (examples)
|
|
|
|
* **Listing** available health checks:
|
|
```
|
|
/opt/hc/bin/check_health.sh --list
|
|
```
|
|
|
|
* **Running** a single health check:
|
|
```
|
|
/opt/hc/bin/check_health.sh --hc=check_hpux_ioscan --run
|
|
```
|
|
|
|
* **Running** multiple health checks (at once):
|
|
```
|
|
/opt/hc/bin/check_health.sh --hc=check_hpux_ioscan,check_hpux_ovpa_status --run
|
|
```
|
|
|
|
* **Running** a single health check with a custom configuration file:
|
|
```
|
|
/opt/hc/bin/check_health.sh --hc=check_hpux_ioscan --config-file=/etc/opt/hc/check_hpux_ioscan_new.conf --run
|
|
```
|
|
|
|
* **Showing** information on a health check:
|
|
```
|
|
/opt/hc/bin/check_health.sh --hc=check_hpux_ioscan --show
|
|
```
|
|
|
|
* **Enabling/disabling** a health check:
|
|
```
|
|
/opt/hc/bin/check_health.sh --hc=check_hpux_ioscan --check
|
|
/opt/hc/bin/check_health.sh --hc=check_hpux_ioscan --disable
|
|
/opt/hc/bin/check_health.sh --hc=check_hpux_ioscan --enable
|
|
```
|
|
|
|
* **Reporting** on failed health checks:
|
|
```
|
|
/opt/hc/bin/check_health.sh --report
|
|
/opt/hc/bin/check_health.sh --report --last
|
|
/opt/hc/bin/check_health.sh --report --today
|
|
/opt/hc/bin/check_health.sh --report --id=20160704154001 --detail
|
|
```
|
|
|
|
* **Alerting** on failed health checks:
|
|
```
|
|
/opt/hc/bin/check_health.sh --hc=check_hpux_root_crontab --run --notify=mail --mail-to="alert@acme.com"
|
|
```
|
|
|
|
## References
|
|
|
|
### Documentation
|
|
|
|
More documentation can be found at http://www.kudos.be/Projects/Health_checker.html
|
|
|
|
### Logo
|
|
|
|
The logo was kindly provided by *Komiser Back*.
|