Skip to content
Collection of Nagios plugins for EOS
Shell Python
Branch: master
Clone or download
Pull request Compare This branch is even with eos42:master.
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
account-cpu.sh
check_account_ram.sh
check_bp.py
check_bp_paused.sh
check_history.sh
check_last_claim.sh
check_producing.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

📌 check_account_ram.sh

  • Checks teh RAM usage for an account on chain and alerts if current usage is over $MAX variable.

📌 account-cpu.sh

  • Checks CPU usage of account over 60 seconds period and compares average to $MAX variable, if higher it alerts.
You can’t perform that action at this time.