diff --git a/README.md b/README.md index 42ca102..e482a6a 100644 --- a/README.md +++ b/README.md @@ -1,53 +1,104 @@ -

# prtg-linux-service-monitor Ein kleines Bash Script um Linux Services mit dem PRTG Monitor zu überwachen

-
-
-
-
    -
  1. Script installieren
    2. -
-

mkdir -p /temp && cd /temp

-

git clone https://git.media-techport.de/scriptos/prtg-linux-service-monitor.git

-

cd prtg-linux-service-monitor

-

cp prtg-service-mon.sh /home/scripts/default/prtg-service-mon.sh

-

chmod 711 /home/scripts/default/prtg-service-mon.sh

-

 

-
    -
  1. Cronjob einrichten
    2. -
-

cat <(crontab -l) <(echo "*/5 * * * * /home/scripts/default/prtg-service-mon.sh mariadb push.mon01.media-techport.de:5050 b2949934-1f05-40b0-afd8-856ac7e534cd > /dev/null 2>&1") | crontab -

-

Beschreibung für die Parameter hinter dem Befehl:

-

1. ist der Service, welcher überwacht werden soll

-

2. ist der Server, an dem die Push gesendet wird

-

3. ist die GUID zur Identifizierung (der sogenannte Ident, dieser muss für jeden Sensor anders sein)

-

Kann hier generiert werden: https://guidgenerator.com/

-

 

-
    -
  1. Sensor einrichten
    2. -
      -
    1. in PRTG anmelden
      2. -
    2. Server, dessen Service überwacht werden soll, aufrufen
      3. -
    3. Neuen Sensor hinzufügen
      4. -
    -
-

-
    -
  1. Folgende Felder ausfüllen:
    2. -
      -
    1. Name des Sensors: "Service: MariaDB"
      2. -
    2. Einstellungen für SSL: unsicher
      3. -
    3. Port: "5050"
      4. -
    4. Token für Identifikation: Dieser wird aus dem Cronjob übernommen
      5. -
    5. Keine hereinkommenden Daten: Auf "Nach x Minuten auf "Fehler" wechseln" setzen
      6. -
    6. Schwellenwert für Zeit (Minuten): "10"
      7. -
    -
-

 

-

Das ganze könnte dann so aussehen:

-

-

-

 

-Quellen: -

https://kb.paessler.com/en/topic/70771-how-can-i-monitor-and-automatically-restart-a-service-on-a-linux-host https://www.paessler.com/manuals/prtg/http_push_data_advanced_sensor

-
-
-
\ No newline at end of file +

+ + Techniverse Community + +

+ +

PRTG Linux Service Monitor

+ +

+ Ein Bash-Script zur automatischen Überwachung und Neustart von Linux-Diensten mit PRTG Network Monitor +

+ +
+ 🏰 Website + · + 📰 Community + · + 🐘 Mastodon + · + 💬 Support +
+

+ +**prtg-linux-service-monitor** ist ein leichtgewichtiges Bash-Script, das Linux-Dienste mit dem [PRTG Network Monitor](https://www.paessler.com/prtg) überwacht. Es prüft kontinuierlich, ob ein definierter Service läuft, startet ihn bei Ausfall automatisch neu und sendet den Status per HTTP-Push an PRTG. + +### ✨ Features + +- ✅ **Automatische Dienstprüfung** – Prüft in regelmäßigen Intervallen, ob ein Service läuft +- 🔄 **Auto-Restart** – Startet ausgefallene Dienste automatisch neu +- 📡 **PRTG Integration** – Sendet Statusmeldungen per HTTP-Push an PRTG +- ⚡ **Leichtgewichtig** – Kein zusätzlicher Aufwand, nur ein einfaches Bash-Script + +## 📦 Script installieren + +```bash +mkdir -p /temp && cd /temp +git clone https://git.media-techport.de/scriptos/prtg-linux-service-monitor.git +cd prtg-linux-service-monitor +cp prtg-service-mon.sh /home/scripts/default/prtg-service-mon.sh +chmod 711 /home/scripts/default/prtg-service-mon.sh +``` + +## ⏰ Cronjob einrichten + +Füge folgenden Eintrag zur Crontabelle hinzu (z. B. alle 5 Minuten): + +```bash +cat <(crontab -l) <(echo "*/5 * * * * /home/scripts/default/prtg-service-mon.sh mariadb push.mon01.media-techport.de:5050 b2949934-1f05-40b0-afd8-856ac7e534cd > /dev/null 2>&1") | crontab - +``` + +### 🛠 Parameter des Scripts + +| # | Beschreibung | +|---|------| +| 1 | Der Service, welcher überwacht werden soll | +| 2 | Der Server, an dem die Push-Nachricht gesendet wird | +| 3 | Die GUID zur Identifizierung (der sogenannte *Ident*, muss für jeden Sensor eindeutig sein) | + +> 💡 GUIDs können hier generiert werden: https://guidgenerator.com/ + +## 🔧 Sensor einrichten + +### 1️⃣ PRTG Sensor erstellen + +1. In PRTG anmelden +2. Den Server aufrufen, dessen Service überwacht werden soll +3. **Neuen Sensor hinzufügen** + +![Sensor hinzufügen](./assets/img/prtg1.png) + +### 2️⃣ Felder ausfüllen + +| Feld | Wert | +|------|------| +| Name des Sensors | `Service: MariaDB` | +| Einstellungen für SSL | **Unsicher** | +| Port | `5050` | +| Token für Identifikation | Wird aus dem Cronjob übernommen | +| Keine hereinkommenden Daten | **Nach x Minuten auf "Fehler" wechseln** | +| Schwellenwert für Zeit (Minuten) | `10` | + +### 3️⃣ Beispiel + +Das ganze könnte dann so aussehen: + +![Beispiel 1](./assets/img/prtg2.png) + +![Beispiel 2](./assets/img/prtg3.png) + +## 📚 Quellen + +- [KB: How can I monitor and automatically restart a service on a Linux host](https://kb.paessler.com/en/topic/70771-how-can-i-monitor-and-automatically-restart-a-service-on-a-linux-host) +- [PRTG: HTTP Push Data Advanced Sensor](https://www.paessler.com/manuals/prtg/http_push_data_advanced_sensor) + +

+

+ +

+ +

+ + © Patrick Asmus · Techniverse Network · Lizenz + +

diff --git a/assets/img/prtg1.png b/assets/img/prtg1.png new file mode 100644 index 0000000..5263272 Binary files /dev/null and b/assets/img/prtg1.png differ diff --git a/assets/img/prtg2.png b/assets/img/prtg2.png new file mode 100644 index 0000000..cde8d5e Binary files /dev/null and b/assets/img/prtg2.png differ diff --git a/assets/img/prtg3.png b/assets/img/prtg3.png new file mode 100644 index 0000000..f3583a0 Binary files /dev/null and b/assets/img/prtg3.png differ