V1.0 de GameurBot (Metrics surveillance des perfs)
This commit is contained in:
commit
cd99ed12eb
14 changed files with 1248 additions and 0 deletions
192
README.md
Normal file
192
README.md
Normal file
|
|
@ -0,0 +1,192 @@
|
|||
# 🖥️ Discord Status Bot
|
||||
|
||||
Bot Discord de monitoring serveur en temps réel.
|
||||
Affiche et met à jour automatiquement un message épinglé dans chaque serveur Discord
|
||||
avec l'état des ressources, la cause des ralentissements, et une ETA de retour à la normale.
|
||||
|
||||
---
|
||||
|
||||
## Architecture
|
||||
|
||||
```
|
||||
[Serveur de jeux] [n'importe où]
|
||||
agent.py ──── HTTP POST ────▶ bot.py
|
||||
(psutil) /metrics ├── serveur aiohttp (port 8765)
|
||||
├── StatusEngine (analyse)
|
||||
└── discord.py (mise à jour embed épinglé)
|
||||
│
|
||||
┌─────────┼─────────┐
|
||||
Guilde 1 Guilde 2 Guilde 3 ...
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Installation
|
||||
|
||||
### 1. Dépendances
|
||||
|
||||
```bash
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
### 2. Configuration
|
||||
|
||||
```bash
|
||||
cp config.example.json config.json
|
||||
```
|
||||
|
||||
Remplis `config.json` :
|
||||
|
||||
| Clé | Description |
|
||||
|-----------------|--------------------------------------------------------------------|
|
||||
| `discord_token` | Token de ton bot (https://discord.com/developers/applications) |
|
||||
| `api_secret` | Mot de passe partagé entre le bot et l'agent (chaîne aléatoire) |
|
||||
| `api_port` | Port HTTP du bot (défaut : 8765) |
|
||||
|
||||
> ⚠️ Le même `api_secret` doit être renseigné dans `agent.py` (`API_SECRET`) et dans `config.json`.
|
||||
|
||||
### 3. Adapter l'agent
|
||||
|
||||
Dans `agent.py`, modifie :
|
||||
|
||||
```python
|
||||
BOT_API_URL = "http://ADRESSE_DU_BOT:8765/metrics"
|
||||
API_SECRET = "le_meme_secret_que_dans_config.json"
|
||||
```
|
||||
|
||||
Si le bot et l'agent tournent sur la même machine, laisse `http://localhost:8765/metrics`.
|
||||
|
||||
Si le bot est sur une autre machine (VPS dédié Discord), utilise son IP/domaine.
|
||||
|
||||
### 4. Ajouter les mots-clés de tes services
|
||||
|
||||
Dans `agent.py`, `SERVICE_KEYWORDS` :
|
||||
|
||||
```python
|
||||
SERVICE_KEYWORDS = {
|
||||
"minecraft": ["java", "minecraft", "paper"],
|
||||
"satisfactory": ["factoryserver"],
|
||||
"ollama": ["ollama"],
|
||||
# Ajoute tes propres services ici
|
||||
"mon_jeu": ["mon_process_name"],
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Lancement
|
||||
|
||||
### Bot (à lancer en premier)
|
||||
|
||||
```bash
|
||||
python bot.py
|
||||
```
|
||||
|
||||
Ou en service systemd :
|
||||
|
||||
```ini
|
||||
[Unit]
|
||||
Description=Discord Status Bot
|
||||
After=network.target
|
||||
|
||||
[Service]
|
||||
WorkingDirectory=/chemin/vers/discord-status-bot
|
||||
ExecStart=/usr/bin/python3 bot.py
|
||||
Restart=always
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
```
|
||||
|
||||
### Agent (sur le serveur de jeux)
|
||||
|
||||
```bash
|
||||
python agent.py
|
||||
```
|
||||
|
||||
Idem, peut être lancé en service systemd.
|
||||
|
||||
---
|
||||
|
||||
## Configuration Discord
|
||||
|
||||
### Créer le bot Discord
|
||||
|
||||
1. Aller sur https://discord.com/developers/applications
|
||||
2. **New Application** → donne-lui un nom
|
||||
3. Onglet **Bot** → **Reset Token** → copier le token dans `config.json`
|
||||
4. Activer **Server Members Intent** et **Message Content Intent** si nécessaire
|
||||
5. Onglet **OAuth2 > URL Generator** :
|
||||
- Scopes : `bot`, `applications.commands`
|
||||
- Bot Permissions : `Send Messages`, `Manage Messages`, `Embed Links`, `Read Message History`
|
||||
6. Copier l'URL générée et l'ouvrir pour inviter le bot sur tes serveurs
|
||||
|
||||
### Configurer chaque serveur Discord
|
||||
|
||||
Une fois le bot invité sur un serveur et lancé localement :
|
||||
|
||||
1. Va dans le salon où tu veux le tableau de bord
|
||||
2. Tape `/setup`
|
||||
3. Le bot envoie et épingle le premier message de statut
|
||||
4. Répète sur chaque serveur Discord
|
||||
|
||||
---
|
||||
|
||||
## Commandes slash disponibles
|
||||
|
||||
| Commande | Description | Permissions |
|
||||
|--------------|--------------------------------------------------|-------------|
|
||||
| `/status` | Affiche l'état actuel (message éphémère) | Tous |
|
||||
| `/services` | Détail de chaque service détecté | Tous |
|
||||
| `/setup` | Configure le salon actuel comme tableau de bord | Admin |
|
||||
|
||||
---
|
||||
|
||||
## Personnalisation
|
||||
|
||||
### Seuils d'alerte
|
||||
|
||||
Dans `status_engine.py`, modifie `THRESHOLDS` :
|
||||
|
||||
```python
|
||||
THRESHOLDS = {
|
||||
"cpu": {"warning": 70, "critical": 85},
|
||||
"ram": {"warning": 80, "critical": 90},
|
||||
"swap": {"warning": 40, "critical": 70},
|
||||
}
|
||||
```
|
||||
|
||||
### Fréquence de mise à jour
|
||||
|
||||
- **Agent** → `PUSH_INTERVAL` dans `agent.py` (défaut : 15s)
|
||||
- **Bot** → `@tasks.loop(seconds=20)` dans `bot.py`
|
||||
|
||||
---
|
||||
|
||||
## Exemple de rendu
|
||||
|
||||
```
|
||||
🔴 Serveur — Surchargé
|
||||
|
||||
📊 Ressources
|
||||
CPU ████████░░ 82% 🌡️ 74°C
|
||||
RAM █████████░ 91% (14.6/16.0 GB)
|
||||
SWAP ████░░░░░░ 43%
|
||||
|
||||
📈 Charge (1m / 5m / 15m) : 7.42 / 6.80 / 5.12
|
||||
|
||||
🎮 Services actifs
|
||||
▸ ⛏️ Minecraft 🔥 — CPU 45% | RAM 4.2 GB
|
||||
▸ 🤖 Ollama (IA) 🔥 — CPU 38% | RAM 8.1 GB
|
||||
▸ 🏭 Satisfactory ⚡ — CPU 12% | RAM 2.1 GB
|
||||
|
||||
🔍 Pourquoi ça rame ?
|
||||
• CPU à 82% — principal consommateur : Minecraft (45%)
|
||||
• RAM à 91% (14.6/16.0 GB) — Ollama (IA) occupe 8.1 GB
|
||||
• 💡 Conflit probable : Ollama (IA) et Minecraft, Satisfactory se partagent les ressources
|
||||
|
||||
⏱️ Retour à la normale
|
||||
⏱️ Retour à la normale dans ~8 min
|
||||
|
||||
Dernière mise à jour 26/02/2026 21:34
|
||||
```
|
||||
Loading…
Add table
Add a link
Reference in a new issue