Skip to main content

Alerts overview

nomctl can message you on Telegram when the node needs attention, and again when it recovers.

All operators share one bot; each operator only sees alerts for the nodes they paired. The bot token lives on a small relay service, never on your node. Your node signs every report with a secret created at pairing, and the relay forwards it to your chat only.

node (nomctl-alerts.service)  ──HTTPS, signed──▶  relay (alerts.zenon.info)  ──Bot API──▶  Telegram

What you get​

  • A message when something goes wrong and a matching message when it recovers.
  • A reminder every 10 minutes while a problem persists, unless you mute it.
  • A node silent alert from the relay when the whole machine stops reporting, which the node itself could never send.
  • Per-alert thresholds and switches on the node, mutes from Telegram.

The three steps​

  1. Send /start to the bot and get a pairing code.
  2. Run sudo nomctl alerts setup on the node.
  3. Read the test message in your chat.

Details in Pairing, the full list of alerts in Rules, the chat commands in Telegram commands, and how to run your own relay in Relay.

Privacy​

The relay stores your chat id, the node name and host name, the last heartbeat summary (sync state, height, peers, restarts), mutes, and when each alert was last sent. Alert text is forwarded, not stored. The relay never sends anything to a node. Unpairing from either side invalidates the node's secret immediately.