Quelltext der Seite Zabbix mailGraph installieren - Trigger Alerts Emails mit Grafiken

{{Vorlage:AchtungBaustelle}}
----
<u>'''Changelog:'''</u>
* 18. bis 20.11.2024 erste Version
----
==Vorwort==
Ein Kunde wünschte sich bei Emailbenachrichtigungen von Zabbix das in dieser Email auch gleich die Grafik des letzten Tages und der letzten 7 Tage enthalten sind.<br>
Grafiken für Items abrufen habe ich vor ein paar Jahren schon mal gemacht (z.B. [[WinZabbixREPORTER.exe|WinZabbixREPORTER.exe]]), auch mit dem alten Telegram-Skript habe ich mir schon Grafiken zuschicken lassen. Grundsätzlich ist das also möglich und ich habe zugesagt das zu realisieren.<br>
Bei meinen Recherchen für die Lösung bin ich auf dieses Projekt von Mark Oudsen gestoßen: https://github.com/moudsen/mailGraph<br>
Dieses erfüllt eigentlich schon alle Ansprüche und ich habe mich zunächst dagegen entschieden etwas selbst zu programmieren.<br>
<br>
Dieser Artikel ist nun im Zuge der Testinstallation von '''mailGraph''' entstanden um eine reproduzierbare Anleitung zu erhalten.<br>
Ich muss '''mailGraph''' in 3 verschiedenen Konstellationen zum laufen bekommen:<br>
* Zabbix 6 auf Ubuntu 20.04 und PHP 7.4.3
* Zabbix 7 auf Ubuntu 22.04 und PHP 8.1.2
* Zabbix 7 auf Ubuntu 24.04 und PHP 8.3.6
von der Wichtigkeit in dieser Reihenfolge - also fange ich mit Zabbix 6 auf Ubuntu 20.04 an.<br>
Im Moment scheint es so das '''mailGraph''' nicht mit Zabbix 7 funktioniert. Grund ist das bei API-Zugriffen nun zwingend ein API-Schlüssel statt eines Passwortes verwendet werden muss und der Übergabeparameter deswegen anders heißt. Die Änderung ist nicht so schwierig und habe ich bereits in anderen Skripten vorgenommen. Ich werden sehen wie ich das handhabe, eventuell lässt sich Zabbix 7 auch zum alten verhalten überreden.<br>
<br>
Ich installiere hier '''mailGraph''' auf den gleichen Server auf dem auch Zabbix läuft, das muss aber nicht so sein, Zabbix muss per URL die {{code|mailGraph.php}} erreichen können und umgekehrt muss '''mailGraph''' das Zabbix-Frontend / die Weboberfläche per URL erreichen können. Man kann das ganze also auch trennen.<br>
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->

==Hinweis zu den Zabbix-Grafiken==
'''mailGraph''' bekommt von Zabbix die Event-Id des ausgelösten Triggers mitgeteilt. Über die Zabbix-API ermittelt '''mailGraph''' dann alle benötigten Informationen, unter anderem welche Items beteiligt sind. Es sucht dann vorhandene(!!!) Grafiken in welchen die Items vorkommen und erstellt diese über das Zabbix-Webinterface (die {{code|chart2.php}}).<br>
Das bedeutet das keine ad hoc Grafiken erstellt werden sondern das die gewünschten Grafiken beim Host in Zabbix hinterlegt sein müssen. Da man Grafiken auch in den Templates definieren kann ist das weniger umständlich als es klingt. Zudem kann man die Grafiken so informativer Gestalten.<br>
Es gibt eine CPU-Warnung für einen Cluster-Knoten? Man kann in die Grafik gleich die CPU-Auslastung aller Knoten einbauen.<br>
Es ist eine "freier Speicherplatz auf Laufwerk D:" Warnung? In die Grafik könnte Ihr auch gleich den gesamten und belegten Speicherplatz einbauen.<br>
Es gibt wohl die Möglichkeit die Grafiken zu filtern so das man über die Bezeichnung nur bestimmte Grafiken senden könnte. Das habe ich zu diesem Zeitpunkt aber noch nicht getestet und werde es ggf. später in dieser Anleitung hinterlegen.<br>
<br>
Werden keine Grafiken gefunden, so wird immer noch die Meldung selbst über '''mailGraph''' gesendet, dann halt nur ohne Grafiken. Sorgt also dafür das im Template auch genügend Informativer Text dabei ist.<br>
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->

==Hinweis zu dieser Anleitung==
Ich arbeite hier in den SSH-Sitzungen als {{Key|root}} um mir ständige <code>sudo</code> Eingaben zu ersparen.<br>
Dazu wechsle ich per<br>
 sudo -i
dauerhaft in einer SSH-Sitzung zum Benutzer {{Key|root}}.<br>
Bei Bedarf wird in der Anleitung in den Kontext eines anderen Benutzers geweschselt, z.B. '''''www-data'''''<br>
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->

==mailGraph mit Zabbix 6.0 LTS und Ubuntu 20.04 LTS mit PHP 7.4.3==
===Postfix installieren und konfigurieren===
Den eigentlichen Mailtransport übernimmt Postfix, welchen wir dann so konfigurieren das dieser alle Emails an einen Smarthost (z.B. ein Exchange-Server) weiterleitet. Mailutils brauchen wir zum testen.<br>
 apt install postfix mailutils -y
In den nachfolgenden Optionen wählt Ihr dann folgendes (Namen und IP-Adressen ggf. anpassen):
* Satellitensystem
* E-Mail-Name des Systems: testzabbix6.znil.local
* SMTP-Relay-Host: 192.168.128.83
Die IP-Adresse muss dann euer SMTP-Relay bzw. euer Mailserver sein.<br>
Natürlich testen wir einmal ob der Versand funktioniert:<br>
 echo "Test Email Body" | mail -s "Testnachricht von testzabbix6" "admin@znil.org"
Wen die Email nicht ankommt, schaut als erstes in den Junk-E-Mail Ordner von Outlook.<br>
Ansonsten könnte ihr mit dem Befehl<br>
 mailq
sehen ob Postfix die Email überhaupt losgeworden ist. Ist der Empfänger innerhalb euerer Organisation sollte das eigentlich immer Klappen (vom Jun-E-Mail Ordner mal angesehen).<br>
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->
===PHP benötigte Pakete installieren===
Der Composer wird benötigt um später verschiedene PHP-Module zu installieren, php-curl für den Zugriff auf das Zabbix-Server Webinterface:<br>
 apt install composer php-curl -y
 systemctl restart apache2.service
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->

===mailGraph herunterladen und installieren===
 cd /var/www/html
 <nowiki>git clone https://github.com/moudsen/mailGraph mailGraph</nowiki>
 chown -R www-data:www-data /var/www
 sudo -u www-data /usr/bin/bash
 cd mailGraph
 mkdir log tmp
 composer require phpmailer/phpmailer
 composer require twig/twig
 cp config/config.json.template.multigraph config/config.json
 exit
Ihr solltet jetzt wieder den Eingabeprompt des root haben.<br>
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->

===mailGraph per http erreichbar machen (Apache2)===
'''mailGraph''' wird später per Webhook aufgerufen, also per URL-Aufruf.<br>
In meinen Installationen habe ich die Standardwebseite durch die der Zabbix-Webseite ersetzt.<br>
Wenn ich also die IP-Adresse des Zabbix-Servers im Webbrowser eingebe erscheint die Zabbix-Weboberfläche, auch ohne den Zusatz <code>/zabbix</code>.<br>
Wenn bei euch nur die Standardwebseite des Apache Webservers erscheint, sollte der Zugriff über <code>/mailGraph</code> bereits funktionieren.<br>
Wenn nicht erstellen wir eine Konfiguration (schadet auch nicht das zu tun):<br>
 nano /etc/apache2/conf-available/mailGraph.conf
und folgenden Inhalt einfügen:<br>
<source lang="bash">
<IfModule mod_alias.c>
    Alias /mailGraph /var/www/html/mailGraph
</IfModule>

<Directory "/var/www/html/mailGraph">
    Options FollowSymLinks
    AllowOverride None
    Order allow,deny
    Allow from all

    <IfModule mod_php7.c>
        php_value max_execution_time 300
        php_value memory_limit 128M
        php_value post_max_size 16M
        php_value upload_max_filesize 2M
        php_value max_input_time 300
        php_value max_input_vars 10000
        php_value always_populate_raw_post_data -1
        php_value date.timezone Europe/Berlin
    </IfModule>
</Directory>
</source>
Im Anschluss:<br>
 a2enconf mailGraph
 systemctl reload apache2
Kleiner Test:<br>
 http://192.168.0.6/mailGraph/mailGraph.php
aufrufen (IP-Adresse an euren Zabbix-Server anpassen) sollte eine Meldung wie
 Missing EVENT ID?
ergeben.<br>
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->

===mailGraph per http erreichbar machen (Nginx)===
Da hatte ich diese Anleitung erstellt ... und das Zielsystem hatte dann doch Nginx statt Apache verwendet.<br>
Ich habe mir unter<br>
 /etc/nginx
die aktive Konfiguration für das Zabbix-Webfrontend herausgesucht.<br>
Die wird also als {{code|.conf}} unter
 /etc/nginx/conf.d/
zu finden sein oder als Site unter
 /etc/nginx/sites-enabled/
Die Datei könnte {{code|zabbix.conf}} heißen, schaut ob das auch die aktive Konfiguration ist.<br>
Da sollte eine Zeile wie<br>
 root    /usr/share/zabbix;
ziemlich am Anfang stehen.<br>
In diese Datei hängt Ihr ganz unten, vor der letzten Zeile mit dem {{code|<nowiki>}</nowiki>}} ganz links folgendes ein:<br>
<source lang="bash">
        location /mailGraph {
                alias /var/www/html/mailGraph/;
                location ~ \.php$ {
                        if (!-f $request_filename) { return 404; }
                        fastcgi_pass unix:/run/php/php-fpm.sock;
                        include fastcgi_params;
                        fastcgi_param SCRIPT_FILENAME $request_filename;
                        fastcgi_param SCRIPT_NAME $fastcgi_script_name;
                }
       }
</source>
Dann startet Ihr den '''nginx''' einmal neu:<br>
 systemctl restart nginx.service
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->

===Konfigurationsdatei für Zabbix herunterladen===
Nun können wir auch gleich die benötigte Konfigurationsdatei für Zabbix herunterladen, da der Webbrowser die Datei aber direkt öffnen würde, nutzen wir einen kleinen Trick:<br>
 sudo -u www-data /usr/bin/nano /var/www/html/mailGraph/downloadxml.html
und fügen folgende Zeile ein:<br>
<source lang="html">
<a href="mailGraph.xml?dummy=dummy" download>Download mailGraph.xml</a>
</source>
Nun können wir über folgenden Link die XML herunterladen und auf unserem Rechner speichern:<br>
 http://192.168.0.6/mailGraph/downloadxml.html
Da erscheint dann ein Link, auf den drücken wir dann drauf :-)<br>
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->
===Zabbix Benutzer mit API-Zugriff erstellen===
Wir brauchen einen '''Zabbix Super Admin''' Benutzer mit Passwort und einen API-Schlüssel für diesen Benutzer.<br>
'''mailGraph''' meldet sich über die API an um die notwendigen Daten und IDs zu ermitteln, der Download der Grafiken erfolgt aber über die Web-Schnittstelle, deshalb wird beides benötigt.<br>
Auf der Weboberfläche von Zabbix:<br>
 Administration => Users => Create user
:[[Datei:ClipCapIt-241118-132815.PNG]]<br>
Bitte keine Sonderzeichen im Benutzernamen oder im Passwort. Es darf lang sein, Groß und Klein und Zahlen.<br>
Die Sprache stellt auf {{Key|English (en_GB)}} damit er auch brav die europäische Schreibweise bei Datum und Uhrzeit nutzt.<br>
Dann auf den Reiter '''Permissions''' wechseln:<br>
:[[Datei:ClipCapIt-241118-133041.PNG]]<br>
und die '''Super admin role''' setzen.<br>
Meldet euch bei Zabbix ab und mit dem neu erstellen Benutzer gleich wieder an.<br>
Geht dann unten links auf
 User settings => API tokens => Create API token
:[[Datei:ClipCapIt-241118-133353.PNG]]<br>
Danach erscheint das '''Auth token''' was Ihr euch wegkopiert - Ihr könnt es danach nicht wieder anzeigen lassen sondern müsstet ein neues generieren!<br>
:[[Datei:ClipCapIt-241118-133607.PNG]]<br>
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->

===mailGraph konfigurieren===
wieder in der SSH-Sitzung, wir wechseln wieder zum '''www-data''' Benutzer weil wir die Konfiguration dann testen können:<br>
 sudo -u www-data /usr/bin/bash
 cd /var/www/html/mailGraph
 nano config/config.json
und den Inhalt wie folgt (Erklärungen kommen darunter):<br>
<source lang="JSON">
{
    "script_baseurl": "http:\/\/192.168.0.6\/mailGraph\/",
    "cli_eventId": 0,
    "cli_duration": 0,
    "cli_recipient": "admin@znil.org",
    "cli_subject": "[TEST] {{ HOST_NAME|raw }}:  ({{ EVENT_SEVERITY }}) {{ EVENT_NAME|raw }}",
    "cli_baseURL": "http:\/\/192.168.0.6\/",
    "cli_periods": "10m,4h,2d,7d",
    "cli_periods_headers": "Last 10 minutes,Last 4 hours,Last 2 days,Last 7 days",
    "cli_debug": 1,
    "cli_proxy": "",
    "zabbix_user": "mailgraphuser",
    "zabbix_user_pwd": "test123456",
    "zabbix_api_user": "mailgraphuser",
    "zabbix_api_pwd": "test123456",
    "subject": "{{ HOST_NAME|raw }}:  ({{ EVENT_SEVERITY }}) {{ EVENT_NAME|raw }}",
    "smtp_server": "localhost",
    "smtp_port": 25,
    "smtp_transport": "none",
    "smtp_strict": "yes",
    "smtp_from_address": "mailgraph@testzabbix6.znil.local",
    "smtp_from_name": "mailGraph TestZabbix6",
    "smtp_reply_address": "admin@znil.org",
    "smtp_reply_name": "mailGraph response mailbox",
    "graph_match": "any",
    "periods": "10m,4h,2d,7d",
    "periods_headers": "Last 10 minutes,Last 4 hours,Last 2 days,Last 7 days",
    "retention_logs": 14,
    "retention_images": 14,
    "debug": 0
}
</source>
Erläuterung der Optionen im Detail:<br>
----
 "script_baseurl": "http:\/\/192.168.0.6\/mailGraph\/"
Die URL über welche '''mailGraph''' aufgerufen wird, hier also das virtuelle Verzeichnis welches wir zuvor angelegt haben.<br>
Wichtig ist das alle <code>/</code> Escaped werden müssen mit einem <code>\</code> davor.<br>
Und das es am Ende auch noch ein <code>/</code> kommt.
----
 "cli_eventId": 0,
 "cli_duration": 0,
wird für die Kommandozeilen-Testoptionen benötigt und müssen in der aktuellen Version beide auf 0 stehen. Der Test wählt dann zufällig bzw. den neuesten ausgelösten Trigger aus.
----
 "cli_recipient": "admin@znil.org",
wird für die Kommandozeilen-Testoptionen benötigt und gibt den Empfänger der Test-E-Mails an
----
 <nowiki>"cli_subject": "[TEST] {{ HOST_NAME|raw }}:  ({{ EVENT_SEVERITY }}) {{ EVENT_NAME|raw }}",</nowiki>
wird für die Kommandozeilen-Testoptionen benötigt und definiert die Betreffzeile der Email
----
 "cli_baseURL": "http:\/\/192.168.0.6\/",
wird für die Kommandozeilen-Testoptionen benötigt und gibt den Ziel-Zabbix-Server an, also die URL über welche die Weboberfläche und API erreichbar ist.
----
 "cli_periods": "10m,4h,2d,7d",
wird für die Kommandozeilen-Testoptionen benötigt und gibt die Zeiträume der Grafiken an, hier die letzten 10 Minuten, die letzten 4 Stunden, die letzten 2 Tage und die letzten 7 Tage
----
 "cli_periods_headers": "Last 10 minutes,Last 4 hours,Last 2 days,Last 7 days",
wird für die Kommandozeilen-Testoptionen benötigt und legt die Überschriften über den Grafiken der zuvor definierten Zeiträume fest. Über der Grafik mit den letzten 2 Tagen steht also die Überschrift "'''Last 2 days'''"
----
 "cli_debug": 1,
wird für die Kommandozeilen-Testoptionen benötigt und sorgt für umfangreiche Debuggingmeldung welche auch an die Email angehängt werden (als .log Datei)
----
 "cli_proxy": "",
wird für die Kommandozeilen-Testoptionen benötigt und legt ggf. einen zu verwendenden Proxy-Server fest
----
 "zabbix_user": "mailgraphuser",
 "zabbix_user_pwd": "test123456",
Der Benutzer für den Zugriff auf die Weboberfläche mit Passwort
----
 "zabbix_api_user": "mailgraphuser",
 "zabbix_api_pwd": "test123456"
Der Benutzer für den Zugriff auf die API von Zabbix. ACHTUNG! Der Zugriff per API-Schlüssel wird aktuell noch nicht unterstützt! Deshalb auch hier das Passwort.
----
 <nowiki>"subject": "{{ HOST_NAME|raw }}:  ({{ EVENT_SEVERITY }}) {{ EVENT_NAME|raw }}",</nowiki>
Wie die Betreffzeile bei normalen Emails aussehen soll. Es Können die Zabbix-Makronamen verwendet werden, jedoch den <code>.</code> durch einen <code>_</code> ersetzen und siehe die Schreibweise mit den doppelten Klammern + Leerzeichen
----
 "smtp_server": "localhost",
 "smtp_port": 25,
 "smtp_transport": "none",
 "smtp_strict": "yes",
Die Angaben zum Ziel-Mailserver. Wir haben zuvor Postfix konfiguriert so das wir diese einfach dem eigenem System in die Hand drücken können. Dafür sollten die Einstellungen passen
----
 "smtp_from_address": "mailgraph@testzabbix6.znil.local",
 "smtp_from_name": "mailGraph TestZabbix6",
Absender Email-Adresse und Anzeigename unter dem die Nachrichten versendet werden
----
 "smtp_reply_address": "admin@znil.org",
 "smtp_reply_name": "mailGraph response mailbox",
Antwortadresse, also wohin gesendet wird wenn jemand bei der Mail auf Antworten drückt
----
 "graph_match": "any",
Filter für die gefundenen Grafiken. {{Key|any}} liefert jede zurück, weitere mögliche Werte sind {{Key|Exact}} und {{Key|Other}}, die Bedeutung bzw. Funktionsweise habe ich noch nicht herausgefunden
----
 "periods": "10m,4h,2d,7d",
 "periods_headers": "Last 10 minutes,Last 4 hours,Last 2 days,Last 7 days",
gibt die Zeiträume der Grafiken an, hier die letzten 10 Minuten, die letzten 4 Stunden, die letzten 2 Tage und die letzten 7 Tage,<br>
sowie deren Überschriften. Über der Grafik mit den letzten 4 Stunden steht also die Überschrift "'''Last 4 hours'''"
----
 "retention_logs": 14,
 "retention_images": 14,
Wie lange sollen die Logs und die Grafiken auf Festplatte gespeichert bleiben bevor diese gelöscht werden. Achtung, die Bilder können bei vielen Emails auch viel Platz einnehmen!
----
 "debug": 0
Kein ausführliches Debbugging bei normalen Nachrichten.
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->
===mailGraph testen auf der CLI===
Wir sind noch als Benutzer '''www-data''' angemeldet und befinden uns noch im Verzeichnis<br>
 /var/www/html/mailGraph
Nun können wir per CLI die Funktion testen. Dabei wird ein umfangreiches Log ausgegeben:<br>
 php mailGraph.php test
Wenn alles klappt habt Ihr dann eine Email in eurem Postfach,
wenn es nicht klappt wird der Fehler dort stehen.<br>
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->

===Template in Zabbix importieren===
Als wir den '''http://''' Zugriff auf '''mailGraph''' eingerichtet haben, haben wir auch gleich die {{Key|mailGraph.xml}} heruntergeladen.<br>
Diese Datei ist ein '''''Media type Template''''', mir war vorher gar nicht aufgefallen das es so etwas gibt.<br>
Auf dem Webinterface des Zabbix-Servers gehen wir auf<br>
 Administration => Media types => Import
und importieren diese Datei:<br>
:[[Datei:ClipCapIt-241119-093219.PNG]]<br>
Oben links sollte ein<br>
:[[Datei:ClipCapIt-241119-093305.PNG]]<br>
und in der Liste sollte es auch auftauchen:<br>
:[[Datei:ClipCapIt-241119-093427.PNG]]<br>
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->
===Media Types deaktivieren===
Damit es später leichter in den anderen Dialogen wird, würde ich euch empfehlen alle '''Media types''' zu deaktivieren die Ihr nicht nutzt.<br>
Jeder aktive '''Media type''' erscheint später nämlich in den Auswahllisten. Ihr könnt vorne per Kontrollkästchen mehre markieren und unten dann auf {{Key|Disable}} klicken, alternativ klickt Ihr auf das grüne Wort '''Enabled''' hinter dem Namen und Typ des um den '''Media types''' um dessen Status umzuschalten.<br>
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->
===mailGraph in Zabbix konfigurieren===
Wir klicken in der Liste der '''Media types''' auf '''mailGraph''' um diesen zu konfigurieren:<br>
:[[Datei:ClipCapIt-241119-101132.PNG]]<br>
Die Parameter im Detail:<br>
----
 baseURL                <nowiki>http://192.168.0.6/</nowiki>
Die URL zum Webinterface eures Zabbix-Servers mit einem abschließenden <code>/</code>. Endet oft auch auf <code>/zabbix/</code> je nach dem wir Ihr installiert habt.<br>
Wenn Ihr oben in die Adresszeiles des Browser schaut, sollte da die richtige Adresse stehen (alles vor {{Key|zabbix.php}})
----
 duration              <nowiki>{EVENT.DURATION}</nowiki>
Wie lange der Trigger schon ausgelöst hat bzw. hatte, Wert wird dem Makro {{code|{EVENT.DURATION} }} entnommen, Wert in Sekunden.<br>
Zeit bei einer Recovery-Meldung an wie lange der Trigger ausgelöst hatte.
Siehe auch https://www.zabbix.com/documentation/current/en/manual/appendix/macros/supported_by_location
----
 eventId               <nowiki>{EVENT.ID}</nowiki>
Die Id des Ereignisses / Problems welches der Trigger ausgelöst hat. Die wichtigste Information überhaupt für '''mailGraph''', anhand dieses Wertes werden alle Daten ermittelt.<br>
----
 graphHeight           300
 graphWidth            600
Höhe und Breite der eingebetteten Grafiken in Pixeln. Ich habe die Werte etwas erhöht, die Augen werden auch nicht besser.<br>
----
 HTTPProxy
Hier könnte man einen Proxy angeben falls der für den Zugriff auf '''mailGraph''' notwendig wäre.<br>
----
 infoTest              Test
Ein Beispiel für die Übergabe weiterer Daten an '''mailGraph'''. {{code|infoText}} könnte man auch mit dem Wert eines Makros füllen, der Wert kann im verwendeten Template (abgelegt unter {{code|/var/www/html/mailGraph/templates}} über TWIG verwendet werden. Um {{code|infoText}} dort zu verwenden würde man {{code| {{ infoText }} }} verwenden.<br>
Bevor Ihr hier anfangt etwas zu übergeben, schaut unter https://github.com/moudsen/mailGraph/wiki/5--Templates nach ob es den Wert nicht schon gibt.<br>
Wichtig für eigene Werte ist, das diese unbedingt mit {{code|info}} beginnen müssen!<br>
In '''mailGraph''' Version 2.16 gibt es einen Fehler der die Übergabe verhindert. Dazu gibt es in dieser Anleitung einen Fix: [[#Verwendung von infoXXX im Template reparieren]]<br>
----
 periods               7d,183d
Für welche Zeiträume sollen die Grafiken eingebettet werden? Ich habe hier die letzten 7 Tage und das letzte halbe Jahr, jeweils in Tagen.<br>
Man könnte auch nur einen Zeitraum angeben oder auch mehr.<br>
----
 periods_headers       Letzten 7 Tage,Letzten 6 Monate
Überschriften über die zuvor definierten Zeiträume, die 183 Tage würden also mit '''Letzten 6 Monate''' überschrieben werden.<br>
----
 recipient             <nowiki>{ALERT.SENDTO}</nowiki>
Die Emailadresse des Empfängers, muss beim Benutzer für den Medientyp {{code|mailGraph}} hinterlegt sein. Es wird nicht automatisch die ggf. schon hinterlegte Emailadresse für andere '''Media types''' wie {{code|Email}} oder {{code|Email (HTML)}} genommen.<br>
----
 showLegend            1
Ob unter den Grafiken die Legende, also die Erklärung welche Farbe welcher Linie wofür steht. Sinnvoll falls mehr als ein Item in der Grafik dargestellt wird.<br>
----
 subject               <nowiki>{{ HOST_NAME|raw }} - {{ EVENT_STATUS }} ({{ EVENT_SEVERITY }}): {{ EVENT_NAME|raw }}</nowiki>
Die Betreffzeile der gesendeten Email, hier anpasst an meine persönlichen Vorlieben. Sollte etwa so aussehen:<br>
 DCNEW.znil.local - PROBLEM (Average): Service stopped: Druckwarteschlange
Siehe auch https://github.com/moudsen/mailGraph/wiki/5--Templates<br>
----
 URL                   <nowiki>http://192.168.0.6/mailGraph/mailGraph.php</nowiki>
Die komplette URL zur {{code|mailGraph.php}}, testet den Aufruf vorher im Browser, sollte die '''''Missing EVENT ID?''''' Meldung bringen.<br>
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->

===mailGraph Aktivitäten im zabbix_server.log anzeigen lassen===
Im JavaScript was im '''Media type''' von '''mailGraph''' hinterlegt ist, gibt es auch ein Logging in die Standardlogdatei des Zabbix-Servers, in der Regel also nach<br>
 /var/log/zabbix/zabbix_server.log
Allerdings wird im Script auf Stufe 4 geloggt, das wäre wenn das Debugging aktiviert wäre. Im Standard des Zabbix-Servers ist aber {{code|DebugLever=3}} gesetzt.<br>
Um die Meldungen im normalen Log sehen zu können, müssten wir das im JavaScript anpassen. In den Einstellungen von '''mailGraph''' klickt Ihr auf den Stift neben dem Skript:<br>
:[[Datei:ClipCapIt-241120-102119.PNG]]<br>
und sucht diese Zeilen hier (normalerweise Zeile 57 bis 60):<br>
<source lang="JavaScript">
    // Post information to the processing script
    Zabbix.Log(4, '[MailGraph Webhook] Sending request: ' + params.URL + '?' + JSON.stringify(fields));
    var resp = req.post(params.URL,JSON.stringify(fields));
    Zabbix.Log(4, '[Mailgraph Webhook] Received response:' + resp);
</source>
Aus der {{code|4}} direkt hinter {{Key|Zabbix.Log(}} macht Ihr einfach eine {{code|3}}:<br>
<source lang="JavaScript">
    // Post information to the processing script
    Zabbix.Log(3, '[MailGraph Webhook] Sending request: ' + params.URL + '?' + JSON.stringify(fields));
    var resp = req.post(params.URL,JSON.stringify(fields));
    Zabbix.Log(3, '[Mailgraph Webhook] Received response:' + resp);
</source>
und schon würdet Ihr Meldungen wie diese in der Datei {{code|/var/log/zabbix/zabbix_server.log}} erhalten wenn eine Nachricht versendet wird:<br>
 <nowiki>1155:20241120:060150.227 [MailGraph Webhook] Sending request: http://192.168.0.6/mailGraph/mailGraph.php?{"itemId":null,"eventId":78,"recipient":"bernhard@znil.local","baseURL":"http://192.168.0.6/","duration":null,"graphWidth":"600","graphHeight":"300","subject":"{{ HOST_NAME|raw }}: ({{ EVENT_SEVERITY }}) {{ EVENT_NAME|raw }}","showLegend":"1","periods":"7d,183d","periods_headers":"Letzten 7 Tage,Letzten 6 Monate","infoTest":"Test"}</nowiki>
 1155:20241120:060150.483 [Mailgraph Webhook] Received response:{"messageId":"<7HPNlYaBPInND2gXWH9J4iVdGrqUqPVTw113O2CwwJ8@192.168.0.6>"}
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->

===Email-Adresse bei einem Benutzer für mailGraph hinterlegen===
Ein Zabbix Super Admin kann den Benutzern unter<br>
 Administration => Users => Username anklicken => Media
die Email-Adresse hinterlegen. Alternativ kann der Benutzer wenn er an Zabbix angemeldet ist diese selbst unter<br>
 User Settings => Profile => Media
hinzufügen:<br>
:[[Datei:ClipCapIt-241119-110839.PNG]]<br>
:[[Datei:ClipCapIt-241119-110932.PNG]]<br>
Wichtig ist das Ihr bei '''Type''' unbedingt '''mailGraph''' auswählt. Alle nicht aktiven Medientypen werden in der Auswahlliste rot dargestellt.<br>
:[[Datei:ClipCapIt-241119-111919.PNG]]<br>
Und den Klick auf {{Key|Update}} nicht vergessen!<br>
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->
===Media type testen===
Da arbeite ich nun schon seit 2012 mit Zabbix - aber das es eine {{key|Test}} Funktion bzw. einen Link dafür bei den '''Media types''' gibt, ist mir erst im Rahmen dieser Anleitung aufgefallen.<br>
Den gibt es übrigens wohl schon seit der Version Zabbix 5.2:<br>
:[[Datei:ClipCapIt-241120-103404.PNG]]<br>
Der Dialog übernimmt zunächst alle aus der Konfiguration, 2 davon müssen wir für den Test allerdings anpassen:<br>
:[[Datei:ClipCapIt-241120-103649.PNG]]<br>
Bei der {{code|eventId}} können wir einfach eine {{code|0}} eintragen, dann sucht er zufällig ein Problem/Event aus.<br>
Oder wenn Ihr in der '''Problems''' Ansicht seit, klickt Ihr vorne bei einem Problem auf die '''Time''':<br>
:[[Datei:ClipCapIt-241120-104252.PNG]]<br>
Die Ansicht wechselt und oben in der Adresszeile könnt Ihr die {{code|eventid}} sehen:<br>
:[[Datei:ClipCapIt-241120-104400.PNG]]<br>
Hier also die '''78'''<br>
<br>
Und bei {{code|recipient}} müsst Ihr eine Email-Adresse eintragen, dann unten auf {{key|Test}} klicken:<br>
:[[Datei:ClipCapIt-241120-104650.PNG]]<br>
Wenn es oben Grün wird ist alles ok.<br>
Wenn nicht sind hier Tipps für die Fehlersuche: https://github.com/moudsen/mailGraph/wiki/8--Troubleshooting
Schaut auch einmal in das Log des Apache2 Webservers:<br>
 tail -n 1000 -F /var/log/apache2/error.log
Bei mir ging es zunächst nicht weil ich vergessen hatte nach der Installation des '''php-curl''' Moduls den Apache2 selbst neu zu starten.<br>
Ich habe den Neustart nun oben in die Anleitung eingebaut.<br>
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->

==Trigger Action - Vorwort==
Zuerst ein Hinweis: In den '''Trigger actions''' für Benachrichtigungen kann man festlegen über welche Medien die jeweilige Action senden soll.<br>
In der Default Action '''''Report problems to Zabbix administrators''''' die es nach einer frischen Installation gibt ist das aber so definiert:<br>
:[[Datei:ClipCapIt-241119-114245.PNG]]<br>
{{code|- All -}} bedeutet das die Personen oder Gruppen über alle hinterlegten Medien informiert werden.<br>
Nutzt Ihr z.B. '''Email (HTML)''', '''Telegram''' und nun noch '''mailGraph''' würde der Benutzer also gleich 3 Meldungen erhalten.<br>
Ist das so gewollt - Ok.<br>
Ich persönlich erstelle für jeden Medientyp eine eigene '''Trigger action''', ich finde das übersichtlicher und kann z.B. auch Trigger auf bestimmten Medien ausfiltern bzw. die Trigger überhaupt nach Medien filtern.<br>
<br>
Ich rate euch also dringend, eure bestehenden '''Trigger actions''' einmal zu kontrollieren und nach Möglichkeit immer den gewünschten Medientyp fest einzustellen.<br>
Eine schnelle Übersicht dafür bietet die
 Administration => Media types 
Ansicht, hinter jedem '''Media type''' ist in der Spalte '''Used in actions''' aufgeführt für welche diese greift:<br>
:[[Datei:ClipCapIt-241120-091246.PNG]]<br>
Ein Fehler im System: Wenn man sich in einer '''Trigger action''' unter "Recovery operations" per '''Notify all involved''' sendet lässt, taucht diese '''Trigger action''' zumindest im Moment bei Zabbix Version ab 7.x immer bei jeden '''Media type''' auf.<br>
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->
===Trigger Action für mailGraph einrichten===
Zum Testen erstelle ich nun eine '''Trigger action''' die bei einem Problem sofort eine Mail versendet, ggf. solltet Ihr in einer Produktivumgebung diese auf Hostgruppen oder einzelne Hosts einschränken.<br>
 Configuration => Actions => Trigger actions => Create action
:[[Datei:ClipCapIt-241119-115338.PNG]]<br>
Bei den '''Conditions''' setzte ich einen Filter das die '''Trigger severity''' mindestens '''Warning''' oder höher sein muss.<br>
Hier könntet Ihr auch noch nach Hosts / Hostgruppen filtern.<br>
Weiter geht es auf dem Reiter {{key|Operations}}:<br>
:[[Datei:ClipCapIt-241119-115338.PNG]]<br>
Die '''Defaul operation step duration''' setzte ich immer auf {{code|1m}}, also 1 Minute. Das ist der zeitliche Abstand zwischen 2 Schritten. Im Normalfall lasse ich mir Meldungen z.B. erst nach 10 Minuten senden, wenn ich die '''Operation''' dann also auf den Schritt 11 setze, so führt er diese erst nach 10 Minuten aus.<br>
Wir klicken bei '''Operations''' auf {{key|Add}}:<br>
:[[Datei:ClipCapIt-241119-115845.PNG]]<br>
'''Steps''' lasse ich auf {{code|1}}, so wird sofort gesendet (zum Testen), bei '''Send only to''' stelle ich auf {{code|mailGraph}}.<br>
'''Custom message''' ist in Zusammenhang mit '''mailGraph''' übrigens sinnlos da der Text aus diesem Feld nicht ausgewertet wird.<br>
:[[Datei:ClipCapIt-241119-120125.PNG]]<br>
Für den Test ist das schon alles.
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->

===Testen!===
Macht was kaputt! Erstellt ggf. einen eigenen Trigger direkt an einem Host um einen Alarm auszulösen.<br>
Ich habe zum Beispiel für eine 9TiB Festplatte die schon mit fast 7TiB belegt ist einen Alarm erstellt welcher bei über 5TiB belegten Speicherplatz auslöst:<br>
:[[Datei:ClipCapIt-241120-111103.PNG]]<br>
Dieser Trigger löst aus wenn '''a)''' Zabbix die Konfigurationsänderung übernommen hat (nach maximal 60 Sekunden) und '''b)''' das nächste mal ein neuer Wert reinkommt.<br>
Die Email dazu sah zunächst ernüchternd aus:<br>
:[[Datei:ClipCapIt-241120-112517.PNG]]<br>
Tja, da waren nur Tortengrafiken hinterlegt, da ist das natürlich etwas sinnfrei.<br>
Also habe ich noch eine Grafik gebaut - die Werte sind ja da, also fehlt nur diese Definition - und von vorne:<br>
:[[Datei:ClipCapIt-241120-121717.PNG]]<br>
Gibt es mehrere Grafiken, würde '''mailGraph''' die vermutlich zuerst gefundene Grafik senden (die mit der niedrigsten Id). Ich habe mit der Einstellung {{code|graph_match}} in der {{code|config.json}} experimentiert, konnte aber keinen Unterschied feststellen. Ich bin sogar der Meinung das der Parameter gar nicht ausgewertet wird.<br>
Die Grafiken zuvor hatte er mir nur gesendet weil ich die Tortengrafik gelöscht habe.<br>
Nachfolgend beschreibe ich eine Lösung wie Ihr eine bestimmte Grafik beim Trigger hinterlegen könnt.<br>
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->
===Gezielt eine bestimmte Grafik beim Trigger hinterlegen===
Wie unter https://github.com/moudsen/mailGraph/wiki/3--Zabbix-Tags-and-Macros beschrieben können bestimmte Vorgaben per Tags an den Triggern überschrieben werden.<br>
Zum Beispiel sucht mir '''mailGraph''' für mein Laufwerk C: immer die Tortengrafik heraus:<br>
:[[Datei:ClipCapIt-241120-133128.PNG]]<br>
Ich hätte aber lieber diese Grafik in den Emails:<br>
:[[Datei:ClipCapIt-241120-133234.PNG]]<br>
Man kann die Id der Grafik gezielt bei einem Trigger hinterlegen, dann wird diese verwendet.<br>
Zuerst also die Id der Grafik ermitteln.<br>
Dazu geht Ihr in die Konfiguration des Host und in dessen Grafiken so das Ihr diese Ansicht habt:<br>
:[[Datei:ClipCapIt-241120-133435.PNG]]<br>
Oben in der Adresszeile des Browsers findet Ihr nun die {{code|graphid}}:<br>
 <nowiki>http://192.168.0.6/graphs.php?form=update&</nowiki><span style="color:red">graphid=2964</span>&context=host&filter_hostids%5B0%5D=10628
In diesem Fall also die {{code|2964}}.<br>
Dann geht Ihr auf die vorhandenen Trigger des Hosts und dessen Reiter '''Tags''':<br>
:[[Datei:ClipCapIt-241120-134014.PNG]]<br>
Fügt einen Tag
 mailGraph.graph
hinzu mit dem Wert, bei mir also<br>
 2964
<br>
Jetzt würde, wenn dieser Trigger auslöst, diese Grafik genommen werden.<br>
Leider gibt es einen Fehler in der {{code|mailGraph.php}} der dies verhindert.<br>
Ihr müsst diese dehalb bearbeiten:<br>
 nano /var/www/html/mailGraph/mailGraph.php
und dann {{key|STRG}} + {{key|W}} drücken, das ist die Suche, und nach folgenden Text suchen:<br>
 $theGraph = $forceGraphInfo
Müsste in Zeile 1373 stehen ({{key|ALT}} + {{key|C}} blendet die Position des Cursors ein). Ändert diese wie folgt ab:<br>
 $theGraph = $forceGraphInfo['result'][0];
Nun wird die beim nächsten mal die gewünschte Grafik verwendet.<br>
Ich habe dazu ein Issue auf Github eröffnet: https://github.com/moudsen/mailGraph/issues/46
<br>
Das ist natürlich total doof, denn den Tag beim Trigger kann ich nicht hinterlegen wenn der Trigger über ein Template bzw. eine Discovery kommt.<br>
Also am besten eure Templates darauf optimieren das jeder Wert für den '''mailGraph''' anschlagen soll nur eine Grafik hat.<br>
Andere Ideen sind willkomen.<br>
Da ich '''mailGraph''' eh noch an Zabbix 7 anpassen möchte, überlege ich in diesem Zuge auch gleich einen Filter nach Schlüsselwörtern einzubauen, z.B. das das Wort '''mailGraph''' im Namen der Grafik vorkommen muss, dann könnte man das etwas gezielter anpassen.
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->

===Verwendung von infoXXX im Template reparieren===
Man kann eigene Werte an '''mailGraph''' über die '''Media type''' Einstellungen übergeben:<br>
:[[Datei:ClipCapIt-241120-145749.PNG]]<br>
Hier will ich den Namen der Action welche den Mailversand ausgelöst hat mit in dem Template haben.<br>
Den Inhalt von {{code|infoActionName}} kann man später im Template unter {{code|/var/www/html/mailGraph/templates/html.template}} per<br>
 <nowiki>{{ infoActionName }}</nowiki>
verwenden.<br>
Leider gibt es in der Version 2.16 einen Fehler der das verhindert. Diesen behebt Ihr wie folgt:<br>
 nano /var/www/html/mailGraph/mailGraph.php
und dann die folgende Zeile per {{key|STRG}} + {{key|W}} suchen:<br>
 $mailData = array();
und diese einfach auskommentieren:<br>
 // $mailData = array();
Dann sucht Ihr nach dem Kommentar
 // DYNAMIC VARIABLES FROM ZABBIX
und fügt direkt darunter die Zeile ein:<br>
 // DYNAMIC VARIABLES FROM ZABBIX
 $mailData = array();
Speichern und schon klappt es wieder.<br>
Ich habe dazu ein Issue auf Github eröffnet: https://github.com/moudsen/mailGraph/issues/47
<br>
<br>
{{Trennlinie-02}}
<!-- ---- -->