3 Aangepaste waarschuwingsscripts

Overzicht

Als u niet tevreden bent met de bestaande mediatypen voor het verzenden van waarschuwingen, is er een alternatieve manier om dat te doen. U kunt een script maken dat de melding op uw manier afhandelt.

Waarschuwingscripts worden uitgevoerd op de Zabbix-server. Deze scripts moeten zich bevinden in de map die is opgegeven in het configuratiebestand van de server met de parameter AlertScriptsPath.

Hier is een voorbeeld van een aangepast waarschuwingscript:

#!/bin/bash
       
       naar=$1
       onderwerp=$2
       inhoud=$3
       
       cat <<EOF | mail -s "$onderwerp" "$naar"
       $inhoud
       EOF

Vanaf versie 3.4 controleert Zabbix de afsluitcode van de uitgevoerde commando's en scripts. Elke afsluitcode die verschilt van 0 wordt beschouwd als een commando-uitvoerings fout. In dat geval zal Zabbix proberen de mislukte uitvoering opnieuw te proberen.

Omgevingsvariabelen worden niet behouden of aangemaakt voor het script, dus ze moeten expliciet worden behandeld.

Configuratie

Om aangepaste waarschuwingscripts in te stellen als het mediatype:

Ga naar Beheer → Mediatypes
Klik op Mediatype maken

Het tabblad Mediatype bevat algemene eigenschappen van het mediatype:

Alle verplichte invoervelden zijn gemarkeerd met een rode asterisk.

De volgende parameters zijn specifiek voor het script-mediatype:

Parameter	Beschrijving
Scriptnaam	Voer de naam in van het scriptbestand (bijv. notification.sh) dat zich bevindt in de map die is opgegeven in het configuratiebestand van de server met de parameter `AlertScriptsPath`.
Scriptparameters	Voeg commandoregelparameters toe aan het script. {ALERT.SENDTO}, {ALERT.SUBJECT} en {ALERT.MESSAGE} macro's worden ondersteund in scriptparameters. Het aanpassen van scriptparameters wordt ondersteund sinds Zabbix 3.0.

Zie gemeenschappelijke parameters voor mediatypes voor details over hoe u standaardberichten en opties voor waarschuwingsverwerking kunt configureren.

Zelfs als een waarschuwingscript geen gebruik maakt van standaardberichten, moeten er nog steeds berichtsjablonen voor bewerkingstypen die door dit mediatype worden gebruikt, worden gedefinieerd, anders wordt er geen melding verzonden.

Omdat parallelle verwerking van mediatypes is geïmplementeerd sinds Zabbix 3.4.0, is het belangrijk op te merken dat met meer dan één geconfigureerd script-mediatype, deze scripts parallel kunnen worden verwerkt door alerter-processen. Het totale aantal alerter-processen wordt beperkt door de StartAlerters parameter.

Gebruikersmedia

Nadat het mediatype is geconfigureerd, gaat u naar de sectie Beheer → Gebruikers en bewerkt u het gebruikersprofiel om media van dit type 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.

Let op dat bij het definiëren van een gebruikersmedium het veld Verzenden naar niet leeg kan zijn. Als dit veld niet wordt gebruikt in het waarschuwingscript, voert u een willekeurige combinatie van ondersteunde tekens in om aan de validatievereisten te voldoen.

Documentation

3 Aangepaste waarschuwingsscripts

Overzicht

Configuratie

Gebruikersmedia