Documentation
Table of Contents
8 Waarde mapping
Overzicht
Voor een meer "menselijke" weergave van ontvangen waarden kunt u waardeafbeeldingen gebruiken die de mapping bevatten tussen numerieke/tekstwaarden en tekstuele weergaven.
Waardemappings kunnen zowel in de Zabbix frontend als in meldingen die worden verzonden via mediatypen worden gebruikt.
Bijvoorbeeld, een item dat de waarde '0' of '1' heeft, kan een waardeafbeelding gebruiken om de waarden op een mensleesbare manier weer te geven:
- '0' => 'Niet Beschikbaar'
- '1' => 'Beschikbaar'
Of, een waardeafbeelding gerelateerd aan back-ups kan zijn:
- 'F' => 'Volledig'
- 'D' => 'Differentieel'
- 'I' => 'Incremental'
In een ander voorbeeld kunnen waardebereiken voor spanning worden toegewezen:
- '<=209' => 'Laag'
- '210-230' => 'OK'
- '>=231' => 'Hoog'
Waardemappings worden gedefinieerd op template- of hostniveau. Eenmaal gedefinieerd zijn ze beschikbaar voor alle items van het respectievelijke template of de host. Er is geen overerving van waardeafbeeldingen - een template-item op een host gebruikt nog steeds de waardeafbeelding van het template; het koppelen van een template met waardeafbeeldingen aan de host maakt de host niet overgenomen de waardeafbeeldingen.
Bij het configureren van items kunt u een waardeafbeelding gebruiken om de manier waarop een itemwaarde wordt weergegeven te "humaniseren". Hiervoor verwijst u naar de naam van een eerder gedefinieerde waardeafbeelding in het veld Waarde mapping.
Waardeafbeelding kan worden gebruikt bij items met Numeriek (ongesigneerd), Numeriek (float) en Karakter type informatie.
Waardemappingen kunnen worden geëxporteerd/geïmporteerd met het bijbehorende template of host.
Waardemappingen kunnen massaal worden bijgewerkt. Zowel het host als template massaal bijwerken formulieren hebben een Waardemapping tabblad voor het massaal bijwerken van waardeafbeeldingen.
Configuratie
Om een waardeafbeelding te definiëren:
- Open een host- of template-configuratieformulier
- Ga naar het tabblad Waarde mapping
- Klik op Toevoegen om een nieuwe mapping toe te voegen
- Klik op de naam van een bestaande mapping om deze te bewerken
Parameters van een waardeafbeelding:
| Parameter | Beschrijving | |
|---|---|---|
| Naam | Unieke naam van een set waardeafbeeldingen. | |
| Mappings | Individuele mappingregels om numerieke/tekstwaarden naar tekstuele weergaven te mappen. Mapping wordt toegepast volgens de volgorde van de mappingregels. Het is mogelijk om mappingregels opnieuw te ordenen door te slepen. Alleen numerieke waarde-types worden ondersteund voor het mappen van bereiken (is groter dan of gelijk aan, is kleiner dan of gelijk aan, in bereik mapping-types). |
|
| Type | Mapping type: equals - gelijke waarden worden gemapt is groter dan of gelijk aan - gelijke of grotere waarden worden gemapt is kleiner dan of gelijk aan - gelijke of kleinere waarden worden gemapt in bereik - waarden in het bereik worden gemapt; het bereik wordt uitgedrukt als <nummer1>-<nummer2>, of <nummer>. Meerdere bereiken worden ondersteund (bijv. 1-10,101-110,201) regexp - waarden die overeenkomen met de reguliere expressie worden gemapt (globale reguliere expressies worden niet ondersteund) standaard - alle overige waarden worden gemapt, behalve die met specifieke mappings |
|
| Waarde | Binnengekomen waarde. Afhankelijk van het mappingtype kan het ook een bereik of reguliere expressie bevatten. |
|
| Gemapt naar | Tekstuele weergave voor de binnengekomen waarde. | |
Alle verplichte invoervelden zijn gemarkeerd met een rode asterisk.
Wanneer de waardeafbeelding in de lijst wordt weergegeven, zijn alleen de eerste drie mappings zichtbaar, terwijl drie puntjes aangeven dat er meer mappings zijn.
Hoe dit werkt
Bijvoorbeeld, een van de vooraf gedefinieerde agent-items 'Zabbix agent ping' maakt gebruik van een template-niveau waardeafbeelding genaamd 'Zabbix agent ping status' om de waarden weer te geven.
In het configuratieformulier voor items kun je een verwijzing naar deze waardeafbeelding zien in het veld Waarde mapping:
Dus in Monitoring → Laatste gegevens wordt de mapping gebruikt om 'Up' weer te geven (met de ruwe waarde tussen haakjes).
In de sectie Laatste gegevens worden weergegeven waarden ingekort tot 20 tekens. Als waardeafbeelding wordt gebruikt, wordt deze inkorting niet toegepast op de gemapte waarde, maar alleen op de ruwe waarde afzonderlijk (weergegeven tussen haakjes).
Een waarde die wordt weergegeven in een leesbare vorm is ook gemakkelijker te begrijpen bij het ontvangen van meldingen.
Zonder een vooraf gedefinieerde waardeafbeelding zou je alleen dit krijgen:
In dit geval zou je moeten raden waar '1' voor staat of documentatie moeten doorzoeken om erachter te komen.