Beim Basteln eines Mailflow-Testers stand ich erstmalig vor dem Rätsel, eine Mail über einen oder mehrere MTAs zu versenden, die unbedingt auf eine Authentifizierung bestehen. Auskommen wollte ich mit einem einzigen Script, ganz ohne irgendetwas am System einstellen- oder verändern zu müssen.
Hier nun los resultados mit einigen Erklärungen zu den Basics…
Weiterlesen
Changelog
Die Collage enthält neben täglicher und monatlicher Daten auch eine Zusammenfassung sowie eine „Top 10“.
Für jedes Interface wird eine eigene E-Mail mit dem Betreff „Traffic Report, Interface X – Datum“ versendet.
Hierbei gehe ich von einem bereits konfigurierten Mail-System aus.
Getestet habe ich auf einem Ubuntu Server LTS sowie Debian Stable.
Folgende Abhängigkeiten sind notwendig.
1 | sudo apt-get install vnstati sharutils mailutils imagemagick |
„vnstati“ erzeugt für „vnstat“ die Grafiken. Auch in der Command-Line ist „vnstat“ ein nützliches Tool, um Datenverbrauch zu analysieren: „man vnstat“.
„imagemagick“ beeinhaltet das Paket „montage“ für die spätere Zusammenfassung der von „vnstati“ erzeugten Bilder.
„mailutils“ und „sharutils“ werden für den Versand der Übersicht als Anhang benötigt.
Zuerst das Standard-Interface und die Bandbreite in der Konfiguration von „vnstat“ festlegen:
1 | sudo nano /etc/vnstat.conf |
„MaxBandwidth“ darf auch auskommentiert werden, um diese Funktion zu deaktivieren, falls erwünscht:
1 2 | Interface "eth0" MaxBandwidth 100 |
Nun für jedes Interface, für das eine Übersicht zur Verfügung stehen soll, eine Datenbank anlegen. Beispiel:
1 2 | sudo vnstat -u -i eth0 sudo vnstat -u -i eth1 |
Wie im Script zu sehen, werden vorab zwei Variablen angepasst:
1 2 | INTERFACES=(interface1 interface2 interface3) MAILTO=empfaenger@domain.tld |
Für jedes Interface muss wie oben beschrieben die Datenbank existieren!
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 | #!/bin/bash SHELL=/bin/bash PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin MONTAGE=`which montage` VNSTATI=`which vnstati` UUENCODE=`which uuencode` MAIL=`which mail` DATE=`date +%d.%m.%Y` ### CONFIG START ### INTERFACES=(eth0 eth1) MAILTO=empfaenger@domain.tld #### CONFIG END #### for i in "${INTERFACES[@]}" do rm ~/out-vnstati_*.png > /dev/null 2>&1 $VNSTATI -i $i -d -o ~/out-vnstati_d_$i.png $VNSTATI -i $i -m -o ~/out-vnstati_m_$i.png $VNSTATI -i $i -s -o ~/out-vnstati_s_$i.png $VNSTATI -i $i -t -o ~/out-vnstati_t_$i.png $MONTAGE -mode concatenate -tile 2x2 ~/out-vnstati_*.png ~/out-vnstati_collage.png $UUENCODE ~/out-vnstati_collage.png TRAFFIC_$DATE.png | $MAIL -s "Traffic Report, Interface $i - $DATE" $MAILTO done rm ~/out-vnstati_*.png > /dev/null 2>&1 |
Usage: ./script.sh
Vorab als ausführbar markieren: chmod +x script.sh
Das Script ist leise, erzeugt also keine Ausgabe, außer es treten Fehler auf.
Eine Ausführung als Cronjob jeden Tag um 00:00 Uhr würde so funktionieren:
1 | crontab -e |
Mit Inhalt:
1 | 0 0 * * * /path/to/script.sh |
Da es zu Problemen mit der Dekodierung des Anhangs kommen kann, habe ich ein alternatives Script geschrieben, welches „mutt“ anstatt „mail“ und „uuencode“ verwendet. Falls noch nicht geschehen, „mutt“ jetzt installieren:
1 | sudo apt-get install mutt |
Das Script unterscheidet sich lediglich in der Art des Versands:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 | #!/bin/bash SHELL=/bin/bash PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin MONTAGE=`which montage` VNSTATI=`which vnstati` MUTT=`which mutt` DATE=`date +%d.%m.%Y` ### CONFIG START ### INTERFACES=(eth0 eth1) MAILTO=empfaenger@domain.tld #### CONFIG END #### for i in "${INTERFACES[@]}" do rm ~/out-vnstati_*.png > /dev/null 2>&1 $VNSTATI -i $i -d -o ~/out-vnstati_d_$i.png $VNSTATI -i $i -m -o ~/out-vnstati_m_$i.png $VNSTATI -i $i -s -o ~/out-vnstati_s_$i.png $VNSTATI -i $i -t -o ~/out-vnstati_t_$i.png $MONTAGE -mode concatenate -tile 2x2 ~/out-vnstati_*.png ~/out-vnstati_collage.png echo | $MUTT -s "Traffic Report, Interface $i - $DATE" $MAILTO -a ~/out-vnstati_collage.png done rm ~/out-vnstati_*.png > /dev/null 2>&1 |
Ein kleines Snippet, um Mails mit Anhang via „mail“-Befehl zu versenden.
Unter Debian und Ubuntu das Paket „sharutils“ installieren. Hiermit können Dateien für den Mail-Versand vorbereit werden:
1 | sudo apt-get install sharutils |
Das Format lautet: uuencode lokale_datei.any empfaenger_dateiname.any.
Die lokale Datei kann also unter anderem Namen versendet werden.
Hier ein paar Beispiele, angefangen mit dem einfachen Versenden einer Datei:
1 | uuencode datei.jpeg datei.jpeg | mail empfaenger@domain.tld |
Mit Nachricht – alternativ: „echo“:
1 | (cat Nachricht; uuencode datei.jpeg datei.jpeg) | mail empfaenger@domain.tld |
Mit Absender und Betreff:
1 | (cat Nachricht; uuencode datei.jpeg datei.jpeg) | mail -a "From: Absendername <absender@domain.tld>" -s "Betreff" empfaenger@domain.tld |
Mit Absender, Betreff und UTF-8 Encoding („multiple header“):
1 | (cat Nachricht; uuencode datei.jpeg datei.jpeg) | mail -a "`echo -e "Charset: UTF-8\nFrom: Absendername <absender@domain.tld>"`" -s "Betreff" empfaenger@domain.tld |
Heute, dem 15.01.2014, möchte ich noch moderne Alternativen ergänzen, angefangen mit „mutt“, welches MIME-konform ist:
1 | sudo apt-get install mutt |
Beispiel mit Nachricht und Betreff:
1 | echo "Nachricht" | mutt -s "Betreff" empfaenger@domain.tld -a datei.jpeg |
Zweite Alternative mit „uuenview“ – Kann quasi alles, was „uuencode“ bietet, ist jedoch wie „mutt“ MIME-konform:
1 | sudo apt-get install uudeview |
Beispiel mit Nachricht und Betreff („-a“ für Eingabe der Nachricht via „stdin“:
1 | cat Nachricht | uuenview -b datei.jpeg -m empfaenger@domain.tld -a |