Skip to content
This repository has been archived by the owner on Jun 19, 2024. It is now read-only.

cyrilschreiber3/Better-Uptime-Bot

Repository files navigation

Better Uptime Bot

Better Uptime is a monitoring service for websites, cronjobs, etc. It works great, but with the free version I can only receive notifications via emails which is anoying. Since I'm in the process of learning Python, I thought I might as well code something useful.

So here is the plan: I connected the program to my email account, and when it receives a new mail from Better Uptime, it downloads that email, filters all the informarmations and store it in a database. Then a discord bot notifies me of the alert in a channel in my personnal server.

Installation

  1. In your mail inbox, create a rule that moves all emails from [email protected] to a specific folder
  2. Create a Discord Application here
  3. Create a bot for your Application
  4. Add it to your server with the required permissions (Read Messages/View Channels, Send Messages, Manage Messages)
  5. Download the docker-compose.yml and .env.example files from the root of the repo
  6. Rename .env.example to .env and fill in the variables
  7. Deploy your stack with docker compose up -d
  8. Done ! Now the bot will notify you for every incident

Logs

10/03/2022 - New commands and old messages cleanup feature

I said in my first log that I planned to implement a message cleanup feature, and here it is ! Basically, every time the loop runs it checks all the alert messages and deletes the ones that are more than 30 days old, except if the incident isn't resolved. Also, I added some commands to start and stop the loop and to shut down the bot completely. Maybe in the future I will find more commands ideas.

07/03/2022 - New IMAP library and new status feature

Today, I realized that the library I used to communicate with the IMAP server needed a license after a 30 days trial. When I saw that the license was almost $300 per year, I decided to use another library. I tested multiple ones and settled on imap_tools which is a sort of "interface" with the imaplib integrated in Python that simplifies the configuration.

I also added the status feature I talked about in the last update.

04/03/2022 - The bot works !

I connected all the different modules that I developed separately up until now and everything works ! Unfortunately, I couldn't use my first idea where I edit the original alert message into a resolution message, as I wouldn't be able to get notified again. So to work around that, the bot replies to the alert message with a separate resolution message and links it in the alert message (and changes the alert message color to orange). As this is going to significantly add clutter in the discord channel, so I'm thinking of adding a function that checks for old, resolved alert messages, and delete them.

But first I want to implement a status feature. So when an incident is ongoing, the status of the bot changes to red (do not disturb) and a text under his name shows "Ongoing incident" or something like that.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages