This is a translation of the original English documentation page. Help us make it better.

> Item prototype-object

De volgende objecten zijn direct gerelateerd aan de itemprototype API.

Item-prototype

Het item-prototype-object heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
itemid string (alleen lezen) ID van het item-prototype.
delay
(vereist)
string Bijwerkinterval van het item-prototype. Accepteert seconden of een tijdeenheid met achtervoegsel (30s,1m,2u,1d).
Optioneel kunnen één of meer aangepaste intervallen worden gespecificeerd, zowel als flexibele intervallen als planning.
Meerdere intervallen worden gescheiden door een puntkomma.
Gebruikersmacro's en LLD-macro's kunnen worden gebruikt. Een enkele macro moet het hele veld vullen. Meerdere macro's in een veld of macro's gemengd met tekst worden niet ondersteund.
Flexibele intervallen kunnen worden geschreven als twee macro's gescheiden door een schuine streep (bijv. {$FLEX_INTERVAL}/{$FLEX_PERIOD}).

Optioneel voor Zabbix-trapper, afhankelijke items en voor Zabbix-agent (actief) met de sleutel mqtt.get.
hostid
(vereist)
string ID van de host waartoe het item-prototype behoort.

Voor updatebewerkingen is dit veld alleen lezen.
ruleid
(vereist)
string ID van de LLD-regel waartoe het item behoort.

Voor updatebewerkingen is dit veld alleen lezen.
interfaceid
(vereist)
string ID van de hostinterface van het item-prototype. Alleen gebruikt voor host-item-prototypes.

Niet vereist voor Zabbix-agent (actief), Zabbix intern, Zabbix-trapper, berekende, afhankelijke, database monitor en script item-prototypes. Optioneel voor HTTP-agent item-prototypes.
key_
(vereist)
string Sleutel van het item-prototype.
name
(vereist)
string Naam van het item-prototype.
type
(vereist)
integer Type van het item-prototype.

Mogelijke waarden:
0 - Zabbix-agent;
2 - Zabbix-trapper;
3 - eenvoudige controle;
5 - Zabbix intern;
7 - Zabbix-agent (actief);
10 - externe controle;
11 - database monitor;
12 - IPMI-agent;
13 - SSH-agent;
14 - TELNET-agent;
15 - berekend;
16 - JMX-agent;
17 - SNMP-trap;
18 - Afhankelijk item;
19 - HTTP-agent;
20 - SNMP-agent;
21 - Script.
url
(vereist)
string URL-reeks vereist alleen voor HTTP-agentitem-prototypen. Ondersteunt LLD-macro's, gebruikersmacro's, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.
value_type
(vereist)
integer Type van de informatie van het item-prototype.

Mogelijke waarden:
0 - numerieke float;
1 - tekenreeks;
2 - logboek;
3 - numerieke ondertekende waarde;
4 - tekst.
allow_traps integer Veld voor HTTP-agentitem-prototype. Sta toe dat de waarde ook wordt ingevuld als het type trapper item is.

0 - (standaard) Sta niet toe om inkomende gegevens te accepteren.
1 - Sta toe om inkomende gegevens te accepteren.
authtype integer Alleen gebruikt door SSH-agentitem-prototypen of HTTP-agentitem-prototypen.

Mogelijke waarden voor SSH-agentauthenticatiemethode:
0 - (standaard) wachtwoord;
1 - openbare sleutel.

Mogelijke waarden voor HTTP-agentauthenticatiemethode:
0 - (standaard) geen
1 - basis
2 - NTLM
3 - Kerberos
description string Beschrijving van het item-prototype.
follow_redirects integer Veld voor HTTP-agentitem-prototype. Volg redirects van respons bij het ophalen van gegevens.

0 - Volg geen redirects.
1 - (standaard) Volg redirects.
headers object Veld voor HTTP-agentitem-prototype. Object met HTTP(S)-verzoekheaders, waarbij de kopernaam als sleutel wordt gebruikt en de kopwaarde als waarde.

Voorbeeld:
{ "User-Agent": "Zabbix" }
history string Een tijdeenheid voor hoelang de geschiedenisgegevens moeten worden opgeslagen. Accepteert ook gebruikersmacro's en LLD-macro's.

Standaard: 90d.
http_proxy string Veld voor HTTP-agentitem-prototype. Verbindingsreeks voor HTTP(S)-proxy.
ipmi_sensor string IPMI-sensor. Alleen gebruikt door IPMI-item-prototypen.
jmx_endpoint string Aangepaste verbindingsreeks voor JMX-agent.

Standaardwaarde:
service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi
logtimefmt string Indeling van de tijd in logboekvermeldingen. Alleen gebruikt door logboekitem-prototypen.
master_itemid integer ID van het hoofditem.
Herhaling tot 3 afhankelijke items en item-prototypen en het maximale aantal afhankelijke items en item-prototypen is 29999.

Vereist door afhankelijke items.
output_format integer Veld voor HTTP-agentitem-prototype. Moet de respons worden geconverteerd naar JSON.

0 - (standaard) Opslaan als ruwe gegevens.
1 - Converteren naar JSON.
params string Aanvullende parameters afhankelijk van het type item-prototype:
- uitgevoerd script voor SSH- en Telnet-item-prototypen;
- SQL-query voor database-monitor item-prototypen;
- formule voor berekende item-prototypen.
parameters array Aanvullende parameters voor script-item-prototypen. Array van objecten met 'naam' en 'waarde'-eigenschappen, waarbij de naam uniek moet zijn.
password string Wachtwoord voor authenticatie. Gebruikt door eenvoudige controle, SSH, Telnet, database monitor, JMX en HTTP-agentitem-prototypen.
post_type integer Veld voor HTTP-agentitem-prototype. Type gegevens van het berichtlichaam dat is opgeslagen in het eigenschap 'posts'.

0 - (standaard) Ruwe gegevens.
2 - JSON-gegevens.
3 - XML-gegevens.
posts string Veld voor HTTP-agentitem-prototype. Gegevens van het berichtlichaam van het HTTP(S)-verzoek. Wordt gebruikt met post_type.
privatekey string Naam van het privésleutelbestand.
publickey string Naam van het openbare sleutelbestand.
query_fields array Veld voor HTTP-agentitem-prototype. Queryparameters. Array van objecten met 'sleutel':'waarde'-paren, waarbij de waarde een lege tekenreeks kan zijn.
request_method integer Veld voor HTTP-agentitem-prototype. Type verzoekmethode.

0 - (standaard) GET
1 - POST
2 - PUT
3 - HEAD
retrieve_mode integer Veld voor HTTP-agentitem-prototype. Welk deel van de respons moet worden opgeslagen.

0 - (standaard) Lichaam.
1 - Headers.
2 - Zowel het lichaam als de headers worden opgeslagen.

Voor request_method HEAD is alleen de waarde 1 toegestaan.
snmp_oid string SNMP OID.
ssl_cert_file string Veld voor HTTP-agentitem-prototype. Pad naar openbaar SSL-sleutelbestand.
ssl_key_file string Veld voor HTTP-agentitem-prototype. Pad naar privé-SSL-sleutelbestand.
ssl_key_password string Veld voor HTTP-agentitem-prototype. Wachtwoord voor SSL-sleutelbestand.
status integer Status van het item-prototype.

Mogelijke waarden:
0 - (standaard) ingeschakeld item-prototype;
1 - uitgeschakeld item-prototype;
3 - item-prototype niet ondersteund.
status_codes string Veld voor HTTP-agentitem-prototype. Reeksen vereiste HTTP-statuscodes gescheiden door komma's. Ondersteunt ook gebruikersmacro's of LLD-macro's als onderdeel van een komma-gescheiden lijst.

Voorbeeld: 200,200-{$M},{$M},200-400
templateid string (alleen lezen) ID van het ouder-template-item-prototype.
timeout string Time-out voor het opvragen van itemgegevens. Gebruikt voor HTTP-agentitem-prototypen en script-item-prototypen. Ondersteunt gebruikersmacro's en LLD-macro's.

standaard: 3s
maximale waarde: 60s
trapper_hosts string Toegestane hosts. Gebruikt door trapper-item-prototypen of HTTP-item-prototypen.
trends string Een tijdeenheid voor hoe lang de trendgegevens moeten worden bewaard. Accepteert ook gebruikersmacro's en LLD-macro's.

Standaard: 365d.
units string Eenheden van waarden.
username string Gebruikersnaam voor authenticatie. Gebruikt door eenvoudige controle, SSH, Telnet, database monitor, JMX en HTTP-agent-item-prototypen.

Vereist voor SSH- en Telnet-item-prototypen.
uuid string Unieke universele identifier, gebruikt om geïmporteerde item-prototypen te koppelen aan al bestaande. Alleen gebruikt voor item-prototypen op sjablonen. Wordt automatisch gegenereerd als het niet wordt opgegeven.
valuemapid string ID van de bijbehorende waardeomzetting.
verify_host integer Veld voor HTTP-agent-item-prototype. Valideer of de hostnaam in de URL zich bevindt in het Common Name-veld of een Subject Alternate Name-veld van het hostcertificaat.

0 - (standaard) Niet valideren.
1 - Valideren.
verify_peer integer Veld voor HTTP-agent-item-prototype. Valideer of het hostcertificaat authentiek is.

0 - (standaard) Niet valideren.
1 - Valideren.
discover integer Status van ontdekking voor item-prototype.

Mogelijke waarden:
0 - (standaard) nieuwe items worden ontdekt;
1 - nieuwe items worden niet ontdekt en bestaande items worden als verloren gemarkeerd.

Merk op dat voor sommige methoden (bijwerken, verwijderen) de combinatie van vereiste/optionele parameters anders is.

Item prototype-tag

Het item prototype tag-object heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
tag
(vereist)
string Naam prototype tag item.
value string Waarde van prototypetag van item.

Voorbewerking van prototype van item

Het object prototype voorbewerking heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
type
(vereist)
geheel getal Het type voorbewerkingsoptie.

Mogelijke waarden:
1 - Aangepaste vermenigvuldiger;
2 - Rechts bijsnijden;
3 - Links bijsnijden;
4 - Bijsnijden;
5 - Overeenkomen met reguliere expressies;
6 - Booleaans naar decimaal;
7 - Octaal naar decimaal;
8 - Hexadecimaal naar decimaal;
9 - Eenvoudige wijziging;
10 - Wijziging per seconde;
11 - XML XPath;
12 - JSONPath;
13 - Binnen bereik;
14 - Komt overeen met reguliere expressie;
15 - Komt niet overeen met reguliere expressie;
16 - Controleer op fouten in JSON;
17 - Controleer op fouten in XML;
18 - Controleer op fouten met behulp van reguliere expressie;
19 - Verwijder ongewijzigd;<br >20 - Ongewijzigd weggooien met hartslag;
21 - JavaScript;
22 - Prometheus-patroon;
23 - Prometheus naar JSON;
24 - CSV naar JSON;
25 - Vervang;<br >26 - Controleer niet-ondersteund;
27 - XML naar JSON.
params
(verplicht)
string Aanvullende parameters gebruikt door voorbewerkingsoptie. Meerdere parameters worden gescheiden door een LF-teken (\n).
error_handler
(vereist)
integer Actietype gebruikt in geval van mislukte voorverwerkingsstap.

Mogelijke waarden:
0 - Foutbericht is ingesteld door Zabbix-server;< br>1 - Waarde negeren;
2 - Aangepaste waarde instellen;
3 - Aangepaste foutmelding instellen.
error_handler_params
(vereist)
string Fouthandlerparameters. Gebruikt met error_handler.

Moet leeg zijn als error_handler 0 of 1 is.
Kan leeg zijn als error_handler 2 is.
Kan niet leeg zijn als error_handler is 3.

De volgende parameters en foutafhandelaars worden voor elk ondersteund: soort voorbewerking.

|Preprocessing type|Naam|Parameter 1|Parameter 2|Parameter 3|Ondersteunde fout-handlers| |------------------|----|-----------|-----------|- ----------|------------------------| |1|Aangepaste vermenigvuldiger|getal1, 6|<|<|0, 1, 2, 3| |2|Rechts bijsnijden|lijst met tekens2|<|<|<| |3|Links trim|lijst met tekens2|<|<|<| |4|Trim|lijst met tekens2|<|<|<| |5|Reguliere uitdrukking|patroon3|output2|<|0, 1, 2, 3| |6|Boolean naar decimaal|<|<|<|0, 1, 2, 3| |7|Octaal naar decimaal|<|<|<|0, 1, 2, 3| |8|Hexadecimaal naar decimaal|<|<|<|0, 1, 2, 3| |9|Eenvoudige wijziging|<|<|<|0, 1, 2, 3| |10|Verandering per seconde|<|<|<|0, 1, 2, 3| |11|XML XPath|pad4|<|<|0, 1, 2, 3| |12|JSONPath|pad4|<|<|0, 1, 2, 3| |13|Binnen bereik|min1, 6|max1, 6|<|0, 1, 2, 3| |14|Komt overeen met reguliere expressie|patroon3|<|<|0, 1, 2, 3| |15|Komt niet overeen met reguliere expressie|patroon3|<|<|0, 1, 2, 3| |16|Controleer op fouten in JSON|path4|<|<|0, 1, 2, 3| |17|Controleer op fouten in XML|pad4|<|<|0, 1, 2, 3| |18|Controleer op fouten met reguliere expressie|patroon3|output2|<|0, 1, 2, 3| |19|Gooi ongewijzigd weg|<|<|<|<| |20|Gooi ongewijzigd weg met hartslag|seconden5, 6|<|<|<| |21|JavaScript|script2|<|<|<| |22|Prometheus-patroon|patroon6, 7|value, label, function|output8, 9|0, 1, 2, 3| |23|Prometheus naar JSON|patroon6, 7|<|<|0, 1, 2, 3| |24|CSV naar JSON|karakter2|karakter2|0,1|0, 1, 2, 3| |25|Vervangen|zoekreeks2|vervanging2|<|<| |26|Aanvinken niet ondersteund|<|<|<|1, 2, 3| |27|XML naar JSON|<|<|<|0, 1, 2, 3|

1 geheel getal of getal met drijvende komma
2 tekenreeks
3 reguliere expressie
4 JSONPath of XML XPath
5 positief geheel getal (met ondersteuning van tijdsuffixen, bijv. 30s, 1m, 2h, 1d)
6 gebruikersmacro, LLD-macro
7 Prometheus-patroon volgens de syntaxis: <metrische naam>{<labelnaam>="<labelwaarde>", ...} == <waarde>. Elk Prometheus-patrooncomponent (metrisch, labelnaam, labelwaarde en metriek waarde) kan een gebruikersmacro of een LLD-macro zijn.
8 Prometheus-uitvoer volgens de syntaxis: <labelnaam> (kan een gebruikersmacro of een LLD-macro zijn) als label is geselecteerd als de tweede parameter.
9 Een van de aggregatiefuncties: sum, min, max, avg, count als function is geselecteerd als de tweede parameter.