1 Aanmaken van een item

Overzicht

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

  • Ga naar: ConfiguratieHosts
  • 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.

Velden specifiek voor itemtypes worden beschreven op bijbehorende pagina's.

Bij het bewerken van een bestaand sjabloon niveau-item op het hostniveau zijn een aantal velden alleen-lezen. Je kunt de link in de kop van het formulier gebruiken om naar het sjabloon niveau te gaan en ze daar bewerken, in gedachten houdend dat de wijzigingen op het sjabloon niveau het item voor alle hosts waar het sjabloon aan gekoppeld is zal veranderen.

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

Om itemtests uit te voeren, zorg ervoor dat de systeemtijd op de server en de proxy is gesynchroniseerd. In het geval dat de servertijd achterloopt, kan het uitvoeren van een itemtest een foutmelding "De taak is verlopen" opleveren. Echter, als de server en de proxy ingesteld zijn met verschillende tijdzones, heeft dit geen invloed op het testresultaat.

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:

Database Soort informatie
Karakter Logboek Tekst
MySQL 255 tekens 65536 bytes 65536 bytes
PostgreSQL 255 tekens 65536 tekens 65536 tekens
Oracle 255 tekens 65536 tekens 65536 tekens
SQLite
(alleen Zabbix-proxy)
255 tekens 65536 tekens 65536 tekens

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

Voor Zabbix 4.0 was er een hardgecodeerde lijst van eenheidsstopwoorden bestaande uit ms, rpm, RPM, %. Deze lijst is achterhaald, dus de juiste manier om dergelijke eenheden te voorkomen is !ms, !rpm, !RPM, !%.

Limiet voor aangepaste scripts

De beschikbare lengte van aangepaste scripts hangt af van de gebruikte database:

Database Limiet in tekens Limiet in bytes
MySQL 65535 65535
Oracle Database 2048 4000
PostgreSQL 65535 niet beperkt
SQLite (alleen Zabbix-proxy) 65535 niet beperkt

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.