Jstatus WatchDog

Description

jstatus.sh is a script for your Jormungandr Active / Passive Nodes Monitoring, Node Health Check, Storage Backup and much more…

Features:

1) Node (passive/active) stats plot
2) Pool Stats (grabbed from IOHK eplorer)
3) Sqlite Storage Backup
4) PoolTool tip submission
5) PoolTool public tip stats plot
6) PoolTool stats (win/loss json)
7) TG messages on block created/rejected
8) Auto recovery restart of the node

Monitoring Parameters Explained:

1) HOST: Hostname of the server where the script is running

2) Blocks: The all time total amount of blocks produced by the Pool

3) Epoch: Full Current Epoch format

4) Uptime: Total time the Jormungandr process is up and running without restarts

5) Storage: Current Dimension of Jormungandr sqlite DB

6) BlockHeight: Current blockheight and report of the PoolTool.io’s Submission Tip

7) PoolTheight: PoolTool.io Stats

8) Quarantined: Quarantined connections

9) Established: Established connections

10) Pool’s Blocks Stats:

10a) Made blocks on the blockchain in the current Epoch

10b) Total Made pool’s blocks in the current Epoch

10c) Multi-leader slot won (PoolTool.io)

10d) Multi-leader slot lost (PoolTool.io)

10e) Rejected blocks in the current Epoch

10f) Remaining slots to be compute before the end of the current Epoch

10g) Total assigned slots of the current Epoch

10h) Number of planned slots to be computed in the current hour

11) Last Tx Hash

12) last 2 blocks: Latest blocks computed by the pool

13) current slot: Current hour next block planned

14) future slots: First 2 slots assigned in the next hour

15) Pool Stats (Current Delegated stake, last Epoch rewards for both delegators and the pool it self.)

Requirements:

  • Linux OS
  • Jormungandr node up and running
  • net-tools installed (needed to collect network stats)

Download Link

Installation and usage:

  1. Once downloaded you can run it as is for passive nodes (if so skip to point 3)
  2. while if you want to monitor a pool and have more stats than you need to edit the script and customize it (see points: 5,6,7)
  3. give it executable permissions by using: “chmod +x jstatus.sh”
  4. then just ru it: “./jstatus.sh”
  5. if it is the first time you will probably make sure to set your env API endpoint: “i.e.: export JORMUNGANDR_RESTAPI_URL=http://127.0.0.1:3101/api”
  6. you may want also to customize the Pool ID: “i.e: export MY_POOL_ID=<YOUR_POOL_ID>”
  7. and if you fancy (I raccomend it) to submit to pooltool.io your pool tip, than you can also set: “MY_USER_ID” variable within the script.