Documentation
Table of Contents
#1 Een trigger configureren
Overzicht
Om een trigger te configureren, volg je deze stappen:
- Ga naar: Gegevensverzameling → Hosts
- Klik op Triggers in de rij van de host
- Klik op Trigger maken aan de rechterkant (of op de naam van de trigger om een bestaande trigger te bewerken)
- Voer de parameters van de trigger in het formulier in
Zie ook algemene informatie over triggers en hun berekeningstijden.
Configuratie
Het tabblad Trigger bevat alle essentiële attributen van de trigger.
Alle verplichte invoervelden zijn gemarkeerd met een rode asterisk.
| Parameter | Beschrijving |
|---|---|
| Naam | Naam van de trigger. Ondersteunde macros zijn: {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {ITEM.VALUE}, {ITEM.LASTVALUE}, {ITEM.LOG.*} en {$MACRO} gebruikersmacro's. $1, $2...$9 macros kunnen worden gebruikt om te verwijzen naar de eerste, tweede...negende constante van de uitdrukking. Opmerking: $1-$9 macros worden correct opgelost als ze verwijzen naar constanten in relatief eenvoudige, rechtlijnige uitdrukkingen. Bijvoorbeeld, de naam "Processorgebruik boven $1 op {HOST.NAME}" zal automatisch veranderen in "Processorgebruik boven 5 op Nieuwe host" als de uitdrukking last(/Nieuwe host/system.cpu.load[percpu,avg1])>5 is |
| Gebeurtenisnaam | Indien gedefinieerd, zal deze naam worden gebruikt om de naam van het probleemgeval te maken, in plaats van de naam van de trigger. De gebeurtenisnaam kan worden gebruikt om zinvolle meldingen te maken die probleemgegevens bevatten (zie voorbeeld). Dezelfde set macros wordt ondersteund als in de trigger naam, plus {TIME} en {?EXPRESSION} uitdrukkingsmacro's. Ondersteund sinds Zabbix 5.2.0. |
| Operationele gegevens | Operationele gegevens stellen je in staat om willekeurige teksten samen met macros te definiëren. De macros zullen dynamisch worden opgelost naar realtime gegevens in Bewaking → Problemen. Terwijl macros in de triggernaam (zie hierboven) worden opgelost naar hun waarden op het moment dat een probleem optreedt en de basis vormen van een statische probleemnaam, behouden de macros in de operationele gegevens de mogelijkheid om de allerlaatste informatie dynamisch weer te geven. Dezelfde set macros wordt ondersteund als in de trigger naam. |
| Ernst | Stel de vereiste trigger ernst in door op de knoppen te klikken. |
| Uitdrukking | Logische uitdrukking die wordt gebruikt om de voorwaarden van een probleem te definiëren. Een probleem wordt gemaakt nadat alle voorwaarden in de uitdrukking zijn vervuld, d.w.z. de uitdrukking evalueert naar WAAR. Het probleem wordt opgelost zodra de uitdrukking evalueert naar ONWAAR, tenzij er aanvullende herstelvoorwaarden zijn gespecificeerd in Hersteluitdrukking. |
| Generatie van OK-gebeurtenis | Opties voor de generatie van OK-gebeurtenissen: Uitdrukking - OK-gebeurtenissen worden gegenereerd op basis van dezelfde uitdrukking als probleemgebeurtenissen; Hersteluitdrukking - OK-gebeurtenissen worden gegenereerd als de probleemuitdrukking wordt geëvalueerd als ONWAAR en de hersteluitdrukking wordt geëvalueerd als WAAR; Geen - in dit geval keert de trigger nooit op eigen houtje terug naar een OK-toestand. |
| Hersteluitdrukking | Logische uitdrukking (optioneel) die aanvullende voorwaarden definieert die moeten worden vervuld voordat het probleem is opgelost, nadat de oorspronkelijke probleemuitdrukking al als ONWAAR is geëvalueerd. Hersteluitdrukking is handig voor trigger hysteresis. Het is niet mogelijk om een probleem op te lossen door alleen hersteluitdrukking als de probleemuitdrukking nog steeds WAAR is. Dit veld is alleen beschikbaar als 'Hersteluitdrukking' is geselecteerd voor Generatie van OK-gebeurtenis. |
| Modus voor generatie van PROBLEEMgebeurtenis | Modus voor het genereren van PROBLEEMgebeurtenissen: Enkele - er wordt een enkele gebeurtenis gegenereerd wanneer een trigger voor de eerste keer in de 'Probleem' toestand gaat; Meerdere - een gebeurtenis wordt gegenereerd bij elke 'Probleem' evaluatie van de trigger. |
| OK-gebeurtenis sluit | Selecteer als OK-gebeurtenis sluit: Alle problemen - alle problemen van deze trigger Alle problemen als tagwaarden overeenkomen - alleen die triggerproblemen met overeenkomende gebeurtenistagwaarden |
| Tag voor overeenkomst | Voer de gebeurtenistag-naam in die moet worden gebruikt voor gebeurteniscorrelatie. Dit veld wordt weergegeven als 'Alle problemen als tagwaarden overeenkomen' is geselecteerd voor het eigenschap OK-gebeurtenis sluit en is in dit geval verplicht. |
| Handmatig sluiten toestaan | Aanvinken om handmatig sluiten van probleemgebeurtenissen die door deze trigger zijn gegenereerd, toe te staan. Handmatig sluiten is mogelijk bij het erkennen van probleemgebeurtenissen. |
| Menunaam | Indien niet leeg, wordt de hier ingevoerde naam (tot 64 tekens) in verschillende frontend-locaties gebruikt als een label voor de trigger-URL die is gespecificeerd in de parameter Menutoegangnaam. Als het leeg is, wordt de standaardnaam Trigger-URL gebruikt. Dezelfde set macros wordt ondersteund als in de trigger URL. |
| Menutoegangs-URL | Indien niet leeg, is de hier ingevoerde URL (tot 2048 tekens) beschikbaar als een koppeling in het gebeurtenismenu in verschillende frontend-locaties, bijvoorbeeld wanneer je op de probleemnaam klikt in Bewaking → Problemen of Problemen dashboard-widget. Dezelfde set macros wordt ondersteund als in de triggernaam, plus {EVENT.ID}, {HOST.ID} en {TRIGGER.ID}. Opmerking: gebruikersmacro's met geheime waarden worden niet opgelost in de URL. |
| Omschrijving | Tekstveld dat wordt gebruikt om meer informatie te verstrekken over deze trigger. Kan instructies bevatten voor het oplossen van een specifiek probleem, contactgegevens van verantwoordelijk personeel, enzovoort. Dezelfde set macros wordt ondersteund als in de trigger naam. |
| Ingeschakeld | Het uitvinken van dit vakje schakelt de trigger uit indien nodig. Problemen van een uitgeschakelde trigger worden niet langer weergegeven in de frontend, maar worden niet verwijderd. |
Het tabblad Tags stelt je in staat om trigger-level tags te definiëren. Alle problemen van deze trigger zullen worden voorzien van de hier ingevoerde waarden.
Daarnaast biedt de optie Geërfd en triggertags de mogelijkheid om tags op sjabloonniveau te bekijken, als de trigger afkomstig is van dat sjabloon. Als er meerdere sjablonen zijn met dezelfde tag, worden deze tags eenmaal weergegeven en worden de sjabloonnamen gescheiden door komma's. Een trigger erft geen hostniveau tags en toont deze niet.
| Parameter | Beschrijving |
|---|---|
| Naam/Waarde | Stel aangepaste tags in om triggergebeurtenissen te markeren. Tags zijn een paar tagnaam en waarde. Je kunt alleen de naam gebruiken of deze combineren met een waarde. Een trigger kan meerdere tags hebben met dezelfde naam, maar verschillende waarden. Gebruikersmacro's, gebruikersmacro's met context, macro's voor laag-niveau detectie en macro functies met {{ITEM.VALUE}}, {{ITEM.LASTVALUE}} en macro's voor laag-niveau detectie worden ondersteund in gebeurtenistags. Macro's voor laag-niveau detectie kunnen worden gebruikt binnen macro-context.{TRIGGER.ID} macro wordt ondersteund in trigger-tagwaarden. Het kan handig zijn om triggers te identificeren die zijn gemaakt van triggerprototypes en bijvoorbeeld problemen van deze triggers tijdens onderhoud te onderdrukken. Als de totale lengte van de uitgezette waarde meer dan 255 bedraagt, wordt deze ingekort tot 255 tekens. Zie alle macros die ondersteund worden voor gebeurtenistags. Gebeurtenistags kunnen worden gebruikt voor gebeurteniscorrelatie, in actievoorwaarden en worden ook gezien in Bewaking → Problemen of de Problemen widget. |
Het tabblad Afhankelijkheden bevat alle afhankelijkheden van de trigger.
Klik op Toevoegen om een nieuwe afhankelijkheid toe te voegen.
Je kunt ook een trigger configureren door een bestaande te openen, op de knop Klonen te klikken en vervolgens op te slaan onder een andere naam.
Uitdrukkingen testen
Het is mogelijk om de geconfigureerde triggeruitdrukking te testen om te zien wat het resultaat van de uitdrukking zou zijn afhankelijk van de ontvangen waarde.
De volgende uitdrukking uit een officieel sjabloon wordt als voorbeeld genomen:
avg(/Cisco IOS SNMPv2/sensor.temp.value[ciscoEnvMonTemperatureValue.{#SNMPINDEX}],5m)>{$TEMP_WARN}
or
last(/Cisco IOS SNMPv2/sensor.temp.status[ciscoEnvMonTemperatureState.{#SNMPINDEX}])={$TEMP_WARN_STATUS}Om de uitdrukking te testen, klik je op Uitdrukkingsconstructor onder het uitdrukkingsveld.
In de Uitdrukkingsconstructor worden alle individuele uitdrukkingen vermeld. Om het testvenster te openen, klik je op Test onder de lijst met uitdrukkingen.
In het testvenster kun je voorbeeldwaarden invoeren ('80', '70', '0', '1' in dit voorbeeld) en vervolgens het resultaat van de uitdrukking bekijken door op de knop Test te klikken.
Het resultaat van de individuele uitdrukkingen en de gehele uitdrukking kan worden bekeken.
"WAAR" betekent dat de opgegeven uitdrukking juist is. In dit specifieke geval A is "80" groter dan de opgegeven waarde {$TEMP_WARN}, "70" in dit voorbeeld. Zoals verwacht verschijnt er een "WAAR" resultaat.
"ONWAAR" betekent dat de opgegeven uitdrukking onjuist is. In dit specifieke geval B moet {$TEMP_WARN_STATUS} "1" gelijk zijn aan de opgegeven waarde, "0" in dit voorbeeld. Zoals verwacht verschijnt er een "ONWAAR" resultaat.
Het gekozen uitdrukkingstype is "OF". Als ten minste één van de opgegeven voorwaarden (A of B in dit geval) WAAR is, zal het algehele resultaat ook WAAR zijn. Dit betekent dat de huidige waarde de waarschuwingswaarde overschrijdt en er een probleem is opgetreden.