Collection of Nagios plugins for EOS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.md
check_bp.py
check_bp_paused.sh
check_history.sh
check_last_claim.sh
check_producing.sh
chinai-cpu.sh
zfs_backup.sh

README.md

nagios

Collection of Nagios plugins for EOS.

To-DO

  • Allow for check_fork function to read hosts from file.

📌 check_bp.py

A python script to monitor your Block Producers using nagios or other. Each function performs a particular action and EXITS with 0 if there are no issues and EXITS with 2 if there are issues.

(1) Check the participation rate of your block producer
  • Checks your host has a participation rate of more than 0.5.
  • EXITS with 0 if participation rate > 5.
  • EXITS with 2 if participation rate < 5.
Usage for check_ratio

check_bp.py x.x.x.x:8888 check_ratio

(2) Check the head_block_num of your producer is incrementing
  • Checks your host's head_block_num and saves that as a varaible, waits 5 secodns and checks again.
  • EXITS with 0 if head_block_num has incremented.
  • EXITS with 2 if head_block_num has not incremented.
Usage for check_head

check_bp.py x.x.x.x:8888 check_head

(3) Check multiple hosts and saves the head_block_num, take the median average and checks against your host.
  • Check multiple hosts and saves the head_block_num, takes the median average. If any hosts has a head_block_num value where absolute difference from the median is > 1,000 they are excluded from the calc.
  • EXITS with 0 if head_block_num has incremented.
  • EXITS with 2 if head_block_num difference is out of bounds(> abs(5) of average)
Usage for check_fork

check_bp.py x.x.x.x:8888 check_fork

(4) Check the last_irreversible_block_num of the chain is incrementing
  • Checks your host's last_irreversible_block_num and saves that as a varaible, waits 10 secodns and checks again.
  • EXITS with 0 if last_irreversible_block_num has incremented.
  • EXITS with 2 if last_irreversible_block_num has not incremented.
Usage for check_lib

check_bp.py x.x.x.x:8888 check_lib

📌 check_producing.sh

  • Checks the producer list and records your unpaid_blocks integer an saves to a file.
  • Re-Checks the producer list and checks whewther number has increased.
Usage

check_producing.sh

📌 check_last_claim.sh

  • Checks the last time your producer claimedrewards and ensures the value is not > 24 hours.
Usage

check_last_claim.sh

📌 check_history.sh

  • Checks whether your BASH history contains any EOS wallet passwords OR Private keys.
Usage

check_history.sh

📌 zfs_backup.sh

  • Checks whether your ZFS snapshots contain a recent snapshot.
Usage

zfs_backup.sh