Skip to content

Automated Validator Monitoring for Oasis Validator Nodes, Wired to Pager Duty

License

Notifications You must be signed in to change notification settings

Tessellated-io/oasis-monitor

Repository files navigation

Oasis Monitor

This is a simple typescript application to enable monitoring of a Oasis validator node from Tessellated Geometry.

It checks:

  • If your node is lagging by n blocks versus the Oasis Monitor API
  • If your node is has missed m precommits in a row.

If either condition occurs, it will send you a page via Pager Duty's API.

Setup

  • This software requires the Oasis API server to be running on the machine.
  • Retrieve your pager duty API token, pager duty service identifier, and pager duty email from PagerDuty
  • Modify global variables in src/monitor.ts for the specifics of your setup.

Docker

Build a container:

docker build -t tessellatedgeometry/oasis-monitor

You can then do whatever Docker things you want with the container.

Source

If you're prefer to run from source:

  • Install npm (or yarn if that's your thing).
  • Run npm i to install dependencies.
  • Run ./start.sh.

You'll likely need to do a bit of light customization to make this infrastructure suite your exact needs. PRs to generalize the software or extend functionality are welcome. In particular, it would be cool to provide a customizatble remote API.

Feel free to drop us a line on Keybase or at [email protected] if you need help.

Daemon

A service definition is included. You can modify and deploy the deamon with:

mv oasis-monitor.service /etc/systemd/system/
systemctl enable oasis-monitor
systemctl start oasis-monitor

Say Thanks

If this software is useful to you please consider delegating to us.

About

Automated Validator Monitoring for Oasis Validator Nodes, Wired to Pager Duty

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published