[comment]: # translation:outdated
[comment]: # ({50342b23-50342b23})
# 1 Aanmaken van een item
[comment]: # ({/50342b23-50342b23})
[comment]: # ({9fd6079b-d3a04061})
#### 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.
[comment]: # ({/9fd6079b-d3a04061})
[comment]: # ({a78f1f07-d0a0a311})
#### 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](/manual/config/items/itemtypes) secties.|
|*Sleutel*|Sleutel van het item (maximaal 2048 tekens).
De ondersteunde [itemsleutels](/manual/config/items/itemtypes) 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](/manual/config/items/item/key).|
|*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](/manual/installation/known_issues#numeric-float-data-type-range-with-postgresql-11-and-earlier)).
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](#text-data-limits).
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](https://en.wikipedia.org/wiki/JEDEC_memory_standards) 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](#unit_conversion).|
|*Interval voor bijwerken*|Haal elke N seconden een nieuwe waarde op voor dit item. De maximale toegestane bijwerkingsinterval is 86400 seconden (1 dag).
[Tijdsachtervoegsels](/manual/appendix/suffixes) worden ondersteund, bijvoorbeeld 30s, 1m, 2u, 1d.
[Gebruikermacro's](/manual/config/macros/user_macros) 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](#form_buttons) 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](/manual/config/items/item/custom_intervals).
[Tijdsachtervoegsels](/manual/appendix/suffixes) worden ondersteund in het *Interval* veld, bijvoorbeeld 30s, 1m, 2u, 1d.
[Gebruikermacro's](/manual/config/macros/user_macros) 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](/manual/web_interface/frontend_sections/administration/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](/manual/appendix/suffixes) worden ondersteund, bijvoorbeeld 2u, 1d. [Gebruikermacro's](/manual/config/macros/user_macros) worden ondersteund.
De *Bewaarperiode* waarde kan globaal worden overschreven in *Administratie → [Housekeeping](/manual/web_interface/frontend_sections/administration/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](/manual/config/items/history_and_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](/manual/web_interface/frontend_sections/administration/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](/manual/appendix/suffixes) worden ondersteund, bijvoorbeeld 24u, 1d. [Gebruikermacro's](/manual/config/macros/user_macros) worden ondersteund.
De *Bewaarperiode* waarde kan globaal worden overschreven in *Administratie → [Housekeeping](/manual/web_interface/frontend_sections/administration/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](/manual/config/items/history_and_trends).|
|*Waarde toewijzing*|Pas waarde toewijzing toe op dit item. [Waarde toewijzing](/manual/config/items/mapping) 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](/manual/config/hosts/inventory) 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](/manual/config/macros/user_macros) 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.|
::: noteclassic
Velden specifiek voor het itemtype worden beschreven op [overeenkomstige pagina's](/manual/config/items/itemtypes).
:::
::: noteclassic
Bij het bewerken van een bestaand [sjabloon](/manual/config/templates) niveau item op het hostniveau, zijn een aantal velden alleen-lezen. Je kunt de link in de formulierkop gebruiken en naar het sjabloon niveau gaan en deze daar bewerken, rekening houdend met het feit dat de wijzigingen op sjabloon niveau het item zullen wijzigen voor alle hosts waaraan het sjabloon is gekoppeld.
:::
Het **Tags** tabblad maakt het mogelijk om [tags](/manual/config/tagging) op itemniveau te definiëren.
[comment]: # ({/a78f1f07-d0a0a311})
[comment]: # ({4f9077b8-4f9077b8})
##### Item waarde voorbewerken
Het tabblad **Voorbewerking** maakt het mogelijk om [transformatieregels](/manual/config/items/preprocessing) te definiëren voor de ontvangen waarden.
[comment]: # ({/4f9077b8-4f9077b8})
[comment]: # ({ff2c0878-006c45ea})
#### Testen
::: noteimportant
Om itemtesten uit te voeren, moet je ervoor zorgen dat de systeemtijd op de server en de proxy is [gesynchroniseerd](/manual/installation/requirements#time-synchronization).
In het geval dat de servertijd achterloopt, kan het itemtesten een foutmelding retourneren met de tekst "De taak is verlopen."
Echter, het instellen van verschillende tijdzones op de server en de proxy zal de testresultaten niet beïnvloeden.
:::
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.
{width="600"}
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](/manual/config/items/preprocessing#testing) te testen.
[comment]: # ({/ff2c0878-006c45ea})
[comment]: # ({961d04fe-4b126a62})
#### 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](/manual/config/items/check_now)).
*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.|
[comment]: # ({/961d04fe-4b126a62})
[comment]: # ({854b6201-8cb32bf5})
#### 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:
|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|
[comment]: # ({/854b6201-8cb32bf5})
[comment]: # ({a675249e-d4406a73})
#### Limiet voor aangepast script
De beschikbare lengte voor aangepaste scripts is afhankelijk van de gebruikte database:
|Database|Limiet in tekens|Limiet in bytes|
|---|---|---|
|*MySQL*|65535|65535|
|*PostgreSQL*|65535|niet beperkt|
|*Oracle*|2048|4000|
|*SQLite (alleen Zabbix-proxy)*|65535|niet beperkt|
[comment]: # ({/a675249e-d4406a73})
[comment]: # ({2cd40177-2cd40177})
#### 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](/manual/config/items/item?#configuration)*.
Niet-ondersteunde items worden gerapporteerd met de status NIET ONDERSTEUND.
[comment]: # ({/2cd40177-2cd40177})