How to Use Uptime with Telegram

Intro

So you’ve installed Uptime on your new Start9 Personal Server. Great, now what?

Currently, the best and easiest way to use Uptime is to employ the Uptime Telegram Bot to publish status updates to a private channel between you and your Monitoring Buddy. In the near future, you will be able to deliver emails to your Monitoring Buddy over Tor, but not yet.

Since by definition, Uptime is a social concept, the first thing you’ll need to do is find a “monitoring buddy” and forma Telegram Group Chat together.

 

Setting up a Telegram Group Chat

Once you’ve found a Monitoring Buddy, you’ll need to create a Telegram Group Chat with them. Important: It must be a group chat, NOT a direct message. By default the group will be set to private. We recommend you keep it that way. Once you’ve created your group chat, you’ll need to post at least one message inside the group chat before Telegram will assign it a proper ID. It can be anything at all, perhaps just the word “hello”.

Now you need to obtain your Telegram group chat ID. There are a few ways to do this, the easiest of which is to add the @rawdatabot to your group chat. (Adding a bot is just like adding any contact to your group: Do it within the group’s settings page.) As soon as you add the bot to your group it will report information about your Group, including the group ID, into the chat.

chat: {
“id”: -1001345287116,
“title”: “Group Name”,
“type”: “private”
}

Remove the @rawdatabot from your group. You will not need its services anymore.

 

Finally, go ahead and add @start9_uptime_bot to your group as a permanent member.

 

Exchanging Tor Addresses with your Monitoring Buddy

Now you need to exchange Server Tor addresses with your monitoring buddy. Important: DO NOT share your Uptime Tor address. Don’t worry, Uptime Tor addresses are not particularly sensitive; they just aren’t what’s needed to monitor your buddy’s server. You can find your Server Tor address by clicking on your server, then clicking the menu icon in the top right, then clicking “Server Specs”.

 

Configuring Uptime

After you’ve exchanged Server Tor addresses with your monitoring buddy, it’s time to configure your Uptime app. Go to Uptime, then click the menu icon in the top right corner, then click “App Config”.

Once in Config, click “Servers”, then click the plus button in the bottom right of the screen and click “Create”.

Navigate into the Server you just created and fill out the following fields:

  • Name: Your buddy’s name or nickname. Something like “Bill’s Server”.
  • Tor Address: This is your buddy’s Server Tor address from above, NOT your Tor address.
  • Webhook: The details of how Uptime will notify you and your buddy if either of your servers goes offline.

Inside the Webhook option, fill out the following fields:

  • URL: the URL your Uptime App will hit with a POST request with error details. In this case, the URL should be exactly:
https://api.telegram.org/bot997957816:AAFzYZAY0QagkgcI-EYYCfJaJvgUd39Yiik/sendMessage?chat_id=<YOUR GROUP CHAT ID GOES HERE>

Insert your group chat ID into the YOUR GROUP CHAT ID GOES HERE space, and be sure to delete the <> from both ends. So at the end it should look something like chat_id=-10066482199 .

  • Message Parameter: the name of the field containing the error message in the POST body. The default is “message”, but telegram requires it to be “text”. Change the value to “text”.

 

Wrapping Up

Now back out of the App config page-by-page and click “Save” before exiting back to the Uptime App. If Uptime isn’t already running, click “Start”. If all went as expected, you will receive a TEST message to the Telegram group.

And now you’re good to go! You are successfully monitoring the health of your buddy’s server. If it ever goes offline, the Uptime Bot will alert your Telegram group.

Now go tell your monitoring buddy to monitor yours!

 

Matt Hill
CEO

Leave a comment