TeleMonitor

July 30, 2024 · View on GitHub

TeleMonitor is a system monitoring tool written in Python that can monitor CPU, memory, and disk usage and send alerts via Telegram.

Usage

First, you need to create a Telegram bot and get the API token. You can refer to the Telegram official documentation to create a Telegram bot.

Then, you need to get the Telegram chat ID where you want to receive alerts. You can use @userinfobot to get your chat ID.

Next, clone this project:

git clone https://github.com/bboysoulcn/telemonitor.git

You can use docker compose to run TeleMonitor:

docker-compose up -d

Or you can use k8s to run TeleMonitor:

kubectl apply -f deployment.yaml

Here are the environment variables for TeleMonitor:

TG_API_TOKEN: The API token of your Telegram bot.
TG_CHAT_ID: The Telegram chat ID where you want to receive alerts.
TG_API_BASE_URL: The base URL of the Telegram API, default is https://api.telegram.org.
CPU_PERCENT: The threshold for CPU usage. TeleMonitor will send an alert if the usage exceeds this value. Default is 80.
MEMORY_PERCENT: The threshold for memory usage. TeleMonitor will send an alert if the usage exceeds this value. Default is 80.
DISK_PERCENT: The threshold for disk usage. TeleMonitor will send an alert if the usage exceeds this value. Default is 80.
MONITOR_INTERVAL: The interval time (in seconds) for monitoring. Default is 60.
DISK_PATH: The path of the disk. Default is /host.
URL_LIST: The list of URLs to monitor, separated by commas. Default is empty.
LANGUAGE: The language. Default is en. Options are en and cn.

Here are the commands for the bot:

You can use the following project to create an API proxy and modify the environment variable TG_API_BASE_URL:

This project is licensed under the MIT License. See the LICENSE file for details.