Documentation
Table of Contents
2 Voorverwerking van itemwaarde
Overzicht
Voorverwerking maakt het mogelijk om transformatieregels te definiëren voor de ontvangen itemwaarden. Eén of meerdere transformaties zijn mogelijk voordat ze worden opgeslagen in de database.
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 de voorverwerking worden doorgegeven, van het string-type zijn. De conversie naar het gewenste waarde-type (zoals gedefinieerd in de itemconfiguratie) wordt uitgevoerd aan het einde van de voorverwerkingspijplijn; conversies kunnen echter ook plaatsvinden als dat nodig is voor de betreffende voorverwerkingsstap. Zie voorverwerkingsdetails voor meer technische informatie.
Zie ook: Gebruiksvoorbeelden
Configuratie
Voorverwerkingsregels worden gedefinieerd in het tabblad Voorverwerking van het onderdeel configuratie formulier.
Een onderdeel wordt niet ondersteund als een van de voorverwerkingsstappen mislukt, tenzij Aangepaste actie bij fout foutafhandeling (beschikbaar voor ondersteunde transformaties) is geconfigureerd om de waarde te negeren of om een opgegeven waarde in te stellen.
Voor logonderdelen zal logmetadata (zonder waarde) altijd de onderdeelstatus resetten naar "niet ondersteund" en het onderdeel weer ondersteund maken, zelfs als de initiële fout optrad na ontvangst van een logwaarde van de agent.
Gebruikersmacro's en gebruikersmacro's met context worden ondersteund in voorverwerkingsparameters van onderdeelwaarden, inclusief JavaScript-code.
De context wordt genegeerd wanneer een macro wordt vervangen door zijn waarde. De macrowaarde wordt ongewijzigd in de code ingevoegd, het is niet mogelijk om extra ontsnappingstekens 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 | Omschrijving | |
| Tekst | ||
| Reguliere expressie | Zoek de waarde die overeenkomt 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 onderdeel niet ondersteund. Parameters: pattern - reguliere expressie output - uitvoeropmaak sjabloon. Een \N (waar N=1…9) escape sequentie wordt vervangen door de Ne gerelateerde overeenkomende groep. Een \0 escape sequentie wordt vervangen door de overeenkomende tekst. Raadpleeg het gedeelte reguliere expressies voor enkele bestaande voorbeelden. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt 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 vinden en te vervangen reeks, hoofdlettergevoelig (verplicht) vervanging - de reeks waarmee de zoekreeks wordt vervangen. De vervangende reeks kan ook leeg zijn, waardoor de zoekreeks effectief wordt verwijderd wanneer deze wordt gevonden. Het is mogelijk om ontsnappingssequenties te gebruiken om te zoeken naar of line breaks, carriage return, tabs en spaties te vervangen "\n \r \t \s"; de backslash kan worden ontsnapt als "\\" en ontsnappingssequenties kunnen worden ontsnapt als "\\n". Het ontsnappen van regelafbrekingen, carriage return en tabs wordt automatisch uitgevoerd tijdens low-level discovery. |
|
| Bijsnijden | Verwijder opgegeven tekens van het begin en het einde van de waarde. | |
| Rechts bijsnijden | Verwijder opgegeven tekens van het einde van de waarde. | |
| Links bijsnijden | Verwijder opgegeven tekens van het begin van de waarde. | |
| Gestructureerde gegevens | ||
| XML XPath | Waarde of fragment uit XML-gegevens extraheren met behulp van XPath-functionaliteit. Om deze optie te laten werken, moet de Zabbix-server worden 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>Merk op dat namespaces niet worden ondersteund. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| JSON-pad | Waarde of fragment uit JSON-gegevens extraheren met behulp van JSON-pad functionaliteit. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| CSV naar JSON | Converteer gegevens van een CSV-bestand naar JSON-indeling. Zie voor meer informatie: CSV naar JSON-voorverwerking. |
|
| XML naar JSON | Converteer gegevens in XML-indeling naar JSON. Zie voor meer informatie: Serialisatieregels. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| SNMP | ||
| SNMP-waarde doorlopen | Waarde extraheren op basis van de opgegeven OID/MIB-naam en opmaakopties toepassen: Onveranderd - hex-tekenreeks retourneren als ongeëscapete hex-tekenreeks; UTF-8 van hex-TEKENREEKS - hex-tekenreeks converteren naar UTF-8-tekenreeks; MAC van hex-TEKENREEKS - hex-tekenreeks valideren als MAC-adres en een juiste MAC-adresreeks retourneren (waarbij spaties worden vervangen door ':');Integer van BITS - de eerste 8 bytes van een bitreeks, uitgedrukt als een reeks hex-tekenreeksen (bijv. "1A 2B 3C 4D"), converteren naar een 64-bits ondertekend geheel getal. In bitreeksen langer dan 8 bytes worden opeenvolgende bytes genegeerd. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| SNMP-waarden naar JSON | Converteer SNMP-waarden naar JSON. Specificeer een veldnaam in de JSON en het overeenkomstige SNMP OID-pad. Veldwaarden worden ingevuld door waarden in het opgegeven SNMP OID-pad. Je kunt deze voorverwerkingsstap gebruiken voor SNMP OID-ontdekking. Vergelijkbare opmaakopties voor waarden als in de SNMP-waarde doorlopen stap zijn beschikbaar. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Rekenkunde | ||
| Aangepaste vermenigvuldiger | Vermenigvuldig de waarde met het opgegeven gehele getal of het zwevende kommagetal. Gebruik deze optie om waarden die zijn ontvangen in KB, MBps, enzovoort om te zetten naar B, Bps. Anders kan Zabbix de voorvoegsels (K, M, G, enzovoort) niet correct instellen. Opmerking: als het itemtype van de informatie Numeriek (ongesigneerd) is, worden binnenkomende waarden met een fractioneel deel afgerond (dat wil zeggen, '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 opgelost tot een geheel getal of een zwevend kommagetal. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Wijziging | ||
| Eenvoudige wijziging | Bereken het verschil tussen de huidige en vorige waarde. Berekend 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, verwerpt Zabbix dat verschil (sla niets op) en wacht op een andere waarde. Per item is slechts één wijzigingsbewerking toegestaan. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Wijziging per seconde | Bereken de snelheid van de waardeverandering (verschil tussen de huidige en 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 bijzonder nuttig om de snelheid per seconde te verkrijgen voor een voortdurend groeiende waarde. Als de huidige waarde kleiner is dan de vorige waarde, verwerpt Zabbix dat verschil (sla niets op) en wacht op een andere waarde. Dit helpt om correct te werken met bijvoorbeeld het omwikkelen (overloop) van 32-bits SNMP-tellers. Opmerking: Aangezien deze berekening zwevendekomma-getallen kan produceren, 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 waarbij het decimale deel belangrijk is. Als de zwevendekomma-waarden groot zijn en de 'float'-veldlengte kunnen overschrijden, waardoor de gehele waarde verloren kan gaan, wordt eigenlijk voorgesteld om Numeriek (ongesigneerd) te gebruiken en dus alleen het decimale deel af te snijden. Per item is slechts één wijzigingsbewerking toegestaan. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Cijferstelsels | ||
| Booleaans naar decimaal | Converteer de waarde van booleaanse indeling naar decimaal. De tekstuele weergave wordt vertaald naar 0 of 1. Zo wordt 'WAAR' opgeslagen als 1 en 'ONWAAR' als 0. Alle waarden worden op een hoofdletterongevoelige manier overeenkomstig gemaakt. Momenteel herkende waarden zijn, voor: WAAR - waar, w, ja, j, aan, op, actief, ingeschakeld, beschikbaar, oké, master ONWAAR - onwaar, o, nee, n, uit, af, inactief, uitgeschakeld, niet beschikbaar, err, slave Bovendien wordt elke niet-nul numerieke waarde beschouwd als WAAR en nul wordt beschouwd als ONWAAR. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Octaal naar decimaal | Converteer de waarde van octale indeling naar decimaal. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. |
|
| Hexadecimaal naar decimaal | Converteer de waarde van hexadecimale indeling naar decimaal. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt 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 parameter veld klikt of op een potloodpictogram klikt. Merk op dat de beschikbare lengte van JavaScript afhankelijk is van de gebruikte database. Voor meer informatie, zie: Voorverwerking met JavaScript. |
|
| Validatie | ||
| Binnen bereik | Definieer een bereik waarin een waarde moet liggen door minimale/maximale waarden (inclusief) op te geven. Numerieke waarden worden geaccepteerd (inclusief elk aantal cijfers, een optioneel decimaal deel en een optioneel exponentieel deel, negatieve waarden). Gebruikersmacro's en macro's voor lage-niveau-ontdekking kunnen worden gebruikt. De minimale waarde moet kleiner zijn dan de maximale waarde. Er moet ten minste één waarde zijn opgegeven. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt 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 Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt 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 mag voldoen. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt 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 applicatieniveau dat zich op JSONPath bevindt. Stop met verwerken als dit is gelukt en het bericht niet leeg is; anders ga door met de waarde die vóór deze voorverwerkingsstap stond. Houd er rekening mee dat deze fouten van externe services aan de gebruiker worden gemeld zoals ze zijn, zonder toevoeging van informatie over de voorverwerkingsstap. Er wordt geen fout gemeld in geval van mislukte verwerking van ongeldige JSON. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt 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 applicatieniveau dat zich op XPath bevindt. Stop met verwerken als dit is gelukt en het bericht niet leeg is; anders ga door met de waarde die vóór deze voorverwerkingsstap stond. Houd er rekening mee dat deze fouten van externe services aan de gebruiker worden gemeld zoals ze zijn, zonder toevoeging van informatie over de voorverwerkingsstap. Er wordt geen fout gemeld in geval van mislukte verwerking van ongeldige XML. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt 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 applicatieniveau met behulp van een reguliere expressie. Stop met verwerken als dit is gelukt en het bericht niet leeg is; anders ga door met de waarde die vóór deze voorverwerkingsstap stond. Houd er rekening mee dat deze fouten van externe services aan de gebruiker worden gemeld zoals ze zijn, zonder toevoeging van informatie over de voorverwerkingsstap. Parameters: pattern - reguliere expressie output - uitvoerformatteringssjabloon. Een \N (waar N=1…9) escape-sequentie wordt vervangen door de N-de overeenkomende groep. Een \0 escape-sequentie wordt vervangen door de overeenkomende tekst. Als je het selectievakje Aangepaste actie 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 het geval van een mislukte voorverwerkingsstap wordt het onderdeel niet ongeschikt gemaakt 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 optrad bij het ophalen van de itemwaarde. Normaal gesproken zou dit ertoe leiden dat het item niet-ondersteund wordt, maar je kunt dit gedrag aanpassen door de Aangepaste actie bij fout foutafhandelingsopties op te geven: 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 het geval van een mislukte voorverwerkingsstap wordt het item niet ongeschikt gemaakt als de optie om de waarde te negeren of een gespecificeerde waarde in te stellen is geselecteerd. Houd er rekening mee dat voor deze voorverwerkingsstap het selectievakje Aangepaste actie bij fout grijs wordt weergegeven en altijd is gemarkeerd. Deze stap wordt altijd als eerste uitgevoerd en wordt boven alle andere stappen geplaatst nadat wijzigingen aan het item zijn opgeslagen. Het kan slechts één keer worden gebruikt. Ondersteund sinds 5.2.0. |
|
| Throttling | ||
| Ongewijzigde waarden negeren | Negeren van een waarde als deze niet is gewijzigd. Als een waarde wordt genegeerd, wordt deze niet in de database opgeslagen en heeft de Zabbix-server geen kennis van het feit dat deze waarde is ontvangen. Er worden geen triggerexpressies geëvalueerd, als gevolg hiervan worden er geen problemen voor bijbehorende triggers gemaakt/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, zal er geen trendgegevens zijn voor dat uur als er geen waarde is opgeslagen gedurende een uur. Slechts één throttling-optie kan worden opgegeven voor een item. Houd er rekening mee dat in het geval van een zeer klein verschil (minder dan 0,000001) tussen de waarden van de items die worden bewaakt door Zabbix-proxy, het mogelijk is dat negeren niet correct wordt uitgevoerd door de proxy, en de waarden worden opgeslagen in de geschiedenis als dezelfde waarde, tenzij de Zabbix-serverdatabase wordt geüpgraded. |
|
| Ongewijzigde waarden negeren met interval | Negeren van een waarde als deze niet is gewijzigd binnen de gedefinieerde tijdsperiode (in seconden). Positieve gehele getallen worden ondersteund om de seconden op te geven (minimum - 1 seconde). Tijdsachtervoegsels kunnen worden gebruikt in dit veld (bijv. 30s, 1m, 2u, 1d). Gebruikersmacro's en macro's voor lage-niveau-ontdekking kunnen worden gebruikt in dit veld. Als een waarde wordt genegeerd, wordt deze niet in de database opgeslagen en heeft de Zabbix-server geen kennis van het feit dat deze waarde is ontvangen. Er worden geen triggerexpressies geëvalueerd, als gevolg hiervan worden er geen problemen voor bijbehorende triggers gemaakt/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, zal er geen trendgegevens zijn voor dat uur als er geen waarde is opgeslagen gedurende een uur. Slechts één throttling-optie kan worden opgegeven voor een item. Houd er rekening mee dat in het geval van een zeer klein verschil (minder dan 0,000001) tussen de waarden van de items die worden bewaakt door Zabbix-proxy, het mogelijk is dat negeren niet correct wordt uitgevoerd door de proxy, en de waarden worden opgeslagen in de geschiedenis als dezelfde waarde, tenzij de Zabbix-serverdatabase wordt geüpgraded. |
|
| Prometheus | ||
| Prometheus patroon | Gebruik de volgende query om de vereiste gegevens uit Prometheus-metrics te extraheren. Zie Prometheus-controles voor meer details. |
|
| Prometheus naar JSON | Zet de vereiste Prometheus-metrics om naar JSON-formaat. Zie Prometheus-controles voor meer details. |
|
Voor de voorverwerkingsstappen van wijziging en throttling moet Zabbix de laatste waarde onthouden om de nieuwe waarde te berekenen/vergelijken zoals vereist. Deze vorige waarden worden behandeld door de voorverwerkings beheerder. Als de Zabbix-server of -proxy wordt herstart of als er wijzigingen worden aangebracht aan de voorverwerkingsstappen, wordt de laatste waarde van het betreffende item gereset, wat resulteert in:
- voor Eenvoudige verandering, Verandering per seconde stappen - de volgende waarde zal worden genegeerd omdat er geen vorige waarde is om de verandering te berekenen vanaf;
- voor Ongewijzigde waarden negeren, Ongewijzigde waarden negeren met interval stappen - de volgende waarde wordt nooit genegeerd, zelfs niet als dit wel had gemoeten vanwege de regels voor het negeren.
Het Type informatie parameter 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 aanmaken voor een gedetailleerde beschrijving van de parameter.
Als je een aangepaste vermenigvuldiger gebruikt of de waarde opslaat als Verandering per seconde voor items met het type informatie ingesteld op Numeriek (ongesigneerd) en de resulterende berekende waarde is eigenlijk een zwevend komma getal, 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 van hypothetische waarde
| Parameter | Beschrijving |
|---|---|
| Waarde ophalen van host | Als je een hypothetische waarde wilt testen, laat dit vakje dan niet aangevinkt. Zie ook: Echte waarde testen. |
| Waarde | Voer de invoerwaarde in om te testen. Klikken in het parameter veld of op de bekijk/bewerk knop opent een tekstgebied om de waarde in te voeren of een codeblok. |
| Niet ondersteund | Vink dit vakje aan om een niet-ondersteunde waarde te testen. Deze optie is handig om de voorverwerkingsstap Controleren op niet-ondersteunde waarde te testen. |
| Tijd | Tijd van de invoerwaarde wordt weergegeven: nu (alleen-lezen). |
| Vorige waarde | Voer een vorige invoerwaarde in om te vergelijken. Alleen voor Wijziging en Throttling voorverwerkingsstappen. |
| Vorige tijd | Voer de vorige tijd van de invoerwaarde in om te vergelijken. Alleen voor Wijziging en Throttling voorverwerkingsstappen. De standaardwaarde is gebaseerd op de waarde van het veld 'Bijwerkinterval' van het item (als '1m', dan wordt dit veld ingevuld met nu-1m). Als er niets wordt gespecificeerd of de gebruiker heeft geen toegang tot de host, dan is de standaardwaarde nu-30s. |
| Macros | Als er macro's worden gebruikt, worden ze vermeld samen met hun waarden. De waarden kunnen worden bewerkt voor testdoeleinden, maar de wijzigingen worden alleen opgeslagen binnen de testcontext. |
| Regeleinde sequentie | Selecteer de regeleinde sequentie voor invoerwaarden over meerdere regels: LF - LF (line feed) sequentie CRLF - CRLF (carriage-return line-feed) sequentie. |
| Voorverwerkingsstappen | Voorverwerkingsstappen worden vermeld; het testresultaat wordt weergegeven voor elke stap nadat de Test knop is ingedrukt. Als de stap tijdens het testen is mislukt, wordt een foutpictogram weergegeven. De foutbeschrijving wordt weergegeven bij mouseover. In geval van "Aangepast bij mislukken" voor de stap en die actie wordt uitgevoerd, verschijnt er direct na de rij van de voorverwerkingsteststap een nieuwe regel die laat zien 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 wanneer alle stappen samen worden getest (wanneer je op de knop Alle stappen testen klikt). Het type conversie naar het waarde type van het item wordt ook weergegeven, bijvoorbeeld Resultaat omgezet naar Numeriek (ongesigneerd). |
Klik op Testen om het resultaat na elke voorverwerkingsstap te zien.
Testwaarden worden opgeslagen tussen test sessies voor individuele stappen of alle stappen, zodat de gebruiker voorverwerkingsstappen of itemconfiguratie kan wijzigen en vervolgens terug kan keren naar het testvenster zonder opnieuw informatie te hoeven invoeren. Waarden gaan wel verloren bij het vernieuwen van de pagina.
Het testen wordt uitgevoerd door de Zabbix-server. De frontend stuurt een overeenkomstig verzoek naar de server en wacht op het resultaat. Het verzoek bevat de invoerwaarde en de voorverwerkingsstappen (met uitgebreide gebruikersmacro's). Voor Wijziging en Throttling stappen kunnen optioneel een vorige waarde en tijd worden opgegeven. De server reageert met resultaten voor elke voorverwerkingsstap.
Alle technische fouten of fouten in validatie van invoer worden weergegeven in de foutenbox boven aan 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 deze (hostadres, poort, proxy naam/geen proxy) en specifieke details voor het item (zoals SNMPv2-community of SNMPv3-beveiligingsreferenties). Deze velden zijn contextgevoelig:
- De waarden worden indien mogelijk vooraf ingevuld, bijvoorbeeld voor items die een agent vereisen, door de informatie van de geselecteerde agentinterface van de host te nemen.
- De waarden moeten handmatig worden ingevuld voor template items.
- Waarden van platte tekst macro's worden opgelost.
- Velden waarin de waarde (of een deel van de waarde) een geheim of Vault-macro is, zijn leeg en moeten handmatig worden ingevoerd. Als een itemparameter een waarde bevat van een geheime macro, 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 (bijvoorbeeld de hostadres- en proxyvelden zijn uitgeschakeld voor berekende items).
- Klik op Waarde ophalen en testen om de voorverwerking te testen.
Als je een waardeafbeelding hebt gespecificeerd in het itemconfiguratieformulier ('Waarde tonen' veld), zal het dialoogvenster voor itemtests na het eindresultaat nog een regel tonen, genaamd 'Resultaat met toegepaste waardeafbeelding'.
Parameters die specifiek zijn voor het ophalen van een echte waarde van een host:
| Parameter | Beschrijving |
|---|---|
| Waarde ophalen van host | Vink dit vakje 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, enz.) |
Zie SNMP-bewaking configureren voor extra details over het configureren van een SNMP-interface (v1, v2 en v3). Deze velden worden automatisch ingevuld vanuit 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 rest van de parameters, zie Het testen van hypothetische waarde hierboven.