Constellation Network
IntroductionFundamentalsFor DevelopersNode Validators
  • Index
  • Validator Node Guides
    • ๐Ÿ’ฐDelegated Staking
      • What is delegated staking?โ€‹
      • For Node Operators
      • Understanding Delegated Staking
      • Prerequisites
      • Create Delegated Staking Configuration
      • First Time Configuration
      • Modify Existing Configuration
      • Add/Update Delegating Staking Parameters
      • Update Delegated Staking
      • Duplicate Update
      • Status Command
    • ๐ŸšงBuild Your Node
      • Create Discord Account
      • ๐Ÿ—’๏ธNode Operator Notes
      • โš™๏ธNode Specifications
      • ๐ŸšงGeneric Build a VPS Guide
      • โ˜๏ธCloud Provider Specific
        • ๐ŸšงBuild AWS EC2 Instance
        • ๐ŸšงBuild DigitalOcean Droplet
        • ๐ŸšงBuild Hetzner Server
      • ๐Ÿš‰First Time Connection Guide
      • ๐Ÿ’ฝThe nodectl utility
      • Download nodectl
      • ๐Ÿ—๏ธTurn your VPS into a Node
        • ๐ŸšฉNode Prerequisites
        • ๐Ÿ‡Quick Install Guide
        • ๐ŸŽจNormal Install Guide
        • ๐Ÿ› ๏ธManual Installation
      • ๐Ÿ†Authorize to Join Hypergraph or metagaph
    • ๐Ÿ’ฐCollateralize Your Node
    • 1๏ธโƒฃFirst Time Cluster Connection
    • ๐Ÿ’ซEnable Auto Restart
    • ๐Ÿ“‚Operational Guides
      • โ™ป๏ธRestart Validator Node Guide
      • ๐ŸŽUpgrade Tessellation Quick Start
      • ๐ŸญUpgrade Tessellation Guide
      • ๐Ÿ—๏ธReinstallation Guide
      • โ™ป๏ธBackup/Restore a P12 KeyStore
      • ๐Ÿš‹Migrate V1 to V2 - P12 Keystore
      • ๐Ÿ›ซUpgrade nodectl Version
      • ๐ŸšจAlerting & Reporting Setup Guide
    • ๐Ÿ› ๏ธTroubleshooting Guides
      • ๐Ÿ—๏ธTroubleshoot SSH Connection
      • ๐Ÿ’ฝTroubleshoot nodectl upgrade
      • โ›ฐ๏ธTroubleshoot EdgePointDown Message
      • ๐ŸšจTroubleshoot Node Alerting
  • ๐Ÿ‘‘MainNet
    • MainNet & IntegrationNet Quick Start Guide
    • ๐ŸšงUpgrade Tessellation to v3
    • ๐ŸฆŒMigrate an IntegrationNet Node to MainNet
  • ๐Ÿฅ…IntegrationNet
    • ๐ŸงชIntegrationNet Quick Start Guide
  • Metagraphs
    • ๐ŸšชDor metagraph
      • ๐ŸšชDor Validator Onboard Guide
      • ๐ŸšชUnderstanding Rewards
      • ๐ŸšชTechnical Procedures
        • ๐ŸšชBuild Dor Validator Node
  • ๐Ÿ“šReferences
    • ๐Ÿ“šnodectl Command Reference
    • Firewall Settings Table
    • ๐Ÿ”SSH Remote Access
      • ๐Ÿ”‘Create SSH Keys
      • ๐Ÿ“Upload SSH Public Key
      • ๐Ÿ”Securing SSH Access
      • โ™ป๏ธHow to SSH into VPS
    • ๐ŸดNode Fork Types
    • ๐Ÿ—๏ธP12 Keystore
    • ๐ŸTarball
    • ๐Ÿ’ปVirtual Private Server
  • GitHub nodectl utility
  • Lattice Dashboard
Powered by GitBook

Main

  • Website
  • Get DAG
  • Explore Projects
  • Partners

Socials

  • Telegram
  • Discord
  • X (Twitter)

Tools

  • Wallet
  • DAG Explorer
  • Coingecko

ยฉ 2025 CONSTELLATION NETWORK

On this page
  • Introduction
  • โš ๏ธ Important Limitations
  • Prerequisites
  • Configure Alerting
  • Test Configuration
  • ๐Ÿ› ๏ธ Troubleshooting

Was this helpful?

Export as PDF
  1. Validator Node Guides
  2. Operational Guides

Alerting & Reporting Setup Guide

Monitor Your Validator Node and Receive Email Alerts

PreviousUpgrade nodectl VersionNextTroubleshooting Guides

Last updated 19 days ago

Was this helpful?

Introduction

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).


Contents

โš ๏ธ Important Limitations

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.


Prerequisites

  • 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

This guide will walk you through these steps.


1

Create or Use a Gmail Account

2

Enable Gmail 2-Step Verification

If not already enabled, activate 2-Step Verification via your Google Account:

  • Go to: Manage your Google Account

  • Click the Security tab

  • Follow prompts to enable 2-Step Verification

3

Generate an App Password

  • 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.

4

Determine Your Timezone

Your VPS uses UTC, but you can configure alerting in your local timezone.

Record your timezone string for later.

Do not use shortcuts like EST or CET.

5

Connect to Your Node

ssh -i /path/to/ssh/private/key nodeadmin@<vps_ip_address>
6

Launch the Configurator

sudo nodectl configure -e -cb -d
7

Enter Alerting Setup

N) Setup Alerting

Youโ€™ll be prompted for the following details:

Prompt
Description

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)

8

Exit Configurator

Q)uit

1

Test an Alert

sudo nodectl auto_restart alert_test
2

Handle Spam

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.

3

Test a Daily Report

sudo nodectl auto_restart send_report

You should receive a formatted status report via email.


๐Ÿ› ๏ธ Troubleshooting

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.

Configure Alerting

You can use an existing Gmail account or .

Use to look up your exact timezone string (e.g., America/New_York, Europe/Zurich).

Test Configuration

๐Ÿ“‚
๐Ÿšจ
๐Ÿ–‡๏ธ
๐Ÿต๏ธ
๐Ÿงช
create a new one
this reference list
How to SSH into your Node
Important Limitations
Prerequisites
Configure Alerting
Test Configuration
Troubleshooting