Running a Gensyn AI node means uptime is everything. But what if your node goes down and you don't notice for hours? That's where the latest GSwarm Sidecar update comes in: real-time Telegram alerts when your node goes offline.

Why Node Monitoring Matters

gSwarm is the all-in-one monitoring suite for Gensyn AI nodes, designed to keep your infrastructure healthy and your operations smooth. With the new Down Detector and Telegram alerting, you can rest easy knowing you'll be the first to know if your node stops responding.

How Telegram Down Alerts Work

The GSwarm Sidecar now includes a built-in Down Detector. Here's what it does:

Watches your node's log files for new activity.
If no new log lines appear for a set period (default: 5 minutes), it sends an alert to your Telegram.
No alert spam: You'll only get notified if the node goes down after being up, and you won't get repeated alerts for the same downtime.
Automatic reset: Once your node is back online, the alert state resets, so you'll be notified again if it goes down in the future.

Setting Up Telegram Alerts

It's easy to get started. Just add a telegram section to your configs/config.yaml:

telegram:
  bot_token:    "<your-telegram-bot-token>"   # Get this from @BotFather
  chat_id:      "<your-chat-or-channel-id>"   # Use your user or group/channel ID
  alert_on_down: true                         # Set to true to enable alerts
  down_alert_delay: 900                       # Seconds to wait before alerting (e.g., 300 = 5 minutes)

Tips:

Create a Telegram bot with @BotFather and copy the token.
Get your chat ID from @userinfobot or by adding your bot to a group/channel.
Set alert_on_down to true to enable alerts.
Adjust down_alert_delay to avoid false positives (300 seconds is a good starting point).

What You'll See

When your node goes down, you'll get a message like this:

[gswarm-sidecar] ALERT: Node 'my-node-123' appears DOWN. No log activity for 5m.

No more guessing if your node is healthy—gSwarm has your back.

Best Practices

Make sure your bot can message you or your group/channel.
Set a reasonable delay to avoid unnecessary alerts.
Only one alert is sent per downtime event—no spam.
Alerts won't trigger immediately on startup if the node is already down.

Get Started

Ready to enable Telegram alerts? First, make sure your sidecar is set up and running. If you haven't installed the GSwarm Sidecar yet, check out our step-by-step setup guide to get started.

For more help, open an issue or check the main README.

💬 Chat with the AI — Have questions? Get instant help from GSwarm Chat AI.

Stay in the loop, keep your Gensyn node online, and let GSwarm do the monitoring for you!

Never Miss a Beat: Telegram Down Alerts for Your Gensyn Node with GSwarm Sidecar