first commit
This commit is contained in:
+176
@@ -0,0 +1,176 @@
|
|||||||
|
|
||||||
|
# VPN Monitoring Script
|
||||||
|
|
||||||
|
## **Überblick**
|
||||||
|
|
||||||
|
Dieses Projekt implementiert ein flexibles und robustes VPN-Überwachungsskript, das den Netzwerkverkehr und die VPN-Funktionalität überprüft. Das Skript bietet zeitabhängige Prüfungen und die Möglichkeit, bei Erkennung von Problemen den VPN-Dienst automatisch neu zu starten. Das Skript wurde modular aufgebaut, um die Wartbarkeit und Erweiterbarkeit zu verbessern.
|
||||||
|
|
||||||
|
## **Funktionen**
|
||||||
|
|
||||||
|
1. **Netzwerkverkehrsprüfung**:
|
||||||
|
- Misst den eingehenden und ausgehenden Netzwerkverkehr eines bestimmten Netzwerkinterfaces.
|
||||||
|
- Verwendet Schwellenwerte zur Bewertung der Verbindung.
|
||||||
|
- Automatischer Dienstneustart bei Abweichung von Schwellwerten.
|
||||||
|
|
||||||
|
2. **SQL-basierte Aktivitätsprüfung** (außerhalb der Hauptarbeitszeit):
|
||||||
|
- Überprüft die Datenbank auf Aktivitäten, die durch spezifische Benutzer oder Dienste ausgelöst wurden.
|
||||||
|
- Erkennt inaktive Verbindungen und leitet notwendige Schritte ein.
|
||||||
|
|
||||||
|
3. **Automatischer Neustart des VPN-Dienstes**:
|
||||||
|
- Führt einen Dienstneustart remote über SSH aus.
|
||||||
|
- Überprüft die Funktionalität nach dem Neustart.
|
||||||
|
|
||||||
|
4. **Detailliertes Logging**:
|
||||||
|
- JSON-basiertes Logging für maschinenlesbare und gut strukturierte Ausgaben.
|
||||||
|
- Logrotation zum Schutz vor übermäßigem Speicherverbrauch.
|
||||||
|
|
||||||
|
5. **Konfigurierbarkeit**:
|
||||||
|
- Anpassbare Zeitfenster, Schwellenwerte, Datenbankeinstellungen und SSH-Verbindungsdetails.
|
||||||
|
- Modularer Aufbau für einfache Anpassungen und Erweiterungen.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **Installationsanleitung**
|
||||||
|
|
||||||
|
### **Systemanforderungen**
|
||||||
|
- Betriebssystem: Linux (z. B. Ubuntu, Debian, CentOS)
|
||||||
|
- Pakete:
|
||||||
|
- `ifstat`
|
||||||
|
- `mysql-client`
|
||||||
|
- `openssh-client`
|
||||||
|
- `logrotate`
|
||||||
|
- `bc` (für Gleitkommaoperationen)
|
||||||
|
|
||||||
|
### **Installation**
|
||||||
|
1. Klone das Repository oder kopiere die Skriptdateien auf deinen Server:
|
||||||
|
```bash
|
||||||
|
git clone <repository-url>
|
||||||
|
cd vpn-monitor
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Stelle sicher, dass die erforderlichen Pakete installiert sind:
|
||||||
|
```bash
|
||||||
|
sudo apt update
|
||||||
|
sudo apt install ifstat mysql-client openssh-client logrotate bc
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Konfiguriere die Berechtigungen:
|
||||||
|
```bash
|
||||||
|
chmod +x vpn_monitor.sh
|
||||||
|
chmod +x functions/*.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
4. Passe die `config.conf` Datei an:
|
||||||
|
- Definiere Netzwerkinterface, Schwellenwerte, Datenbankeinstellungen, SSH-Details und Logdateipfad.
|
||||||
|
|
||||||
|
5. (Optional) Füge die Logrotation hinzu:
|
||||||
|
- Kopiere die Datei `logrotate/vpn_monitor` nach `/etc/logrotate.d/`:
|
||||||
|
```bash
|
||||||
|
sudo cp logrotate/vpn_monitor /etc/logrotate.d/
|
||||||
|
```
|
||||||
|
|
||||||
|
6. Plane das Skript mit Cron:
|
||||||
|
- Öffne den Cron-Editor:
|
||||||
|
```bash
|
||||||
|
crontab -e
|
||||||
|
```
|
||||||
|
- Füge den Eintrag hinzu, um das Skript regelmäßig auszuführen:
|
||||||
|
```bash
|
||||||
|
*/5 * * * * /path/to/vpn_monitor.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **Nutzung**
|
||||||
|
|
||||||
|
### **Konfiguration**
|
||||||
|
|
||||||
|
Die Einstellungen werden in der Datei `config.conf` vorgenommen. Nachfolgend eine Übersicht der wichtigsten Parameter:
|
||||||
|
|
||||||
|
| Parameter | Beschreibung | Standardwert |
|
||||||
|
|----------------------|-----------------------------------------------------------|-----------------------|
|
||||||
|
| `INTERFACE` | Netzwerkinterface zur Überwachung | `ens19` |
|
||||||
|
| `LOG_FILE` | Pfad zur Logdatei | `/var/log/vpn_monitor.log` |
|
||||||
|
| `THRESHOLD_INBOUND` | Schwellenwert für eingehenden Verkehr (KB/s) | `0.5` |
|
||||||
|
| `THRESHOLD_OUTBOUND` | Schwellenwert für ausgehenden Verkehr (KB/s) | `0.5` |
|
||||||
|
| `MEASUREMENT_COUNT` | Anzahl der Messzyklen | `10` |
|
||||||
|
| `INTERVAL` | Intervall zwischen Messungen (Sekunden) | `6` |
|
||||||
|
| `DB_USER` | Benutzername für die Datenbank | `username` |
|
||||||
|
| `DB_PASSWORD` | Passwort für die Datenbank | `password` |
|
||||||
|
| `DB_NAME` | Name der Datenbank | `database` |
|
||||||
|
| `SSH_KEY` | Pfad zur SSH-Schlüsseldatei | `/path/to/private_key`|
|
||||||
|
| `SSH_USER` | Benutzername für SSH | `user` |
|
||||||
|
| `SSH_HOST` | Hostname oder IP der SSH-Verbindung | `remote_host` |
|
||||||
|
| `SERVICE_NAME` | Name des zu überprüfenden Dienstes | `ipsec.service` |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### **Ablauf**
|
||||||
|
|
||||||
|
#### **Innerhalb der Hauptarbeitszeit (07:00-18:00 Uhr)**
|
||||||
|
- Misst eingehenden und ausgehenden Netzwerkverkehr.
|
||||||
|
- Vergleicht die Durchschnittswerte mit den definierten Schwellenwerten.
|
||||||
|
- Protokolliert den Status.
|
||||||
|
- Führt bei Bedarf einen Neustart des VPN-Dienstes aus.
|
||||||
|
|
||||||
|
#### **Außerhalb der Hauptarbeitszeit (18:00-07:00 Uhr)**
|
||||||
|
- Überprüft SQL-Aktivitäten:
|
||||||
|
- Letzter Eintrag eines bestimmten Benutzers.
|
||||||
|
- Letzter Eintrag eines spezifischen Dienstes im Log.
|
||||||
|
- Leitet einen Neustart ein, wenn Aktivitätskriterien nicht erfüllt sind.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **Fehlerbehandlung**
|
||||||
|
|
||||||
|
Das Skript behandelt potenzielle Fehler folgendermaßen:
|
||||||
|
1. **Netzwerkfehler**:
|
||||||
|
- Kein Output von `ifstat`: Meldet einen Fehler und bricht ab.
|
||||||
|
2. **SQL-Verbindungsfehler**:
|
||||||
|
- Fehlschlagende SQL-Abfragen werden geloggt und führen zum Abbruch.
|
||||||
|
3. **SSH-Fehler**:
|
||||||
|
- Fehler beim Neustart des Dienstes werden detailliert protokolliert.
|
||||||
|
4. **Dienstprüfung**:
|
||||||
|
- Nach Neustart überprüft `ipsec statusall` den Dienststatus. Fehlerhafte Zustände führen zur Eskalation.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **Logging**
|
||||||
|
|
||||||
|
- Logs werden standardmäßig unter `/var/log/vpn_monitor.log` gespeichert.
|
||||||
|
- JSON-Format für maschinenlesbare Logs.
|
||||||
|
- Beispiel eines Logeintrags:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"timestamp": "2024-11-28 12:45:00",
|
||||||
|
"level": "INFO",
|
||||||
|
"message": "Network traffic is above thresholds. Avg In: 0.6 KB/s, Avg Out: 0.7 KB/s."
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **Erweiterungsideen**
|
||||||
|
|
||||||
|
1. **Benachrichtigungssystem**:
|
||||||
|
- Integration eines E-Mail- oder Push-Benachrichtigungssystems bei Eskalationen.
|
||||||
|
2. **Multithreading**:
|
||||||
|
- Parallele Prüfung mehrerer Netzwerkinterfaces oder SQL-Datenbanken.
|
||||||
|
3. **Web-Dashboard**:
|
||||||
|
- Echtzeit-Monitoring und Visualisierung der Logs über eine Weboberfläche.
|
||||||
|
4. **Externe API-Integration**:
|
||||||
|
- Verknüpfung mit Monitoring-Tools wie Zabbix oder Prometheus.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **Autoren**
|
||||||
|
|
||||||
|
- **Dein Name**
|
||||||
|
E-Mail: [[email protected]](mailto:[email protected])
|
||||||
|
GitHub: [DeinGitHub](https://github.com/DeinGitHub)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **Lizenz**
|
||||||
|
|
||||||
|
Dieses Projekt steht unter der MIT-Lizenz. Weitere Informationen findest du in der Datei `LICENSE`.
|
||||||
@@ -0,0 +1,26 @@
|
|||||||
|
# Netzwerkinterface
|
||||||
|
INTERFACE="ens19"
|
||||||
|
|
||||||
|
# Log-Datei
|
||||||
|
LOG_FILE="/var/log/vpn_monitor.log"
|
||||||
|
|
||||||
|
# Schwellwerte
|
||||||
|
THRESHOLD_INBOUND=0.5
|
||||||
|
THRESHOLD_OUTBOUND=0.5
|
||||||
|
|
||||||
|
# Messparameter
|
||||||
|
MEASUREMENT_COUNT=10
|
||||||
|
INTERVAL=6
|
||||||
|
|
||||||
|
# SQL-Datenbankverbindung
|
||||||
|
DB_USER="username"
|
||||||
|
DB_PASSWORD="password"
|
||||||
|
DB_NAME="database"
|
||||||
|
|
||||||
|
# SSH-Verbindung
|
||||||
|
SSH_KEY="/path/to/private_key"
|
||||||
|
SSH_USER="user"
|
||||||
|
SSH_HOST="remote_host"
|
||||||
|
|
||||||
|
# Dienstname für Neustart
|
||||||
|
SERVICE_NAME="ipsec.service"
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
function log_info() {
|
||||||
|
echo "{\"timestamp\": \"$(date)\", \"level\": \"INFO\", \"message\": \"$1\"}" >> $LOG_FILE
|
||||||
|
}
|
||||||
|
|
||||||
|
function log_error() {
|
||||||
|
echo "{\"timestamp\": \"$(date)\", \"level\": \"ERROR\", \"message\": \"$1\"}" >> $LOG_FILE
|
||||||
|
}
|
||||||
|
|
||||||
|
function log_critical() {
|
||||||
|
echo "{\"timestamp\": \"$(date)\", \"level\": \"CRITICAL\", \"message\": \"$1\"}" >> $LOG_FILE
|
||||||
|
}
|
||||||
@@ -0,0 +1,31 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
function check_network_traffic() {
|
||||||
|
total_inbound=0
|
||||||
|
total_outbound=0
|
||||||
|
|
||||||
|
for ((i=1; i<=$MEASUREMENT_COUNT; i++)); do
|
||||||
|
usage=$(ifstat -i $INTERFACE $INTERVAL 1 | tail -n 1)
|
||||||
|
|
||||||
|
if [[ -z "$usage" ]]; then
|
||||||
|
log_error "No output from ifstat on measurement $i."
|
||||||
|
exit 2
|
||||||
|
fi
|
||||||
|
|
||||||
|
inbound=$(echo $usage | awk '{print $1}')
|
||||||
|
outbound=$(echo $usage | awk '{print $2}')
|
||||||
|
|
||||||
|
total_inbound=$(echo "$total_inbound + $inbound" | bc)
|
||||||
|
total_outbound=$(echo "$total_outbound + $outbound" | bc)
|
||||||
|
done
|
||||||
|
|
||||||
|
avg_inbound=$(echo "scale=2; $total_inbound / $MEASUREMENT_COUNT" | bc)
|
||||||
|
avg_outbound=$(echo "scale=2; $total_outbound / $MEASUREMENT_COUNT" | bc)
|
||||||
|
|
||||||
|
if (( $(echo "$avg_inbound < $THRESHOLD_INBOUND" | bc -l) )) || (( $(echo "$avg_outbound < $THRESHOLD_OUTBOUND" | bc -l) )); then
|
||||||
|
log_critical "Network traffic below thresholds. Avg In: $avg_inbound KB/s, Avg Out: $avg_outbound KB/s."
|
||||||
|
restart_service
|
||||||
|
else
|
||||||
|
log_info "Network traffic is above thresholds. Avg In: $avg_inbound KB/s, Avg Out: $avg_outbound KB/s."
|
||||||
|
fi
|
||||||
|
}
|
||||||
@@ -0,0 +1,19 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
function restart_service() {
|
||||||
|
log_info "Attempting to restart service $SERVICE_NAME on $SSH_HOST."
|
||||||
|
|
||||||
|
ssh -i $SSH_KEY $SSH_USER@$SSH_HOST "sudo systemctl restart $SERVICE_NAME"
|
||||||
|
if [ $? -ne 0 ]; then
|
||||||
|
log_error "Failed to restart service $SERVICE_NAME on $SSH_HOST."
|
||||||
|
exit 2
|
||||||
|
fi
|
||||||
|
|
||||||
|
ssh -i $SSH_KEY $SSH_USER@$SSH_HOST "sudo ipsec statusall | grep -i 'running'"
|
||||||
|
if [ $? -ne 0 ]; then
|
||||||
|
log_critical "Service $SERVICE_NAME not running after restart."
|
||||||
|
exit 2
|
||||||
|
fi
|
||||||
|
|
||||||
|
log_info "Service $SERVICE_NAME successfully restarted and verified."
|
||||||
|
}
|
||||||
@@ -0,0 +1,25 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
function check_sql_activity() {
|
||||||
|
last_order_time=$(mysql -u $DB_USER -p$DB_PASSWORD -D $DB_NAME -sse \
|
||||||
|
"SELECT MAX(create_time) FROM otrs_ticket WHERE create_user = 'LIDLWebservice';")
|
||||||
|
|
||||||
|
last_bsi_log_time=$(mysql -u $DB_USER -p$DB_PASSWORD -D $DB_NAME -sse \
|
||||||
|
"SELECT MAX(log_time) FROM bsi_logs WHERE service = 'ITNovumBSIConnector';")
|
||||||
|
|
||||||
|
if [[ -z "$last_order_time" || -z "$last_bsi_log_time" ]]; then
|
||||||
|
log_error "SQL query failed or returned no data."
|
||||||
|
exit 2
|
||||||
|
fi
|
||||||
|
|
||||||
|
now=$(date +%s)
|
||||||
|
last_order_epoch=$(date -d "$last_order_time" +%s)
|
||||||
|
last_bsi_epoch=$(date -d "$last_bsi_log_time" +%s)
|
||||||
|
|
||||||
|
if (( (now - last_order_epoch) > 3600 && (now - last_bsi_epoch) > 7200 )); then
|
||||||
|
log_critical "SQL activity check failed. No activity in expected timeframes."
|
||||||
|
restart_service
|
||||||
|
else
|
||||||
|
log_info "SQL activity is within acceptable limits."
|
||||||
|
fi
|
||||||
|
}
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
# Speichern unter /etc/logrotate.d/vpn_monitor
|
||||||
|
/var/log/vpn_monitor.log {
|
||||||
|
daily
|
||||||
|
missingok
|
||||||
|
rotate 7
|
||||||
|
compress
|
||||||
|
delaycompress
|
||||||
|
notifempty
|
||||||
|
create 640 root root
|
||||||
|
}
|
||||||
@@ -0,0 +1,33 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
# Source Konfigurations- und Modul-Dateien
|
||||||
|
source config.conf
|
||||||
|
source functions/logging.sh
|
||||||
|
source functions/network_check.sh
|
||||||
|
source functions/sql_check.sh
|
||||||
|
source functions/restart_service.sh
|
||||||
|
|
||||||
|
# Funktion zur Prüfung der Arbeitszeit
|
||||||
|
function is_within_business_hours() {
|
||||||
|
current_hour=$(date +%H)
|
||||||
|
if (( current_hour >= 7 && current_hour < 18 )); then
|
||||||
|
return 0 # True
|
||||||
|
else
|
||||||
|
return 1 # False
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# Hauptlogik
|
||||||
|
function main() {
|
||||||
|
log_info "Starting VPN monitoring script."
|
||||||
|
|
||||||
|
if is_within_business_hours; then
|
||||||
|
log_info "Within business hours. Running network check."
|
||||||
|
check_network_traffic
|
||||||
|
else
|
||||||
|
log_info "Outside business hours. Running SQL activity check."
|
||||||
|
check_sql_activity
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
main
|
||||||
Reference in New Issue
Block a user