De volgende objecten zijn direct gerelateerd aan de itemprototype
API.
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.
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. |
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.