Update README.md
This commit is contained in:
95
README.md
95
README.md
@@ -1 +1,94 @@
|
|||||||
# pve_status-report
|
## 🏋️ `pve_status_report.sh` – Rapport d’état PVE avec notification Telegram
|
||||||
|
|
||||||
|
Ce script génère un **rapport quotidien complet** de l’état de ton hôte **Proxmox VE (PVE)** ainsi que de toutes ses **VMs (QEMU)** et **CTs (LXC)**. Il envoie le tout directement dans ton **groupe Telegram**, joliment formaté.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### ✅ Fonctionnalités
|
||||||
|
|
||||||
|
- Affiche l’usage **CPU, RAM, disque** et **uptime** de l’hôte
|
||||||
|
- Liste toutes les **VMs et CTs en ligne** avec :
|
||||||
|
- `% CPU` réel (via `ps` pour QEMU, `cpu.stat` pour LXC)
|
||||||
|
- RAM utilisée / allouée
|
||||||
|
- Uptime au format `7j18h` ou `1h32`
|
||||||
|
- Liste les VMs/CTs **hors ligne**
|
||||||
|
- **Compatibilité cgroup v2** pour LXC
|
||||||
|
- Envoie le rapport sur **Telegram** (bot + groupe)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 🛠️ Prérequis
|
||||||
|
|
||||||
|
- Proxmox VE avec `bash`, `awk`, `curl`
|
||||||
|
- Un **bot Telegram** et l’**ID du groupe** dans lequel tu veux envoyer les rapports
|
||||||
|
- Système utilisant **cgroup v2** (cas détecté automatiquement)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 📁 Installation
|
||||||
|
|
||||||
|
1. Place le script ici :
|
||||||
|
```bash
|
||||||
|
/home/scripts/pve_status_report.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Rends-le exécutable :
|
||||||
|
```bash
|
||||||
|
chmod +x /home/scripts/pve_status_report.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Ajoute-le à `crontab` pour une exécution automatique tous les matins à 8h :
|
||||||
|
```bash
|
||||||
|
crontab -e
|
||||||
|
```
|
||||||
|
|
||||||
|
Et ajoute :
|
||||||
|
```cron
|
||||||
|
0 8 * * * /home/scripts/pve_status_report.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### ✏️ Configuration
|
||||||
|
|
||||||
|
Les deux variables suivantes doivent être correctement renseignées en haut du script :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
TELEGRAM_BOT_TOKEN="TON_TOKEN_ICI"
|
||||||
|
TELEGRAM_CHAT_ID="TON_CHAT_ID_ICI"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 📦 Exemple de sortie Telegram
|
||||||
|
|
||||||
|
```text
|
||||||
|
📊 État de PVE [pve] – 2025-04-23 17:10
|
||||||
|
|
||||||
|
🔥 Hôte pve
|
||||||
|
CPU : 2 %
|
||||||
|
Charge moyenne : 2.69, 2.83, 3.06
|
||||||
|
RAM : 76.9 % (7932 Mo / 16384 Mo)
|
||||||
|
Disque : 8 % (32G / 444G)
|
||||||
|
Uptime : 7j19h
|
||||||
|
|
||||||
|
📦 VM & CT :
|
||||||
|
|
||||||
|
🟢 En ligne :
|
||||||
|
🟢 jellyfin 20308096
|
||||||
|
CPU 1.6%, RAM 3817/8192 Mo, Uptime: 7j03h
|
||||||
|
|
||||||
|
🔴 Hors ligne :
|
||||||
|
🔴 kali 101
|
||||||
|
CPU 0%, RAM 0/8192 Mo, Uptime: 0h00
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 🧪 Debug & Astuces
|
||||||
|
|
||||||
|
- Si une valeur CPU LXC est absente ou aberrante, le script force `0%` par défaut
|
||||||
|
- Tu peux exécuter ce script manuellement à tout moment :
|
||||||
|
```bash
|
||||||
|
bash /home/scripts/pve_status_report.sh
|
||||||
|
```
|
||||||
|
|||||||
Reference in New Issue
Block a user