Alerting & Reporting Setup Guide
Monitor Your Validator Node and Receive Email Alerts
Last updated
Was this helpful?
Monitor Your Validator Node and Receive Email Alerts
Last updated
Was this helpful?
This guide walks you through configuring basic alerting and reporting for your Validator node using the nodectl
utility. It enables email notifications if your node drops from the cluster (excluding local network outages).
The nodectl utility's alerting feature depends on your node being reachable. If the VPS goes offline or loses internet access, alerts cannot be transmitted and will not be delivered.
nodectl must be installed and running on your node.
A Gmail account with:
2-Step Verification enabled
A dedicated App Password (email token) created for nodectl
In your Google Account > Security > 2-Step Verification section
Scroll to App passwords
Click the right-arrow (>) to open
Under Select app, choose Other (Custom name)
Enter a name (e.g., constellation_alerts
)
Click Create
Copy the generated app password (token) and store it securely
โ ๏ธ This password will only be shown once.
If lost, delete and recreate it.
Youโll be prompted for the following details:
gmail account
The Gmail address used to send alerts
token
The App Password (token) you generated
send method
Use multi
(recommended) or single
recipient emails
Comma-separated list of emails (you@gmail.com,alert@example.com
)
time zone
Your exact timezone string (e.g., America/Los_Angeles
)
begin alerting hour
Start time for alerts in UTC (e.g., 0
for always)
end alerting hour
End time for alerts in UTC (e.g., 0
for always)
send report hour
Hour (UTC) to receive daily report (e.g., 13
for 1 PM UTC)
Check your inbox. If it ends up in spam, mark it as "not spam."
If you are sending alerts to a mobile provider email, ( sending an email to your mobile phone number in order to obtain text (SMS/MMS) message alerts ). It is important to make sure your carrier allows the message through to your phone. Some carriers may silently block messages they flag as suspicious. This may require contacting your mobile provider support with a request to allow the emails, and remove any flags as non-nefarious.
If you donโt receive emails:
Confirm your App Password was entered correctly
Ensure your Gmail account is not blocking outbound activity
Double-check that your time zone string matches the official naming convention
Use a secondary email address to confirm if messages are being blocked by your provider
Once configured, your Validator node will monitor its cluster participation status and email you alert messages and daily status reports; helping you stay informed, even when youโre away.
You can use an existing Gmail account or .
Use to look up your exact timezone string (e.g., America/New_York
, Europe/Zurich
).