Metadata-Version: 2.4
Name: yoopi-sentinel
Version: 0.1.1
Summary: Honest, lightweight server monitoring with Telegram alerts
Home-page: https://github.com/mjid8/yoopi-sentinel
Author: Majid
Author-email: majidbenaboud@gmail.com
License: GPL-3.0-or-later
Keywords: monitoring telegram server infrastructure devops
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Systems Administration
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Developers
Classifier: Environment :: No Input/Output (Daemon)
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: click>=8.0.0
Provides-Extra: docker
Requires-Dist: docker>=6.0.0; extra == "docker"
Provides-Extra: postgresql
Requires-Dist: psycopg2-binary>=2.9.0; extra == "postgresql"
Provides-Extra: mysql
Requires-Dist: pymysql>=1.0.0; extra == "mysql"
Provides-Extra: redis
Requires-Dist: redis>=4.0.0; extra == "redis"
Provides-Extra: full
Requires-Dist: docker>=6.0.0; extra == "full"
Requires-Dist: psycopg2-binary>=2.9.0; extra == "full"
Requires-Dist: pymysql>=1.0.0; extra == "full"
Requires-Dist: redis>=4.0.0; extra == "full"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# yoopi sentinel ☀️

lightweight server monitoring that sends alerts straight to your telegram
built this for fun and to learn — ended up actually using it in production

---

## why i made this

- prometheus and grafana take forever to set up
- datadog costs money every month
- most tools spam false alerts or go silent when something actually breaks
- wanted something simple i could install in 2 minutes and forget about

---

## what it monitors

system — cpu ram disk temperature network connections uptime

optional — docker containers postgresql mysql redis

services — any http or https endpoint you want to check

custom — run any script and alert if it fails

---

## install

requires python 3 on your server

```bash
pip install yoopi-sentinel --break-system-packages
sentinel init
```

or if you want one command that handles everything including python check

```bash
curl -sSL https://raw.githubusercontent.com/mjid8/yoopi-sentinel/main/install.sh | bash
```

---

## what the wizard does

- asks your server name and telegram bot token
- auto detects your chat id — no manual lookup
- asks what is running on this server
- installs required extras automatically
- sets up systemd service so it runs forever in background

---

## after install

```bash
systemctl status sentinel       # is it running
journalctl -u sentinel -f       # live logs
sentinel update                 # pull latest version
```

---

## telegram commands

/status   full server report — ram disk cpu uptime processes
/top      top 10 processes by cpu and ram
/disk     disk usage breakdown
/net      network connections and ports
/help     all commands

reconfigure anytime with sentinel init

---

## the never lie system

most monitoring tools go silent when network drops or send false alerts from 10 second spikes

sentinel checks twice before alerting — if cpu hits 90% for 10 seconds and recovers it wont wake you up

if network drops it buffers all alerts locally and sends a summary when connection comes back

every status shows how fresh the data is so you always know if youre looking at current info

---

## os support

| os | tested |
|---|---|
| ubuntu 20 22 24 | ✅ |
| debian 11 12 | ✅ |
| centos 8 rocky 9 | ✅ |
| fedora 38+ | ✅ |
| alpine | ✅ |
| raspberry pi | ✅ |

---

## roadmap

- [x] cpu ram disk temperature network
- [x] docker postgresql mysql redis
- [x] double verification no false alarms
- [x] offline detection missed alerts summary
- [x] systemd auto setup
- [x] pip install from pypi
- [ ] sentinel-watch external watchdog
- [ ] kubernetes
- [ ] mongodb
- [ ] slack discord email alerts

---

## about

built by majid as a learning project that got serious
[yoopi technologies](https://yoopitech.com) — gpl v3

leave a ⭐ if it helped and open an issue if something breaks
