1 Aanmaken van een item

Overzicht

Om een item te maken in de Zabbix-frontend, volg deze stappen:

• Ga naar: Datacollectie → Hosts
• Klik op Items in de rij van de host
• Klik op Item maken in de rechterbovenhoek van het scherm
• Voer de parameters van het item in het formulier in

Je kunt ook een item maken door een bestaand item te openen, op de Klonen knop te klikken en het vervolgens onder een andere naam op te slaan.

Configuratie

Het Item tabblad bevat algemene kenmerken van een item.

Alle verplichte invoervelden zijn gemarkeerd met een rood asterisk.

Parameter	Beschrijving
Naam	Naam van het item.
Type	Type van het item. Zie individuele itemtype secties.
Sleutel	Sleutel van het item (maximaal 2048 tekens). De ondersteunde itemsleutels zijn te vinden in de individuele itemtype secties. De sleutel moet uniek zijn binnen een enkele host. Als het sleuteltype 'Zabbix-agent', 'Zabbix-agent (actief)' of 'Eenvoudige controle' is, moet de sleutelwaarde ondersteund worden door de Zabbix-agent of Zabbix-server. Zie ook: het juiste sleutelformaat.
Type van informatie	Type van de gegevens zoals opgeslagen in de database na het uitvoeren van conversies, indien van toepassing. Numeriek (niet-ondertekend) - 64-bits niet-ondertekend geheel getal Numeriek (float) - 64-bits drijvendekommagetall Dit type zal precisie van ongeveer 15 cijfers mogelijk maken en variëren van ongeveer -1.79E+308 tot 1.79E+308 (met uitzondering van PostgreSQL 11 en oudere versies). Het ontvangen van waarden in wetenschappelijke notatie wordt ook ondersteund. Bijvoorbeeld, 1.23E+7, 1e308, 1.1E-4. Karakter - korte tekstgegevens Logboek - lange tekstgegevens met optionele logboekgerelateerde eigenschappen (tijdstempel, bron, ernst, logeventid) Tekst - lange tekstgegevens. Zie ook limieten van tekstgegevens. Voor itemsleutels die gegevens slechts in één specifiek formaat retourneren, wordt automatisch het overeenkomstige type van informatie geselecteerd.
Hostinterface	Selecteer de hostinterface. Dit veld is beschikbaar bij het bewerken van een item op het hostniveau.
Eenheden	Als een eenheidssymbool is ingesteld, zal Zabbix post-processing toepassen op de ontvangen waarde en deze weergeven met de ingestelde eenheidspostfix. Standaard, als de ruwe waarde groter is dan 1000, wordt deze door 1000 gedeeld en dienovereenkomstig weergegeven. Bijvoorbeeld, als je bps instelt en een waarde van 881764 ontvangt, wordt deze weergegeven als 881,76 Kbps. De JEDEC geheugenstandaard wordt gebruikt voor de verwerking van B (byte), Bps (bytes per seconde) eenheden, die door 1024 worden gedeeld. Dus als eenheden zijn ingesteld op B of Bps zal Zabbix weergeven: 1 als 1B/1Bps 1024 als 1KB/1KBps 1536 als 1.5KB/1.5KBps Speciale verwerking wordt gebruikt als de volgende tijdsgerelateerde eenheden worden gebruikt: unixtime - vertaald naar "jjjj.mm.dd uu:mm:ss". Om correct te vertalen, moet de ontvangen waarde van het type Numeriek (niet-ondertekend) zijn. uptime - vertaald naar "uu:mm:ss" of "N dagen, uu:mm:ss" Als bijvoorbeeld de waarde als 881764 (seconden) wordt ontvangen, wordt deze weergegeven als "10 dagen, 04:56:04" s - vertaald naar "jjj mmm ddd uu mm ss ms"; de parameter wordt beschouwd als het aantal seconden. Als bijvoorbeeld de waarde als 881764 (seconden) wordt ontvangen, wordt deze weergegeven als "10d 4u 56m" Er worden slechts 3 belangrijkste bovenste eenheden weergegeven, zoals "1m 15d 5u" of "2u 4m 46s". Als er geen dagen zijn om weer te geven, worden slechts twee niveaus weergegeven - "1m 5u" (geen minuten, seconden of milliseconden worden weergegeven). Wordt vertaald naar "< 1 ms" als de waarde kleiner is dan 0,001. Let op dat als een eenheid is voorzien van !, dan worden er geen eenheidsprefixen/verwerking toegepast op itemwaarden. Zie eenheid conversie.
Interval voor bijwerken	Haal elke N seconden een nieuwe waarde op voor dit item. De maximale toegestane bijwerkingsinterval is 86400 seconden (1 dag). Tijdsachtervoegsels worden ondersteund, bijvoorbeeld 30s, 1m, 2u, 1d. Gebruikermacro's worden ondersteund. Een enkele macro moet het hele veld vullen. Meerdere macro's in een veld of macro's gecombineerd met tekst worden niet ondersteund. Let op: Het bijwerkingsinterval kan alleen worden ingesteld op '0' als er aangepaste intervallen bestaan met een niet-nul waarde. Als het wordt ingesteld op '0' en er bestaat een aangepast interval (flexibel of gepland) met een niet-nul waarde, zal het item worden gepolled tijdens de duur van het aangepaste interval. Let op dat de eerste itempeiling na het actief worden van het item of na wijziging van het bijwerkingsinterval eerder kan plaatsvinden dan de geconfigureerde waarde. Nieuwe items worden binnen 60 seconden na hun aanmaak gecontroleerd, tenzij ze een planning of een flexibel bijwerkingsinterval hebben en het Interval voor bijwerken is ingesteld op 0. Een bestaand passief item kan onmiddellijk voor waarde worden gepeild door op de knop Nu uitvoeren button te drukken.
Aangepaste intervallen	Je kunt aangepaste regels maken voor het controleren van het item: Flexibel - maak een uitzondering voor het Interval voor bijwerken (interval met verschillende frequentie) Plannen - maak een aangepast peilingschema. Zie voor gedetailleerde informatie Aangepaste intervallen. Tijdsachtervoegsels worden ondersteund in het Interval veld, bijvoorbeeld 30s, 1m, 2u, 1d. Gebruikermacro's worden ondersteund. Een enkele macro moet het hele veld vullen. Meerdere macro's in een veld of macro's gecombineerd met tekst worden niet ondersteund. Plannen wordt ondersteund sinds Zabbix 3.0.0. Let op: aangepaste intervallen voor actieve controles worden alleen ondersteund door Zabbix-agent 2.
Bewaarperiode voor geschiedenis	Selecteer een van de volgende opties: Bewaar geen geschiedenis - de itemgeschiedenis wordt niet opgeslagen. Handig voor hoofditems als alleen afhankelijke items geschiedenis moeten bewaren. Deze instelling kan niet worden overschreven door globale instellingen voor housekeeping. Bewaarperiode - geef de duur op voor het bewaren van gedetailleerde geschiedenis in de database (1 uur tot 25 jaar). Oudere gegevens worden verwijderd door de housekeeper. Opgeslagen in seconden. Tijdsachtervoegsels worden ondersteund, bijvoorbeeld 2u, 1d. Gebruikermacro's worden ondersteund. De Bewaarperiode waarde kan globaal worden overschreven in Administratie → Housekeeping. Als een globale overschrijvingsinstelling bestaat, wordt een groen info-icoon weergegeven. Als je je muis erop plaatst, wordt een waarschuwingsbericht weergegeven, bijvoorbeeld Overschreven door globale housekeeping instellingen (1d). Het wordt aanbevolen om de geregistreerde waarden zo kort mogelijk te bewaren om de grootte van de waardegeschiedenis in de database te verminderen. In plaats van een lange geschiedenis van waarden bij te houden, kun je langere gegevens van trends bewaren. Zie ook Geschiedenis en trends.
Bewaarperiode voor trends	Selecteer een van de volgende opties: Bewaar geen trends - trends worden niet opgeslagen. Deze instelling kan niet worden overschreven door globale instellingen voor housekeeping. Bewaarperiode - geef de duur op voor het bewaren van geaggregeerde (uurlijkse min, max, gemiddelde, teller) geschiedenis in de database (1 dag tot 25 jaar). Oudere gegevens worden verwijderd door de housekeeper. Opgeslagen in seconden. Tijdsachtervoegsels worden ondersteund, bijvoorbeeld 24u, 1d. Gebruikermacro's worden ondersteund. De Bewaarperiode waarde kan globaal worden overschreven in Administratie → Housekeeping. Als een globale overschrijvingsinstelling bestaat, wordt een groen info-icoon weergegeven. Als je je muis erop plaatst, wordt een waarschuwingsbericht weergegeven, bijvoorbeeld Overschreven door globale housekeeping instellingen (7d). Let op: Trends bijhouden is niet beschikbaar voor niet-numerieke gegevens - karakter, log en tekst. Zie ook Geschiedenis en trends.
Waarde toewijzing	Pas waarde toewijzing toe op dit item. Waarde toewijzing verandert de ontvangen waarden niet, het is alleen bedoeld voor het weergeven van gegevens. Het werkt met Numeriek(niet-ondertekend), Numeriek(float) en Karakter items. Bijvoorbeeld, "Windows-service staten".
Logboek tijdsindeling	Alleen beschikbaar voor items van het type Logboek. Ondersteunde aanduidingen: * j: Jaar (1970-2038) * M: Maand (01-12) * d: Dag (01-31) * h: Uur (00-23) * m: Minuut (00-59) * s: Seconde (00-59) Als het leeg blijft, wordt het tijdstempel niet geparsed. Bijvoorbeeld, beschouw de volgende regel uit het logboekbestand van de Zabbix-agent: " 23480:20100328:154718.045 Zabbix-agent gestart. Zabbix 1.8.2 (revisie 11211)." Het begint met zes posities voor PID, gevolgd door de datum, tijd en de rest van de regel. Logboek tijdsindeling voor deze regel zou "pppppp:yyyyMMdd:hhmmss" zijn. Let op dat "p" en ":" tekens slechts aanduidingen zijn en alles behalve "jMdhms" kunnen zijn.
Vult host inventaris veld	Je kunt een hostinventarisveld selecteren dat de waarde van het item zal vullen. Dit zal werken als automatische inventaris populatie is ingeschakeld voor de host. Dit veld is niet beschikbaar als Type van informatie is ingesteld op 'Logboek'.
Beschrijving	Voer een beschrijving van het item in. Gebruikermacro's worden ondersteund.
Ingeschakeld	Markeer het vakje om het item in te schakelen zodat het verwerkt wordt.
Laatste gegevens	Klik op de link om de laatste gegevens voor het item te bekijken. Deze link is alleen beschikbaar bij het bewerken van een reeds bestaand item.

Het Tags tabblad maakt het mogelijk om tags op itemniveau te definiëren.

Item waarde voorbewerken

Het tabblad Voorbewerking maakt het mogelijk om transformatieregels te definiëren voor de ontvangen waarden.

Testen

Het is mogelijk om een item te testen en, indien correct geconfigureerd, een echte waarde terug te krijgen. Het testen kan zelfs plaatsvinden voordat een item is opgeslagen.

Testen is beschikbaar voor host- en sjabloonitems, itemprototypen en regels voor low-level discovery. Testen is niet beschikbaar voor actieve items.

Itemtesten is beschikbaar voor de volgende passieve itemtypen:

• Zabbix-agent
• SNMP-agent (v1, v2, v3)
• IPMI-agent
• SSH-checks
• Telnet-checks
• JMX-agent
• Eenvoudige checks (met uitzondering van icmpping*, vmware.* items)
• Zabbix intern
• Berekende items
• Externe checks
• Database monitor
• HTTP-agent
• Script

Om een item te testen, klik je op de knop Testen onder aan het formulier voor itemconfiguratie. Houd er rekening mee dat de Testen knop is uitgeschakeld voor items die niet kunnen worden getest (zoals actieve checks, uitgesloten eenvoudige checks).

Het formulier voor het testen van het item heeft velden voor de vereiste hostparameters (hostadres, poort, proxy-naam/geen proxy) en item-specifieke details (zoals SNMPv2-community of SNMPv3-beveiligingsreferenties). Deze velden zijn contextbewust:

• De waarden worden automatisch ingevuld wanneer dit mogelijk is, bijvoorbeeld voor items die een agent vereisen, door de informatie over de geselecteerde agentinterface 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 Vault macro is, zijn leeg en moeten handmatig worden ingevoerd. Als een itemparameter een geheime macro-waarde 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 in de context van het itemtype niet nodig zijn (bijvoorbeeld het veld hostadres en het veld proxy zijn uitgeschakeld voor berekende items).

Om het item te testen, klik je op Waarde ophalen. Als de waarde succesvol wordt opgehaald, wordt deze in het veld Waarde ingevuld, waarbij de huidige waarde (indien aanwezig) naar het veld Vorige waarde wordt verplaatst, terwijl ook het veld Vorige tijd wordt berekend, dat wil zeggen het tijdsverschil tussen de twee waarden (klikken) en probeert een EOL-sequentie te detecteren en over te schakelen naar CRLF als " \n \r" in de opgehaalde waarde wordt gedetecteerd.

Als de configuratie onjuist is, wordt een foutmelding weergegeven waarin de mogelijke oorzaak wordt beschreven.

Een succesvol opgehaalde waarde van een host kan ook worden gebruikt om preprocessing-stappen te testen.

Formulierknoppen

Knoppen onder aan het formulier stellen je in staat om verschillende handelingen uit te voeren.

	Voeg een item toe. Deze knop is alleen beschikbaar voor nieuwe items.
	Werk de eigenschappen van een item bij.
	Maak een ander item op basis van de eigenschappen van het huidige item.
	Voer onmiddellijk een controle uit voor een nieuwe itemwaarde. Ondersteund voor passieve controles alleen (zie meer details). Opmerking dat bij het onmiddellijk controleren van een waarde de configuratiecache niet wordt bijgewerkt, waardoor de waarde geen zeer recente wijzigingen in de itemconfiguratie weerspiegelt.
	Test of de itemconfiguratie correct is door een waarde op te halen.
	Verwijder de itemgeschiedenis en trends.
	Verwijder het item.
	Annuleer het bewerken van itemeigenschappen.

Limieten voor tekstuele gegevens

De limieten voor tekstuele gegevens zijn afhankelijk van de database-backend. Voordat tekstwaarden in de database worden opgeslagen, worden ze afgekapt om overeen te komen met de limiet van het database-waardetype:

Eenheid conversie

Standaard resulteert het opgeven van een eenheid voor een item in een vermenigvuldigingsvoorvoegsel - bijvoorbeeld, een binnenkomende waarde '2048' met een eenheid 'B' zou worden weergegeven als '2KB'.

Om te voorkomen dat een eenheid wordt geconverteerd, gebruik je het voorvoegsel !, bijvoorbeeld !B. Om beter te begrijpen hoe de conversie werkt met en zonder het uitroepteken, zie je de volgende voorbeelden van waarden en eenheden:

1024 !B → 1024 B
       1024 B → 1 KB
       61 !s → 61 s
       61 s → 1m 1s
       0 !uptime → 0 uptime
       0 uptime → 00:00:00
       0 !! → 0 !
       0 ! → 0

Limiet voor aangepast script

De beschikbare lengte voor aangepaste scripts is afhankelijk van de gebruikte database:

Niet-ondersteunde items

Een item kan niet-ondersteund worden als de waarde ervan om welke reden dan ook niet kan worden opgehaald. Dergelijke items worden nog steeds opnieuw gecontroleerd op hun standaard Update-interval.

Niet-ondersteunde items worden gerapporteerd met de status NIET ONDERSTEUND.