1 Aanmaken van een item

Overzicht

Om een item te maken in de Zabbix-frontend, doet u het volgende:

• Ga naar: Configuratie → 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 op het formulier

U kunt ook een item maken door een bestaand item te openen, op de Kloon-knop te drukken en het vervolgens onder een andere naam op te slaan.

Configuratie

Het tabblad Item bevat algemene eigenschappen van het item.

Alle verplichte invoervelden zijn gemarkeerd met een rode asterisk.

Parameter	Omschrijving
Naam	Naam van het item.
Type	Type van het item. Zie individuele secties van itemtypen.
Sleutel	Sleutel van het item (maximaal 2048 tekens). De ondersteunde sleutels van items zijn te vinden in de individuele secties van itemtypen. De sleutel moet uniek zijn binnen één 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 sleutel formaat.
Type van informatie	Type gegevens zoals opgeslagen in de database na uitvoeren van conversies, indien van toepassing. Numeriek (ongesigneerd) - 64-bits ongesigneerde integer Numeriek (float) - 64-bits drijvend komma getal Dit type staat precisie toe van ongeveer 15 cijfers en een bereik van ongeveer -1,79E+308 tot 1,79E+308 (met uitzondering van PostgreSQL 11 en eerdere 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 logboek eigenschappen (tijdstempel, bron, ernst, loggebeurtenis-id) Tekst - lange tekstgegevens. Zie ook beperkingen voor tekstgegevens. Voor itemsleutels die gegevens retourneren in slechts één specifiek formaat, wordt het bijpassende type van informatie automatisch geselecteerd.
Hostinterface	Selecteer de hostinterface. Dit veld is beschikbaar bij het bewerken van een item op het hostniveau.
Eenheden	Als er een eenheidssymbool is ingesteld, zal Zabbix postprocessing aan de ontvangen waarde toevoegen en deze weergeven met het ingestelde eenheidspostfix. Standaard, als de ruwe waarde groter is dan 1000, wordt deze gedeeld door 1000 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 verwerking van B (byte) en 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 tijdgerelateerde eenheden worden gebruikt: unixtime - vertaald naar "jjjj.mm.dd uu:mm:ss". Om correct te vertalen, moet de ontvangen waarde het type Numeriek (ongesigneerd) van informatie zijn. uptime - vertaald naar "uu:mm:ss" of "N dagen, uu:mm:ss" Bijvoorbeeld, als je de waarde ontvangt als 881764 (seconden), wordt deze weergegeven als "10 dagen, 04:56:04" s - vertaald naar "jjj mmm ddd uuu mmm sss ms"; parameter wordt behandeld als het aantal seconden. Bijvoorbeeld, als je de waarde ontvangt als 881764 (seconden), wordt deze weergegeven als "10d 4h 56m" Alleen de 3 belangrijkste bovenste eenheden worden weergegeven, zoals "1m 15d 5h" of "2h 4m 46s". Als er geen dagen zijn om weer te geven, worden slechts twee niveaus weergegeven - "1m 5h" (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 voorafgegaan wordt door !, dan worden er geen eenheidsprefixen/verwerking toegepast op itemwaarden. Zie eenheid conversie.
Update-interval	Haal elke N seconden een nieuwe waarde op voor dit item. De maximaal toegestane update-interval is 86400 seconden (1 dag). Tijdssuffixen worden ondersteund, bijv. 30s, 1m, 2u, 1d. Gebruikersmacro's worden ondersteund. Een enkele macro moet het hele veld vullen. Meerdere macro's in een veld of macro's vermengd met tekst worden niet ondersteund. Opmerking: De update-interval kan alleen worden ingesteld op '0' als er aangepaste intervallen bestaan met een niet-nulwaarde. Als het is ingesteld op '0' en er bestaat een aangepast interval (flexibel of gepland) met een niet-nulwaarde, wordt het item tijdens de duur van het aangepaste interval gepolled. Let op dat de eerste poll van een item nadat het actief is geworden of nadat de update-interval is gewijzigd, eerder kan plaatsvinden dan de geconfigureerde waarde. Een bestaand passief item kan direct worden gepolled voor een waarde door op de knop Nu uitvoeren te drukken button.
Aangepaste intervallen	Je kunt aangepaste regels maken voor het controleren van het item: Flexibel - maak een uitzondering op de Update-interval (interval met een andere frequentie) Planning - maak een aangepaste planningsinterval. Zie voor meer informatie Aangepaste intervallen. Tijdssuffixen worden ondersteund in het veld Interval, bijv. 30s, 1m, 2u, 1d. Gebruikersmacro's worden ondersteund. Een enkele macro moet het hele veld vullen. Meerdere macro's in een veld of macro's vermengd met tekst worden niet ondersteund. Planning wordt ondersteund vanaf Zabbix 3.0.0. Opmerking: aangepaste intervallen voor actieve controles worden alleen ondersteund door Zabbix agent 2.
Geschiedenis opslagperiode	Selecteer een van de volgende opties: Geen geschiedenis bewaren - de geschiedenis van het item wordt niet opgeslagen. Handig voor hoofditems als alleen afhankelijke items de geschiedenis moeten bewaren. Deze instelling kan niet worden overschreven door de algemene housekeeper instellingen. Opslagperiode - geef de duur op waarin gedetailleerde geschiedenis in de database wordt bewaard (1 uur tot 25 jaar). Oudere gegevens worden verwijderd door de housekeeper. Opgeslagen in seconden. Tijdssuffixen worden ondersteund, bijv. 2u, 1d. Gebruikersmacro's worden ondersteund. De waarde van Opslagperiode kan globaal worden overschreven in Beheer → Algemeen → Housekeeper. Als er een globale overschrijvingsinstelling bestaat, wordt er een groen informatiepictogram weergegeven. Als je je muis erop plaatst, wordt een waarschuwingsbericht weergegeven, bijv. Overschreven door algemene housekeeper instellingen (1d). Het wordt aanbevolen om de vastgelegde waarden zo kort mogelijk te bewaren om de omvang 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.
Trend opslagperiode	Selecteer een van de volgende opties: Geen trends bewaren - trends worden niet opgeslagen. Deze instelling kan niet worden overschreven door de algemene housekeeper instellingen. Opslagperiode - geef de duur op waarin geaggregeerde (uurlijkse min, max, gemiddelde, telling) geschiedenis in de database wordt bewaard (1 dag tot 25 jaar). Oudere gegevens worden verwijderd door de housekeeper. Opgeslagen in seconden. Tijdssuffixen worden ondersteund, bijv. 24u, 1d. Gebruikersmacro's worden ondersteund. De waarde van Opslagperiode kan globaal worden overschreven in Beheer → Algemeen → Housekeeper. Als er een globale overschrijvingsinstelling bestaat, wordt er een groen informatiepictogram weergegeven. Als je je muis erop plaatst, wordt een waarschuwingsbericht weergegeven, bijv. Overschreven door algemene housekeeper instellingen (7d). Let op: Het bewaren van trends is niet beschikbaar voor niet-numerieke gegevens - karakter, log en tekst. Zie ook Geschiedenis en trends.
Waardetoewijzing	Pas een waarde-toewijzing toe op dit item. Waardetoewijzing verandert de ontvangen waarden niet, het is alleen voor het weergeven van gegevens. Het werkt met items van het type Numeric(unsigned), Numeric(float) en Character. Bijvoorbeeld "Windows-service statussen".
Log tijdformaat	Alleen beschikbaar voor items van het type Log. Ondersteunde plaatshouders: * y: Jaar (1970-2038) * M: Maand (01-12) * d: Dag (01-31) * h: Uur (00-23) * m: Minuut (00-59) * s: Seconde (00-59) Als dit leeg wordt gelaten, wordt de tijdstempel niet geparseerd. Bijvoorbeeld, overweeg de volgende regel uit het logbestand 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 datum, tijd, en de rest van de regel. Het log-tijdformaat voor deze regel zou "pppppp:yyyyMMdd:hhmmss" zijn. Merk op dat de "p" en ":" tekens slechts plaatshouders zijn en alles behalve "yMdhms" kunnen zijn.
Vult host inventarisveld in	Je kunt een host-inventarisveld selecteren dat zal worden ingevuld met de waarde van het item. Dit werkt als automatische inventaris populatie is ingeschakeld voor de host. Dit veld is niet beschikbaar als Type informatie is ingesteld op 'Log'.
Omschrijving	Voer een omschrijving in voor het item. Gebruikersmacro's worden ondersteund.
Ingeschakeld	Markeer het selectievakje om het item in te schakelen zodat het wordt verwerkt.
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 bestaand item.

Het tabblad Tags maakt het mogelijk om item-niveau tags 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 werkelijke waarde terug te krijgen. Deze test kan zelfs worden uitgevoerd voordat een item is opgeslagen.

Het testen is beschikbaar voor items van hosts, sjablonen, itemprototypen en regels voor low-level discovery. Het testen is niet beschikbaar voor actieve items.

Itemtests zijn beschikbaar voor de volgende passieve itemtypes:

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

Om een item te testen, klik je op de knop Test onderaan het itemconfiguratieformulier. Houd er rekening mee dat de Test-knop wordt uitgeschakeld voor items die niet kunnen worden getest (zoals actieve controles, uitgesloten eenvoudige controles).

Het itemtestformulier bevat velden voor de vereiste hostparameters (hostadres, poort, proxynaam/geen proxy) en item-specifieke details (zoals SNMPv2-community of SNMPv3-beveiligingsreferenties). Deze velden zijn contextbewust:

• De waarden worden ingevuld wanneer mogelijk, bijvoorbeeld 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 items van sjablonen.
• Macro-waarden in platte tekst worden opgelost.
• Velden waar 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 macrowaarde bevat, wordt de volgende waarschuwingsmelding weergegeven: "Het 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 het hostadresveld en het proxylveld zijn uitgeschakeld voor berekende items).

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

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

Een succesvol opgehaalde waarde van de host kan ook worden gebruikt om voorverwerkingstappen te testen.

Formulierknoppen

Knoppen onderaan het formulier bieden de mogelijkheid om verschillende bewerkingen 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 direct een controle uit voor een nieuwe itemwaarde. Alleen ondersteund voor passieve controles (zie meer details). Let op dat bij het onmiddellijk controleren van een waarde de configuratiecache niet wordt bijgewerkt. Hierdoor zal de waarde niet zeer recente wijzigingen in de itemconfiguratie weerspiegelen.
	Test of de itemconfiguratie correct is door een waarde op te halen.
	Wis de itemgeschiedenis en trends.
	Verwijder het item.
	Annuleer het bewerken van item-eigenschappen.

Tekstgegevenslimieten

Tekstgegevenslimieten 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 waarde type:

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 aangepaste scripts

De beschikbare lengte van aangepaste scripts hangt af 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.