Documentation
Table of Contents
1 Email
Overzicht
Om e-mail als leveringskanaal voor berichten te configureren, moet je e-mail configureren als het mediatype en specifieke adressen toewijzen aan gebruikers.
Meerdere meldingen voor een enkele gebeurtenis worden samengevoegd in dezelfde e-mailthread.
Configuratie
Om e-mail als mediatype te configureren:
- Ga naar Alerts → Mediatypen
- Klik op Mediatype maken (of klik op E-mail in de lijst van voorgedefinieerde mediatypen).
Het tabblad Mediatype bevat algemene eigenschappen van het mediatype:
Alle verplichte invoervelden zijn gemarkeerd met een rood asterisk.
De volgende parameters zijn specifiek voor het e-mailmediatype:
| Parameter | Beschrijving |
|---|---|
| E-mailprovider | Selecteer de e-mailprovider: Generic SMTP, Gmail, Gmail relay, Office365, of Office365 relay. Als je de opties voor Gmail/Office365 selecteert, hoef je alleen het afzender e-mailadres en het wachtwoord op te geven; opties zoals SMTP-server, SMTP-serverpoort, SMTP helo, en Verbindingsbeveiliging zullen automatisch worden ingevuld door Zabbix. Zie ook: Geautomatiseerde Gmail/Office365 media types. |
| SMTP-server | Stel een SMTP-server in om uitgaande berichten te verwerken. Dit veld is beschikbaar als Generic SMTP is geselecteerd als de e-mailprovider. |
| SMTP-serverpoort | Stel de poort van de SMTP-server in om uitgaande berichten te verwerken. Dit veld is beschikbaar als Generic SMTP is geselecteerd als de e-mailprovider. |
| Het hier ingevoerde adres wordt gebruikt als het Van-adres voor de verzonden berichten. Het toevoegen van een weergavenaam van de afzender (zoals "Zabbix_info" in Zabbix_info <[email protected]> in de schermafbeelding hierboven) met het werkelijke e-mailadres wordt ondersteund sinds Zabbix versie 2.2. Er zijn enkele beperkingen aan weergavenamen in Zabbix e-mails in vergelijking met wat is toegestaan volgens RFC 5322, zoals geïllustreerd door voorbeelden: Geldige voorbeelden: [email protected] (alleen e-mailadres, geen hoekige haken nodig) Zabbix_info <[email protected]> (weergavenaam en e-mailadres tussen hoekige haken) ∑Ω-monitoring <[email protected]> (UTF-8 tekens in weergavenaam) Ongeldige voorbeelden: Zabbix HQ [email protected] (weergavenaam aanwezig maar geen hoekige haken rond e-mailadres) "Zabbix\@\<H(comment)Q\>" <[email protected]> (hoewel geldig volgens RFC 5322, geciteerde paren en opmerkingen worden niet ondersteund in Zabbix e-mails) |
|
| SMTP helo | Stel een correcte waarde in voor de SMTP helo, meestal een domeinnaam. Als dit veld leeg is, wordt de domeinnaam van de e-mail verzonden (dat wil zeggen wat na het @-teken komt in het veld E-mail). Als het niet mogelijk is om de domeinnaam op te halen, wordt er een waarschuwing van debug-niveau gelogd en wordt de hostnaam van de server verzonden als het domein voor het HELO-commando.Dit veld is beschikbaar als Generic SMTP is geselecteerd als de e-mailprovider. |
| Verbindingsbeveiliging | Selecteer het niveau van verbindingsbeveiliging: Geen - gebruik de CURLOPT_USE_SSL optie niet STARTTLS - gebruik de CURLOPT_USE_SSL optie met de waarde CURLUSESSL_ALL SSL/TLS - gebruik van CURLOPT_USE_SSL is optioneel |
| SSL verifieer peer | Vink het selectievakje aan om het SSL-certificaat van de SMTP-server te verifiëren. De waarde van de serverconfiguratie-instructie "SSLCALocation" moet worden ingevoerd in CURLOPT_CAPATH voor certificaatvalidatie. Dit stelt de cURL-optie CURLOPT_SSL_VERIFYPEER in. |
| SSL verifieer host | Vink het selectievakje aan om te controleren of het Common Name-veld of het Subject Alternate Name-veld van het SSL-certificaat van de SMTP-server overeenkomt. Dit stelt de cURL-optie CURLOPT_SSL_VERIFYHOST in. |
| Authenticatie | Selecteer het niveau van authenticatie: Geen - er worden geen cURL-opties ingesteld (vanaf 3.4.2) Gebruikersnaam en wachtwoord - impliceert "AUTH=*" en laat de keuze van het authenticatiemechanisme over aan cURL (tot 3.4.2) Normaal wachtwoord - CURLOPT_LOGIN_OPTIONS wordt ingesteld op "AUTH=PLAIN" |
| Gebruikersnaam | Gebruikersnaam om te gebruiken bij authenticatie. Dit stelt de waarde in van CURLOPT_USERNAME. |
| Wachtwoord | Wachtwoord om te gebruiken bij authenticatie. Dit stelt de waarde in van CURLOPT_PASSWORD. |
| Berichtformaat | Selecteer het berichtformaat: HTML - verzend als HTML Platte tekst - verzend als platte tekst |
Om de opties voor SMTP-authenticatie beschikbaar te maken, moet de Zabbix-server worden gecompileerd met de --with-libcurl compilatie optie met cURL 7.20.0 of hoger.
Zie ook algemene parameters voor mediatypen voor details over het configureren van standaardberichten en opties voor het verwerken van meldingen.
Mediatype-test
Om te testen of een geconfigureerde e-mailmediatype correct werkt:
- Zoek het relevante e-mailitem op in de lijst van mediatypen.
- Klik op Test in de laatste kolom van de lijst (er wordt een testvenster geopend).
- Voer een Verzenden aan ontvangeradres in, samen met de berichttekst en indien gewenst het onderwerp.
- Klik op Test om een testbericht te versturen.
Een testbericht met succes- of foutmelding wordt weergegeven in hetzelfde venster:
Gebruikersmedia
Nadat het e-mailmediatype is geconfigureerd, ga naar de sectie Gebruikers → Gebruikers en bewerk het gebruikersprofiel om e-mailmedia aan de gebruiker toe te wijzen. De stappen voor het instellen van gebruikersmedia, die voor alle mediatypen gelijk zijn, worden beschreven op de Mediatypen pagina.