kudos/check_health
kudos/check_health
2
1
Fork 0
Code Issues 7 Pull Requests Projects Releases 1 Wiki Activity
check_health/README.md
patvdv 2775da5f44 Import
2017-09-02 23:27:01 +02:00

2.6 KiB
Raw Blame History

Health checker for UNIX/Linux

Health checker for UNIX/Linux is a small framework of monitoring scripts (plugins). It is meant to be used for low latency & low frequency checks, it is easy to extend where necessary and it can be integrated with other toolsets (YMMV).

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

Installation

HP-UX

Install the core bundle:

swinstall -x mount_all_filesystems=false -d /tmp/hc-hpux-<version>.sd HC-HPUX

Install the HP-UX plugin bundle:

swinstall -x mount_all_filesystems=false -d /tmp/hc-hpux-platform-<version>.sd HC-PLATFORM

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-<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

Miscelleanous

Additionally, there may be bundles for display or notification plugins, e.g.:

  • hc-display-csv
  • hc-display-init
  • hc-display-terse
  • hc-notify-eif
  • hc-notify-sms

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"