Skip to content

Latest commit

 

History

History
69 lines (50 loc) · 1.76 KB

README.md

File metadata and controls

69 lines (50 loc) · 1.76 KB
Raw

Validator Monitor

A python script for monitoring NEAR Protocol validator performance, tracking blocks and chunks production. Runs by default non stop on a timed interval. If you want to get alerts on your validator underperforming, the easiest way to do it is to use with the --single-run & --quiet mode, while specifying your validator via --val-id. Then have urlwatch call the script and alert you only when the results displayed changed (which will alert when the epoch turns and you've missed any blocks/chunks or every time your miss count changes during an epoch).

Prerequisites

  • Python 3.6 or higher
  • Access to a NEAR RPC endpoint (default: localhost:3030)

Usage

python3 valmon.py [options]

Options

  • --val-id: Monitor a specific validator by account ID
  • --quiet: Show only performance data (requires --val-id)
  • --single-run: Run once and exit
  • --interval: Set monitoring interval in seconds (default: 60)

Examples

Monitor all validators:

python3 valmon.py

Monitor specific validator:

python3 valmon.py --val-id example.near

Quick status check:

python3 valmon.py --val-id example.poolv1.near --quiet --single-run

Custom interval:

python3 valmon.py --interval 300  # Check every 5 minutes

Output

Full Mode

Shows detailed information about:

  • Missing blocks per validator
  • Missing chunks per validator
  • Timestamp for each check
  • Connection status

Quiet Mode

Displays concise status:

  • Number of missed blocks
  • Number of missed chunks

Error Handling

The script handles various error conditions:

  • RPC connection failures
  • Invalid validator IDs
  • Network interruptions

Press Ctrl+C to stop the monitoring process.

License

CC 4.0