Skip to content
HTTP service to monitor if catapult node is harvesting.
Shell Makefile Dockerfile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
Dockerfile initial commit (functional) Jan 28, 2019
Makefile initial commit (functional) Jan 28, 2019
catapult-harvestmon initial commit (functional) Jan 28, 2019
docker-compose-example.yml add docker-compose example Jan 28, 2019
harvestmon_check_height add "no-cache" http header Feb 8, 2019
mock_block_height_api initial commit (functional) Jan 28, 2019

Catapult Harvestmon

Monitor if catapult node is harvesting. The tool expect and endpoint that returns json in this structure:


Above json structure is the response of catapult diagnostic endpoint at When first initiated, catapult-harvestmon will take the json response of given endpoint and persist it in file. It will then run an http endpoint at localhost:3111. Any request to localhost:3111 will trigger catapult-harvestmon to check the current height of given catapult endpoint and compare it against previous height.

Sample output from catapult-harvestmon:

$ curl localhost:3111
{"ok":true,"msg":"block height incremented from 1744062 to 1744063"}
$ curl localhost:3111
{"ok":false,"msg":"block height did not increment from 1744063. is the node still harvesting?"}
$ # wait 10s
$ curl localhost:3111
{"ok":true,"msg":"block height incremented from 1744063 to 1744064"}


Without docker:

  • clone the repo
  • run this command:

With docker:

docker run -it --rm -p 3111:3111 luxtagofficial/catapult-harvestmon

Once the running, setup an HTTP monitoring tool (ie. uptimemonitor, cabot) to send GET request to catapult-harvestmon endpoint and check if its response contains "ok":true. If it returns something else, trigger error event.

-- End of file

You can’t perform that action at this time.