Table of Contents
2 Voorverwerking van itemwaarde
Overzicht
Voorverwerking maakt het mogelijk om transformatieregels voor de ontvangen itemwaarden te definiëren. Eén of meerdere transformaties zijn mogelijk voordat ze in de database worden opgeslagen.
Transformaties worden uitgevoerd in de volgorde waarin ze zijn gedefinieerd. Voorverwerking wordt uitgevoerd door de Zabbix-server of -proxy (indien items worden bewaakt door een proxy).
Merk op dat alle waarden die aan voorverwerking worden doorgegeven van het stringtype zijn. De conversie naar het gewenste waarde-type (zoals gedefinieerd in de itemconfiguratie) wordt aan het einde van de voorverwerkingsstroom uitgevoerd; conversies kunnen echter ook plaatsvinden als dat vereist is door de overeenkomstige voorverwerkingsstap. Raadpleeg voorverwerkingsdetails voor meer technische informatie.
Zie ook: Gebruiksvoorbeelden
Configuratie
Voorverwerkingsregels worden gedefinieerd in het tabblad Voorverwerking van het configuratieformulier van het item.
Een item wordt niet-ondersteund als een van de voorverwerkingsstappen mislukt, tenzij Aangepast bij fout foutafhandeling (beschikbaar voor ondersteunde transformaties) is geconfigureerd om de waarde te negeren of een gespecificeerde waarde in te stellen.
Voor logboekitems zal logboekmetadata (zonder waarde) de niet-ondersteunde status van een item altijd resetten en het item weer ondersteund maken, zelfs als de initiële fout optrad na ontvangst van een logboekwaarde van de agent.
Gebruikersmacro's en gebruikersmacro's met context worden ondersteund in de voorverwerkingsparameters van de itemwaarde, inclusief JavaScript-code.
De context wordt genegeerd wanneer een macro wordt vervangen door zijn waarde. De waarde van de macro wordt ongewijzigd in de code ingevoegd, het is niet mogelijk om extra ontsnapping toe te voegen voordat de waarde in de JavaScript-code wordt geplaatst. Houd er rekening mee dat dit in sommige gevallen JavaScript-fouten kan veroorzaken.
| Type | ||
|---|---|---|
| Transformatie | Beschrijving | |
| Tekst | ||
| Reguliere expressie | Match de waarde met de reguliere expressie <pattern> en vervang de waarde door <output>. De reguliere expressie ondersteunt het extraheren van maximaal 10 vastgelegde groepen met de \N sequentie. Als de invoerwaarde niet overeenkomt, wordt het item niet ondersteund. Parameters: pattern - reguliere expressie output - uitvoeropmaak sjabloon. Een \N (waar N=1…9) escapesequentie wordt vervangen door de N-de overeenkomende groep. Een \0 escapesequentie wordt vervangen door de overeenkomende tekst. Zie het gedeelte reguliere expressies voor enkele bestaande voorbeelden. Als je het selectievakje Aangepast bij fout aanvinkt, is het mogelijk om aangepaste foutafhandelingsopties te selecteren: ofwel om de waarde te negeren, een gespecificeerde waarde in te stellen, of een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Vervangen | Zoek de zoekreeks en vervang deze door een andere (of niets). Alle voorkomens van de zoekreeks worden vervangen. Parameters: zoekreeks - de te zoeken en te vervangen string, hoofdlettergevoelig (vereist) vervanging - de string waarmee de zoekreeks moet worden vervangen. De vervangende string kan ook leeg zijn, waardoor de zoekreeks effectief wordt verwijderd wanneer deze wordt gevonden. Het is mogelijk om escapesequenties te gebruiken om te zoeken naar of vervangen van regelovergangen, wagenretour, tabbladen en spaties "\n \r \t \s"; de backslash kan worden ontsnapt als "\\" en escapesequenties kunnen worden ontsnapt als "\\n". Escapen van regelovergangen, wagenretours en tabbladen gebeurt automatisch tijdens ontdekking op laag niveau. |
|
| Trimmen | Verwijder gespecificeerde tekens aan het begin en einde van de waarde. | |
| Rechts trimmen | Verwijder gespecificeerde tekens aan het einde van de waarde. | |
| Links trimmen | Verwijder gespecificeerde tekens aan het begin van de waarde. | |
| Gestructureerde gegevens | ||
| XML XPath | Extraheren van waarde of fragment uit XML-gegevens met behulp van de XPath-functionaliteit. Voor deze optie om te werken, moet de Zabbix-server zijn gecompileerd met libxml-ondersteuning. Voorbeelden: number(/document/item/value) zal 10 extraheren uit <document><item><value>10</value></item></document>number(/document/item/@attribute) zal 10 extraheren uit <document><item attribute="10"></item></document>/document/item zal <item><value>10</value></item> extraheren uit <document><item><value>10</value></item></document>Houd er rekening mee dat namespaces niet worden ondersteund. Als je het selectievakje Aangepast bij fout aanvinkt, is het mogelijk om aangepaste foutafhandelingsopties te selecteren: ofwel om de waarde te negeren, een gespecificeerde waarde in te stellen, of een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| JSON-pad | Waarde of fragment extraheren uit JSON-gegevens met behulp van JSONPad-functionaliteit. Als je het selectievakje Aangepast bij fout aanvinkt, is het mogelijk om aangepaste foutafhandelingsopties te selecteren: ofwel om de waarde te negeren, een gespecificeerde waarde in te stellen, of een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| CSV naar JSON | Converteer gegevens van CSV-bestanden naar JSON-indeling. Zie voor meer informatie: Voorverwerking CSV naar JSON. |
|
| XML naar JSON | Converteer gegevens in XML-indeling naar JSON. Zie voor meer informatie: Serialisatieregels. Als je het selectievakje Aangepast bij fout aanvinkt, is het mogelijk om aangepaste foutafhandelingsopties te selecteren: ofwel om de waarde te negeren, een gespecificeerde waarde in te stellen, of een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Rekenkundig | ||
| Aangepaste vermenigvuldiger | Vermenigvuldig de waarde met het gespecificeerde gehele getal of het drijvendekommagetal. Gebruik deze optie om waarden ontvangen in KB, MBps, enzovoort om te zetten in B, Bps. Anders kan Zabbix geen prefixen (K, M, G, enz.) correct instellen. Opmerking: als het itemtype van de informatie Numeriek (ongesigneerd) is, worden inkomende waarden met een deel achter de komma afgekapt (bijvoorbeeld '0.9' wordt '0') voordat de aangepaste vermenigvuldiger wordt toegepast. Ondersteund: wetenschappelijke notatie, bijvoorbeeld 1e+70 (sinds versie 2.2); gebruikersmacro's en LLD-macro's (sinds versie 4.0); tekenreeksen die macro's bevatten, bijvoorbeeld {#MACRO}e+10, {$MACRO1}e+{$MACRO2} (sinds versie 5.2.3)De macro's moeten worden omgezet in een geheel getal of een drijvendekommagetal. Als je het selectievakje Aangepast bij fout aanvinkt, is het mogelijk om aangepaste foutafhandelingsopties te selecteren: ofwel om de waarde te negeren, een gespecificeerde waarde in te stellen, of een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Verandering | ||
| Eenvoudige verandering | Bereken het verschil tussen de huidige en de vorige waarde. Geëvalueerd als waarde-vorige_waarde, waarbij waarde - huidige waarde; vorige_waarde - eerder ontvangen waarde Deze instelling kan nuttig zijn om een voortdurend groeiende waarde te meten. Als de huidige waarde kleiner is dan de vorige waarde, negeert Zabbix dat verschil (slaat niets op) en wacht op een andere waarde. Per item is slechts één veranderingsbewerking toegestaan. Als je het selectievakje Aangepast bij fout aanvinkt, is het mogelijk om aangepaste foutafhandelingsopties te selecteren: ofwel om de waarde te negeren, een gespecificeerde waarde in te stellen, of een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Verandering per seconde | Bereken de snelheid van de waardeverandering (het verschil tussen de huidige en de vorige waarde) per seconde. Berekend als (waarde-vorige_waarde)/(tijd-vorige_tijd), waarbij waarde - huidige waarde; vorige_waarde - eerder ontvangen waarde; tijd - huidige tijdstempel; vorige_tijd - tijdstempel van de vorige waarde. Deze instelling is uiterst nuttig om de snelheid per seconde te krijgen voor een voortdurend groeiende waarde. Als de huidige waarde kleiner is dan de vorige waarde, negeert Zabbix dat verschil (slaat niets op) en wacht op een andere waarde. Dit helpt om correct te werken met bijvoorbeeld een omslag (overflow) van 32-bits SNMP-tellers. Opmerking: Aangezien deze berekening drijvendekommagetallen kan opleveren, wordt aanbevolen om het 'Type informatie' in te stellen op Numeriek (float), zelfs als de binnenkomende ruwe waarden gehele getallen zijn. Dit is vooral relevant voor kleine getallen waar het decimale deel van belang is. Als de drijvendekommagetallen groot zijn en de lengte van het 'float'-veld kan overschrijden, waardoor de hele waarde verloren kan gaan, wordt eigenlijk voorgesteld om Numeriek (ongesigneerd) te gebruiken en dus alleen het decimale deel af te kappen. Per item is slechts één veranderingsbewerking toegestaan. Als je het selectievakje Aangepast bij fout aanvinkt, is het mogelijk om aangepaste foutafhandelingsopties te selecteren: ofwel om de waarde te negeren, een gespecificeerde waarde in te stellen, of een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Nummerstelsels | ||
| Booleaans naar decimaal | Zet de waarde om van booleaanse indeling naar decimale indeling. De tekstuele representatie wordt vertaald naar 0 of 1. Zo wordt 'WAAR' opgeslagen als 1 en 'ONWAAR' wordt opgeslagen als 0. Alle waarden worden in hoofdletteronafhankelijke zin gematcht. Momenteel herkende waarden zijn: WAAR - waar, t, ja, j, aan, up, running, enabled, beschikbaar, ok, master ONWAAR - onwaar, f, nee, n, uit, down, unused, disabled, unavailable, err, slave Bovendien wordt elke niet-nul numerieke waarde beschouwd als WAAR en nul wordt beschouwd als ONWAAR. Als je het selectievakje Aangepast bij fout aanvinkt, is het mogelijk om aangepaste foutafhandelingsopties te selecteren: ofwel om de waarde te negeren, een gespecificeerde waarde in te stellen, of een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Octaal naar decimaal | Zet de waarde om van octale indeling naar decimale indeling. Als je het selectievakje Aangepast bij fout aanvinkt, is het mogelijk om aangepaste foutafhandelingsopties te selecteren: ofwel om de waarde te negeren, een gespecificeerde waarde in te stellen, of een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Hexadecimaal naar decimaal | Zet de waarde om van hexadecimale indeling naar decimale indeling. Als je het selectievakje Aangepast bij fout aanvinkt, is het mogelijk om aangepaste foutafhandelingsopties te selecteren: ofwel om de waarde te negeren, een gespecificeerde waarde in te stellen, of een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Aangepaste scripts | ||
| JavaScript | Voer JavaScript-code in in het blok dat verschijnt wanneer je op het veld of op een potloodpictogram klikt. Merk op dat de beschikbare lengte van JavaScript afhankelijk is van de gebruikte database. Voor meer informatie, zie: JavaScript-voorverwerking. |
|
| Validatie | ||
| In bereik | Definieer een bereik waarin een waarde moet liggen door minimum/maximumwaarden (inclusief) op te geven. Numerieke waarden worden geaccepteerd (inclusief elk aantal cijfers, optioneel decimaal deel en optioneel exponentieel deel, negatieve waarden). Gebruikersmacro's en low-level discovery-macro's kunnen worden gebruikt. De minimale waarde moet kleiner zijn dan de maximale waarde. Er moet ten minste één waarde bestaan. Als je het selectievakje Aangepast bij fout aanvinkt, is het mogelijk om aangepaste foutafhandelingsopties te selecteren: ofwel om de waarde te negeren, een gespecificeerde waarde in te stellen, of een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Komt overeen met reguliere expressie | Specificeer een reguliere expressie waaraan een waarde moet voldoen. Als je het selectievakje Aangepast bij fout aanvinkt, is het mogelijk om aangepaste foutafhandelingsopties te selecteren: ofwel om de waarde te negeren, een gespecificeerde waarde in te stellen, of een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Komt niet overeen met reguliere expressie | Specificeer een reguliere expressie waaraan een waarde niet moet voldoen. Als je het selectievakje Aangepast bij fout aanvinkt, is het mogelijk om aangepaste foutafhandelingsopties te selecteren: ofwel om de waarde te negeren, een gespecificeerde waarde in te stellen, of een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Controleer op fout in JSON | Controleer op een foutbericht op toepassingsniveau dat zich bevindt op JSONPath. Stop met verwerken als dit succesvol is en het bericht niet leeg is; ga anders verder met verwerken met de waarde die voor deze voorverwerkingsstap werd ontvangen. Merk op dat deze fouten van externe services zoals ze zijn aan de gebruiker worden gerapporteerd, zonder toevoeging van informatie over de voorverwerkingsstap. Er wordt geen fout gerapporteerd in geval van mislukte verwerking van ongeldige JSON. Als je het selectievakje Aangepast bij fout aanvinkt, is het mogelijk om aangepaste foutafhandelingsopties te selecteren: ofwel om de waarde te negeren, een gespecificeerde waarde in te stellen, of een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Controleer op fout in XML | Controleer op een foutbericht op toepassingsniveau dat zich bevindt op XPath. Stop met verwerken als dit succesvol is en het bericht niet leeg is; ga anders verder met verwerken met de waarde die voor deze voorverwerkingsstap werd ontvangen. Merk op dat deze fouten van externe services zoals ze zijn aan de gebruiker worden gerapporteerd, zonder toevoeging van informatie over de voorverwerkingsstap. Er wordt geen fout gerapporteerd in geval van mislukte verwerking van ongeldige XML. Als je het selectievakje Aangepast bij fout aanvinkt, is het mogelijk om aangepaste foutafhandelingsopties te selecteren: ofwel om de waarde te negeren, een gespecificeerde waarde in te stellen, of een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Controleer op fout met behulp van een reguliere expressie | Controleer op een foutbericht op toepassingsniveau met behulp van een reguliere expressie. Stop met verwerken als dit succesvol is en het bericht niet leeg is; ga anders verder met verwerken met de waarde die voor deze voorverwerkingsstap werd ontvangen. Merk op dat deze fouten van externe services zoals ze zijn aan de gebruiker worden gerapporteerd, zonder toevoeging van informatie over de voorverwerkingsstap. Parameters: patroon - reguliere expressie uitvoer - uitvoeropmaak sjabloon. Een \N (waar N=1…9) escapevolgorde wordt vervangen door de N-de overeenkomende groep. Een \0 escapevolgorde wordt vervangen door de overeenkomende tekst. Als je het selectievakje Aangepast bij fout aanvinkt, is het mogelijk om aangepaste foutafhandelingsopties te selecteren: ofwel om de waarde te negeren, een gespecificeerde waarde in te stellen, of een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Controleer op niet-ondersteunde waarde | Controleer of er een fout is opgetreden bij het ophalen van de itemwaarde. Normaal gesproken zou dit ertoe leiden dat het item niet wordt ondersteund, maar je kunt dit gedrag aanpassen door de opties voor aangepaste foutafhandeling (Custom on fail) te specificeren: om de waarde te negeren, om een gespecificeerde waarde in te stellen (die ook in triggers kan worden gebruikt) of om een gespecificeerd foutbericht in te stellen. In geval van een mislukte voorverwerkingsstap wordt het item niet niet-ondersteund als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. Merk op dat voor deze voorverwerkingsstap het selectievakje Aangepast bij fout is uitgeschakeld en altijd is aangevinkt. Deze stap wordt altijd als eerste uitgevoerd en wordt boven alle andere stappen geplaatst na het opslaan van wijzigingen aan het item. Het kan slechts één keer worden gebruikt. Ondersteund sinds 5.2.0. |
|
| Beperking | ||
| Ongewijzigde waarden negeren | Negeer een waarde als deze niet is gewijzigd. Als een waarde wordt genegeerd, wordt deze niet opgeslagen in de database en heeft de Zabbix-server geen kennis van het feit dat deze waarde is ontvangen. Er worden geen triggeruitdrukkingen geëvalueerd en daardoor worden er geen problemen voor bijbehorende triggers aangemaakt/opgelost. Functies werken alleen op basis van gegevens die daadwerkelijk in de database zijn opgeslagen. Aangezien trends worden opgebouwd op basis van gegevens in de database, is er bijvoorbeeld geen trendgegevens voor een uur beschikbaar als er gedurende dat uur geen waarde is opgeslagen. Er kan slechts één beperkingsoptie worden gespecificeerd voor een item. Merk op dat bij een zeer klein verschil (minder dan 0,000001) tussen de waarden van de items die worden bewaakt door een Zabbix-proxy, het mogelijk is dat het negeren niet correct wordt uitgevoerd door de proxy en dat de waarden in de geschiedenis worden opgeslagen als dezelfde waarde. Dit gebeurt tenzij de Zabbix-serverdatabase is geüpgraded. |
|
| Ongewijzigde waarden negeren met hartslag | Negeer een waarde als deze niet is gewijzigd binnen de gedefinieerde tijdsperiode (in seconden). Positieve gehele getallen worden ondersteund om de seconden op te geven (minimaal - 1 seconde). Tijdsvoorvoegsels kunnen worden gebruikt in dit veld (bijv. 30s, 1m, 2u, 1d). Gebruikersmacro's en lage-niveau ontdekkingsmacro's kunnen in dit veld worden gebruikt. Als een waarde wordt genegeerd, wordt deze niet opgeslagen in de database en heeft de Zabbix-server geen kennis van het feit dat deze waarde is ontvangen. Er worden geen triggeruitdrukkingen geëvalueerd en daardoor worden er geen problemen voor bijbehorende triggers aangemaakt/opgelost. Functies werken alleen op basis van gegevens die daadwerkelijk in de database zijn opgeslagen. Aangezien trends worden opgebouwd op basis van gegevens in de database, is er bijvoorbeeld geen trendgegevens voor een uur beschikbaar als er gedurende dat uur geen waarde is opgeslagen. Er kan slechts één beperkingsoptie worden gespecificeerd voor een item. Merk op dat bij een zeer klein verschil (minder dan 0,000001) tussen de waarden van de items die worden bewaakt door een Zabbix-proxy, het mogelijk is dat het negeren niet correct wordt uitgevoerd door de proxy en dat de waarden in de geschiedenis worden opgeslagen als dezelfde waarde. Dit gebeurt tenzij de Zabbix-serverdatabase is geüpgraded. |
|
| Prometheus | ||
| Prometheus patroon | Gebruik de volgende query om de benodigde gegevens uit Prometheus-metrics te halen. Zie Prometheus checks voor meer details. |
|
| Prometheus naar JSON | Converteer benodigde Prometheus-metrics naar JSON-formaat. Zie Prometheus checks voor meer details. |
|
Voor de voorverwerkingsstappen Wijziging en Beperking moet Zabbix de laatste waarde onthouden om de nieuwe waarde te kunnen berekenen/vergelijken zoals vereist. Deze vorige waarden worden behandeld door de voorverwerkingsmanager. Als de Zabbix-server of proxy opnieuw wordt opgestart of als er wijzigingen worden aangebracht in de voorverwerkingsstappen, wordt de laatste waarde van het overeenkomstige item gereset, wat resulteert in:
- voor Eenvoudige wijziging, Wijziging per seconde stappen - de volgende waarde zal worden genegeerd omdat er geen vorige waarde is om de wijziging van te berekenen;
- voor Ongewijzigde waarden negeren, Ongewijzigde waarden negeren met heartbeat stappen - de volgende waarde zal nooit worden genegeerd, zelfs niet als dat wel had gemoeten vanwege de regels voor negeren.
Het Type informatie van het item wordt weergegeven onderaan het tabblad wanneer ten minste één voorverwerkingsstap is gedefinieerd. Indien nodig is het mogelijk om het type informatie te wijzigen zonder het Voorverwerking tabblad te verlaten. Zie Een item creëren voor een gedetailleerde beschrijving van de parameter.
Als u een aangepaste vermenigvuldiger gebruikt of de waarde opslaat als Wijziging per seconde voor items met het type informatie ingesteld op Numeriek (niet-ondertekend) en de resulterende berekende waarde is eigenlijk een zwevend kommagetal, dan wordt de berekende waarde nog steeds geaccepteerd als correct door het trimmen van het decimale deel en het opslaan van de waarde als een geheel getal.
Testen
Het testen van voorverwerkingsstappen is nuttig om ervoor te zorgen dat complexe voorverwerkingspijplijnen de verwachte resultaten opleveren, zonder te hoeven wachten op de ontvangst en voorverwerking van de itemwaarde.
Het is mogelijk om te testen:
- tegen een hypothetische waarde
- tegen een werkelijke waarde van een host
Elke voorverwerkingsstap kan afzonderlijk worden getest en alle stappen kunnen samen worden getest. Wanneer je respectievelijk op de knop Test of Test alle stappen klikt in het blok Acties, wordt een testvenster geopend.
Testen met hypothetische waarde
| Parameter | Omschrijving |
|---|---|
| Waarde ophalen van host | Als je een hypothetische waarde wilt testen, laat deze optie dan niet aangevinkt. Zie ook: Echte waarde testen. |
| Waarde | Voer de invoerwaarde in die je wilt testen. Klikken in het parameter veld of op de bekijken/bewerken knop opent een tekstveld waarin je de waarde kunt invoeren. |
| Niet ondersteund | Vink deze optie aan om een niet-ondersteunde waarde te testen. Deze optie is nuttig om de Check for not supported value voorverwerkingsstap te testen. |
| Tijd | De tijd van de invoerwaarde wordt weergegeven: now (alleen-lezen). |
| Vorige waarde | Voer een vorige invoerwaarde in om te vergelijken. Alleen voor de Change en Throttling voorverwerkingsstappen. |
| Vorige tijd | Voer de tijd van de vorige invoerwaarde in om te vergelijken. Alleen voor de Change en Throttling voorverwerkingsstappen. De standaardwaarde is gebaseerd op de waarde van het veld 'Update-interval' van het item (als het '1m' is, wordt dit veld ingevuld met now-1m). Als er niets is gespecificeerd of de gebruiker geen toegang heeft tot de host, is de standaardwaarde now-30s. |
| Macro's | Als er macro's worden gebruikt, worden ze vermeld samen met hun waarden. De waarden zijn bewerkbaar voor testdoeleinden, maar de wijzigingen worden alleen binnen de testcontext opgeslagen. |
| Einde van regel sequentie | Selecteer de einde van regel sequentie voor invoerwaarden met meerdere regels: LF - LF (line feed) sequentie CRLF - CRLF (carriage-return line-feed) sequentie. |
| Voorverwerkingsstappen | Voorverwerkingsstappen worden vermeld; het resultaat van de test wordt weergegeven voor elke stap nadat je op de knop Test hebt geklikt. Als de stap is mislukt tijdens het testen, wordt er een foutpictogram weergegeven. De foutbeschrijving wordt weergegeven als je met de muis over het pictogram beweegt. In het geval dat "Aangepast bij fout" is gespecificeerd voor de stap en die actie wordt uitgevoerd, verschijnt er een nieuwe regel direct na de rij van de voorverwerkingsstap in de test, waarin wordt weergegeven welke actie is uitgevoerd en welk resultaat dit heeft opgeleverd (fout of waarde). |
| Resultaat | Het uiteindelijke resultaat van het testen van de voorverwerkingsstappen wordt weergegeven in alle gevallen waarin alle stappen samen worden getest (wanneer je op de knop Test alle stappen klikt). Ook wordt het type conversie naar het waarde type van het item weergegeven, bijvoorbeeld Resultaat omgezet naar Numeriek (ongesigneerd). |
Klik op Test om het resultaat na elke voorverwerkingsstap te zien.
Testwaarden worden opgeslagen tussen testsessies voor zowel individuele stappen als voor alle stappen, zodat de gebruiker voorverwerkingsstappen of itemconfiguratie kan wijzigen en vervolgens terug kan keren naar het testvenster zonder opnieuw informatie te hoeven invoeren. De waarden gaan echter verloren bij een vernieuwing van de pagina.
Het testen wordt uitgevoerd door de Zabbix-server. De frontend stuurt een bijbehorend verzoek naar de server en wacht op het resultaat. Het verzoek bevat de invoerwaarde en voorverwerkingsstappen (met uitgebreide gebruikersmacro's). Voor Change en Throttling stappen kunnen een optionele vorige waarde en tijd worden gespecificeerd. De server reageert met resultaten voor elke voorverwerkingsstap.
Alle technische fouten of validatiefouten worden weergegeven in het foutenvak bovenaan het testvenster.
Echte waarde testen
Om voorverwerking te testen met een echte waarde:
- Vink het selectievakje Waarde ophalen van host aan.
- Voer hostparameters in of verifieer ze (hostadres, poort, proxy-naam/geen proxy) en specifieke details van het item (zoals SNMPv2-community of SNMPv3-beveiligingsgegevens). Deze velden zijn contextgevoelig:
- De waarden worden indien mogelijk vooraf ingevuld, d.w.z. voor items die een agent vereisen, door de informatie van de geselecteerde agent-interface van de host over te nemen.
- De waarden moeten handmatig worden ingevuld voor sjabloonitems.
- Waarden van platte tekst macro's worden opgelost.
- Velden waarin de waarde (of een deel van de waarde) een geheim of een Vault macro is, zijn leeg en moeten handmatig worden ingevoerd. Als een willekeurige itemparameter een geheime macrowaarde bevat, wordt het volgende waarschuwingsbericht weergegeven: "Item bevat door de gebruiker gedefinieerde macro's met geheime waarden. Waarden van deze macro's moeten handmatig worden ingevoerd."
- De velden zijn uitgeschakeld wanneer ze niet nodig zijn in de context van het itemtype (bijv. het hostadres en de proxyvelden zijn uitgeschakeld voor berekende items).
- Klik op Waarde ophalen en testen om de voorverwerking te testen.
Als je een waardeomzetting hebt gespecificeerd in het configuratieformulier van het item ('Weergegeven waarde'-veld), zal het dialoogvenster voor itemtest een andere regel laten zien na het definitieve resultaat, genaamd 'Resultaat met toegepaste waardeomzetting'.
Parameters die specifiek zijn voor het ophalen van een echte waarde van een host:
| Parameter | Omschrijving |
|---|---|
| Waarde ophalen van host | Vink dit selectievakje aan om een echte waarde van de host op te halen. |
| Hostadres | Voer het hostadres in. Dit veld wordt automatisch ingevuld met het adres van de hostinterface van het item. |
| Poort | Voer de hostpoort in. Dit veld wordt automatisch ingevuld met de poort van de hostinterface van het item. |
| Aanvullende velden voor SNMP-interfaces (SNMP-versie, SNMP-community, contextnaam, etc.) |
Zie SNMP-bewaking configureren voor aanvullende details over het configureren van een SNMP-interface (v1, v2 en v3). Deze velden worden automatisch ingevuld met de hostinterface van het item. |
| Proxy | Specificeer de proxy als de host wordt bewaakt door een proxy. Dit veld wordt automatisch ingevuld met de proxy van de host (indien van toepassing). |
Voor de overige parameters, zie Testen met hypothetische waarde hierboven.