[comment]: # aside:1

[comment]: # ({d1f57367-6bb9f60f})
# Obiekt pozycji

Następujące obiekty są bezpośrednio powiązane z API `item`.

[comment]: # ({/d1f57367-6bb9f60f})

[comment]: # ({68ea2686-385ac8b5})
### Item

::: noteclassic
Pozycji webowych nie można bezpośrednio tworzyć, aktualizować ani usuwać za pomocą API Zabbixa.
:::

Obiekt item ma następujące właściwości.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|itemid|ID|ID pozycji.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations|
|delay|string|Interwał aktualizacji pozycji.<br><br>Akceptuje sekundy lub jednostkę czasu z sufiksem (np. 30s, 1m, 2h, 1d) oraz opcjonalnie jeden lub więcej [niestandardowych interwałów](/manual/config/items/item/custom_intervals), wszystkie oddzielone średnikami. Niestandardowe interwały mogą być mieszanką interwałów elastycznych i harmonogramowych.<br><br>Akceptuje makra użytkownika. Jeśli są używane, wartość musi być pojedynczym makrem. Wiele makr lub makra połączone z tekstem nie są obsługiwane. Interwały elastyczne można zapisać jako dwa makra oddzielone ukośnikiem (np. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Przykład:<br>`1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}`<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Zabbix agent" (0), "Simple check" (3), "Zabbix internal" (5), "External check" (10), "Database monitor" (11), "IPMI agent" (12), "SSH agent" (13), "TELNET agent" (14), "Calculated" (15), "JMX agent" (16), "HTTP agent" (19), "SNMP agent" (20), "Script" (21), "Browser" (22), or if `type` is set to "Zabbix agent (active)" (7) and `key_` does not contain "mqtt.get"|
|hostid|ID|ID hosta lub szablonu, do którego należy pozycja.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *required* for create operations|
|interfaceid|ID|ID interfejsu hosta dla pozycji.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if item belongs to host and `type` is set to "Zabbix agent", "IPMI agent", "JMX agent", "SNMP trap", or "SNMP agent"<br>- *supported* if item belongs to host and `type` is set to "Simple check", "External check", "SSH agent", "TELNET agent", or "HTTP agent"<br>- *read-only* for discovered objects|
|key\_|string|Klucz pozycji.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects or discovered objects|
|name|string|Nazwa pozycji.<br>Obsługuje makra użytkownika.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects or discovered objects|
|name\_resolved|string|Nazwa pozycji z rozwiniętymi makrami użytkownika.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|type|integer|Typ pozycji.<br><br>Possible values:<br>0 - Zabbix agent;<br>2 - Zabbix trapper;<br>3 - Simple check;<br>5 - Zabbix internal;<br>7 - Zabbix agent (active);<br>9 - Web item;<br>10 - External check;<br>11 - Database monitor;<br>12 - IPMI agent;<br>13 - SSH agent;<br>14 - TELNET agent;<br>15 - Calculated;<br>16 - JMX agent;<br>17 - SNMP trap;<br>18 - Dependent item;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script;<br>22 - Browser.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects or discovered objects|
|url|string|Łańcuch URL.<br>Obsługuje makra użytkownika, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {ITEM.ID}, {ITEM.KEY}.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|value\_type|integer|Typ informacji przechowywanej przez pozycję.<br><br>Possible values:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text;<br>5 - binary.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects or discovered objects|
|allow\_traps|integer|Pozwala na wypełnianie wartości podobnie jak w przypadku pozycji trapper.<br><br>0 - *(default)* Nie zezwalaj na przyjmowanie danych przychodzących;<br>1 - Zezwalaj na przyjmowanie danych przychodzących.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for discovered objects|
|authtype|integer|Metoda uwierzytelniania.<br><br>Possible values if `type` is set to "SSH agent":<br>0 - *(default)* password;<br>1 - public key.<br><br>Possible values if `type` is set to "HTTP agent":<br>0 - *(default)* none;<br>1 - basic;<br>2 - NTLM;<br>3 - Kerberos;<br>4 - Digest.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "SSH agent" or "HTTP agent"<br>- *read-only* for inherited objects (if `type` is set to "HTTP agent") or discovered objects|
|description|string|Opis pozycji.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only* for discovered objects|
|error|string|Tekst błędu, jeśli występują problemy z aktualizacją wartości pozycji.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|flags|integer|[Pochodzenie](/manual/api/reference_commentary#entity-origin-flags) pozycji.<br><br>Possible values:<br>0 - a plain item;<br>4 - an item converted from prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|follow\_redirects|integer|Podążaj za przekierowaniami odpowiedzi podczas pobierania danych.<br><br>Possible values:<br>0 - Do not follow redirects;<br>1 - *(default)* Follow redirects.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|headers|array|Tablica [nagłówków](#http-header), które zostaną wysłane podczas wykonywania żądania HTTP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|history|string|Jednostka czasu określająca, jak długo mają być przechowywane dane historyczne.<br>Obsługuje także makro użytkownika.<br><br>Domyślnie: 31d.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only* for discovered objects|
|http\_proxy|string|Łańcuch połączenia proxy HTTP(S).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|inventory\_link|integer|ID pola inwentarza hosta, które jest wypełniane przez pozycję.<br><br>Listę obsługiwanych pól inwentarza hosta i ich identyfikatorów znajdziesz na [stronie inwentarza hosta](/manual/api/reference/host/object#host-inventory).<br><br>Domyślnie: 0.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "numeric float", "character", "numeric unsigned", or "text"<br>- *read-only* for discovered objects|
|ipmi\_sensor|string|Czujnik IPMI.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "IPMI agent" and `key_` is not set to "ipmi.get"<br>- *supported* if `type` is set to "IPMI agent"<br>- *read-only* for inherited objects or discovered objects|
|jmx\_endpoint|string|Niestandardowy ciąg połączenia agenta JMX.<br><br>Domyślna wartość: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "JMX agent"<br>- *read-only* for discovered objects|
|lastclock|timestamp|Czas ostatniej aktualizacji wartości pozycji.<br><br>Domyślnie wyświetlane są tylko wartości z ostatnich 24 godzin. Możesz wydłużyć ten okres, zmieniając wartość parametru *Maksymalny okres wyświetlania historii* w sekcji menu *[Administracja → Ogólne](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|lastns|integer|Nanosekundy ostatniej aktualizacji wartości pozycji.<br><br>Domyślnie wyświetlane są tylko wartości z ostatnich 24 godzin. Możesz wydłużyć ten okres, zmieniając wartość parametru *Maksymalny okres wyświetlania historii* w sekcji menu *[Administracja → Ogólne](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|lastvalue|string|Ostatnia wartość pozycji.<br><br>Domyślnie wyświetlane są tylko wartości z ostatnich 24 godzin. Możesz wydłużyć ten okres, zmieniając wartość parametru *Maksymalny okres wyświetlania historii* w sekcji menu *[Administracja → Ogólne](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|logtimefmt|string|Format czasu w wpisach dziennika.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "log"<br>- *read-only* for inherited objects or discovered objects|
|master\_itemid|ID|ID pozycji nadrzędnej.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Dependent item"<br>- *read-only* for inherited objects or discovered objects|
|output\_format|integer|Czy odpowiedź ma zostać przekonwertowana do JSON.<br><br>0 - *(default)* Store raw;<br>1 - Convert to JSON.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|params|string|Dodatkowe parametry zależne od typu pozycji:<br>- wykonany skrypt dla pozycji SSH agent i TELNET agent;<br>- zapytanie SQL dla pozycji database monitor;<br>- formuła dla pozycji calculated;<br>- skrypt dla pozycji script i browser.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Database monitor", "SSH agent", "TELNET agent", "Calculated", "Script", or "Browser"<br>- *read-only* for inherited objects (if `type` is set to "Script" or "Browser") or discovered objects|
|parameters|object/array|Dodatkowe parametry, jeśli `type` jest ustawiony na "Script" lub "Browser". Tablica obiektów z właściwościami `name` i `value`, przy czym `name` musi być unikalne.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "Script" or "Browser"<br>- *read-only* for inherited objects or discovered objects|
|password|string|Hasło do uwierzytelniania.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "JMX agent" and `username` is set<br>- *supported* if `type` is set to "Simple check", "SSH agent", "TELNET agent", "Database monitor", or "HTTP agent"<br>- *read-only* for inherited objects (if `type` is set to "HTTP agent") or discovered objects|
|post\_type|integer|Typ treści żądania POST przechowywanej we właściwości `posts`.<br><br>Possible values:<br>0 - *(default)* Raw data;<br>2 - JSON data;<br>3 - XML data.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|posts|string|Dane treści żądania HTTP(S).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "HTTP agent" and `post_type` is set to "JSON data" or "XML data"<br>- *supported* if `type` is set to "HTTP agent" and `post_type` is set to "Raw data"<br>- *read-only* for inherited objects or discovered objects|
|prevvalue|string|Poprzednia wartość pozycji.<br><br>Domyślnie wyświetlane są tylko wartości z ostatnich 24 godzin. Możesz wydłużyć ten okres, zmieniając wartość parametru *Maksymalny okres wyświetlania historii* w sekcji menu *[Administracja → Ogólne](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|privatekey|string|Nazwa pliku klucza prywatnego.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SSH agent" and `authtype` is set to "public key"<br>- *read-only* for discovered objects|
|publickey|string|Nazwa pliku klucza publicznego.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SSH agent" and `authtype` is set to "public key"<br>- *read-only* for discovered objects|
|query\_fields|array|Tablica [pól zapytania](#http-query-field), które zostaną wysłane podczas wykonywania żądania HTTP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|request\_method|integer|Typ metody żądania.<br><br>Possible values:<br>0 - *(default)* GET;<br>1 - POST;<br>2 - PUT;<br>3 - HEAD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|retrieve\_mode|integer|Która część odpowiedzi ma zostać zapisana.<br><br>Possible values if `request_method` is set to "GET", "POST", or "PUT":<br>0 - *(default)* Body;<br>1 - Headers;<br>2 - Both body and headers will be stored.<br><br>Possible values if `request_method` is set to "HEAD":<br>1 - Headers.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|snmp\_oid|string|OID SNMP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SNMP agent"<br>- *read-only* for inherited objects or discovered objects|
|ssl\_cert\_file|string|Ścieżka do pliku publicznego klucza SSL.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|ssl\_key\_file|string|Ścieżka do pliku prywatnego klucza SSL.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|ssl\_key\_password|string|Hasło do pliku klucza SSL.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|state|integer|Stan pozycji.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - not supported.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|status|integer|Status pozycji.<br><br>Possible values:<br>0 - *(default)* enabled item;<br>1 - disabled item.|
|status\_codes|string|Zakresy wymaganych kodów statusu HTTP, oddzielone przecinkami.<br>Obsługuje także makra użytkownika jako część listy rozdzielonej przecinkami.<br><br>Przykład: 200,200-{$M},{$M},200-400<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|templateid|ID|ID nadrzędnego elementu szablonu.<br><br>*Wskazówka*: Użyj właściwości `hostid`, aby określić szablon, do którego należy pozycja.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|timeout|string|Limit czasu żądania pobierania danych pozycji.<br>Akceptuje sekundy lub jednostkę czasu z sufiksem (np. 30s, 1m). Akceptuje także makra użytkownika.<br><br>Zakres możliwych wartości: 1-600s.<br><br>Domyślnie: "" - użyj ustawień proxy/globalnych.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "Zabbix agent" (0), "Simple check" (3) and `key_` does not start with "`vmware.`" and "`icmpping`", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) and `snmp_oid` starts with "`walk[`" or "`get[`", "Script" (21), "Browser" (22)<br>- *read-only* for inherited and discovered objects|
|trapper\_hosts|string|Dozwolone hosty.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *readonly* for discovered objects<br>- *supported* if `type` is set to "Zabbix trapper", or if `type` is set to "HTTP agent" and `allow_traps` is set to "Allow to accept incoming data"|
|trends|string|Jednostka czasu określająca, jak długo mają być przechowywane dane trendów.<br>Obsługuje także makro użytkownika.<br><br>Domyślnie: 365d.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "numeric float" or "numeric unsigned"<br>- *read-only* for discovered objects|
|units|string|Jednostki wartości.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "numeric float" or "numeric unsigned"<br>- *read-only* for inherited objects or discovered objects|
|username|string|Nazwa użytkownika do uwierzytelniania.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SSH agent", "TELNET agent", or if `type` is set to "JMX agent" and `password` is set<br>- *supported* if `type` is set to "Simple check", "Database monitor", or "HTTP agent"<br>- *read-only* for inherited objects (if `type` is set to "HTTP agent") or discovered objects|
|uuid|string|Uniwersalny unikalny identyfikator, używany do powiązania importowanej pozycji z już istniejącymi. Generowany automatycznie, jeśli nie zostanie podany.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if the item belongs to a template|
|valuemapid|ID|ID powiązanej mapy wartości.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "numeric float", "character", or "numeric unsigned"<br>- *read-only* for inherited objects or discovered objects|
|verify\_host|integer|Czy sprawdzać, czy nazwa hosta dla połączenia zgadza się z nazwą w certyfikacie hosta.<br><br>Possible values:<br>0 - *(default)* Do not validate;<br>1 - Validate.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|verify\_peer|integer|Czy sprawdzać, czy certyfikat hosta jest autentyczny.<br><br>Possible values:<br>0 - *(default)* Do not validate;<br>1 - Validate.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|

[comment]: # ({/68ea2686-385ac8b5})

[comment]: # ({ab5307fa-7efc456e})
#### Nagłówek HTTP

Obiekt nagłówka ma następujące właściwości:

|Właściwość|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--------|---------------------------------------------------|-----------|
|name|string|Nazwa nagłówka HTTP.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|
|value|string|Wartość nagłówka.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|

[comment]: # ({/ab5307fa-7efc456e})

[comment]: # ({5b4177f3-ee8852f1})
#### Pole zapytania HTTP

Obiekt pola zapytania definiuje nazwę i wartość używane do określenia parametru URL.
Ma następujące właściwości:

|Właściwość|[Type](/manual/api/reference_commentary#data-types)|Opis|
|--------|---------------------------------------------------|-----------|
|name|string|Nazwa parametru.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|
|value|string|Wartość parametru.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|

[comment]: # ({/5b4177f3-ee8852f1})

[comment]: # ({c9a1b21e-c1b98afa})
### Tag pozycji

Obiekt tagu pozycji ma następujące właściwości.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Nazwa tagu pozycji.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Wartość tagu pozycji.|

[comment]: # ({/c9a1b21e-c1b98afa})

[comment]: # ({eed27a12-2169bb78})
### Przetwarzanie wstępne pozycji

Obiekt przetwarzania wstępnego pozycji ma następujące właściwości.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|type|integer|Typ opcji przetwarzania wstępnego.<br><br>Możliwe wartości:<br>1 - Niestandardowy mnożnik;<br>2 - Przycinanie z prawej;<br>3 - Przycinanie z lewej;<br>4 - Przycinanie;<br>5 - Wyrażenie regularne;<br>6 - Wartość logiczna na dziesiętną;<br>7 - Ósemkowa na dziesiętną;<br>8 - Szesnastkowa na dziesiętną;<br>9 - Prosta zmiana;<br>10 - Zmiana na sekundę;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - W zakresie;<br>14 - Pasuje do wyrażenia regularnego;<br>15 - Nie pasuje do wyrażenia regularnego;<br>16 - Sprawdzenie błędu w JSON;<br>17 - Sprawdzenie błędu w XML;<br>18 - Sprawdzenie błędu przy użyciu wyrażenia regularnego;<br>19 - Odrzuć niezmienione;<br>20 - Odrzuć niezmienione z heartbeat;<br>21 - JavaScript;<br>22 - Wzorzec Prometheus;<br>23 - Prometheus do JSON;<br>24 - CSV do JSON;<br>25 - Zastąp;<br>26 - Sprawdź jako nieobsługiwane;<br>27 - XML do JSON;<br>28 - Wartość z przebiegu SNMP walk;<br>29 - SNMP walk do JSON;<br>30 - Wartość SNMP get.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|
|params|string|Dodatkowe parametry używane przez opcję przetwarzania wstępnego.<br>Wiele parametrów jest oddzielanych znakiem nowej linii (\\n).<br><br>Jeśli `type` jest ustawione na "Check unsupported", parametry mają składnię `<scope>[\n<pattern>]`, gdzie *pattern* jest wyrażeniem regularnym, a *scope* jest jednym z:<br>-1 - dopasuj dowolny błąd;<br>\ 0 - sprawdź, czy komunikat błędu pasuje do *pattern*;<br>\ 1 - sprawdź, czy komunikat błędu nie pasuje do *pattern*.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` jest ustawione na "Custom multiplier" (1), "Right trim" (2), "Left trim" (3), "Trim" (4), "Regular expression" (5), "XML XPath" (11), "JSONPath" (12), "In range" (13), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Check for error using regular expression" (18), "Discard unchanged with heartbeat" (20), "JavaScript" (21), "Prometheus pattern" (22), "Prometheus to JSON" (23), "CSV to JSON" (24), "Replace" (25), Check unsupported (26), "SNMP walk value" (28), "SNMP walk to JSON" (29), lub "SNMP get value" (30)|
|error\_handler|integer|Typ akcji używany w przypadku niepowodzenia kroku przetwarzania wstępnego.<br><br>Możliwe wartości:<br>0 - Komunikat błędu jest ustawiany przez serwer Zabbix;<br>1 - Odrzuć wartość;<br>2 - Ustaw wartość niestandardową;<br>3 - Ustaw niestandardowy komunikat błędu.<br><br>Możliwe wartości, jeśli `type` jest ustawione na "Check unsupported":<br>1 - Odrzuć wartość;<br>2 - Ustaw wartość niestandardową;<br>3 - Ustaw niestandardowy komunikat błędu.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` jest ustawione na "Custom multiplier" (1), "Regular expression" (5), "Boolean to decimal" (6), "Octal to decimal" (7), "Hexadecimal to decimal" (8), "Simple change" (9), "Change per second" (10), "XML XPath" (11), "JSONPath" (12), "In range" (13), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Check for error using regular expression" (18), "Prometheus pattern" (22), "Prometheus to JSON" (23), "CSV to JSON" (24), "Check unsupported" (26), "XML to JSON" (27), "SNMP walk value" (28), "SNMP walk to JSON" (29), lub "SNMP get value" (30)|
|error\_handler\_params|string|Parametry obsługi błędów.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `error_handler` jest ustawione na "Set custom value" lub "Set custom error message"|

Następujące parametry i obsługi błędów są obsługiwane dla każdego typu przetwarzania wstępnego.

|Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers|
|------------------|----|-----------|-----------|-----------|------------------------|
|1|Custom multiplier|number^1, 6^|<|<|0, 1, 2, 3|
|2|Right trim|list of characters^2^|<|<|<|
|3|Left trim|list of characters^2^|<|<|<|
|4|Trim|list of characters^2^|<|<|<|
|5|Regular expression|pattern^3^|output^2^|<|0, 1, 2, 3|
|6|Boolean to decimal|<|<|<|0, 1, 2, 3|
|7|Octal to decimal|<|<|<|0, 1, 2, 3|
|8|Hexadecimal to decimal|<|<|<|0, 1, 2, 3|
|9|Simple change|<|<|<|0, 1, 2, 3|
|10|Change per second|<|<|<|0, 1, 2, 3|
|11|XML XPath|path^4^|<|<|0, 1, 2, 3|
|12|JSONPath|path^4^|<|<|0, 1, 2, 3|
|13|In range|min^1, 6^|max^1, 6^|<|0, 1, 2, 3|
|14|Matches regular expression|pattern^3^|<|<|0, 1, 2, 3|
|15|Does not match regular expression|pattern^3^|<|<|0, 1, 2, 3|
|16|Check for error in JSON|path^4^|<|<|0, 1, 2, 3|
|17|Check for error in XML|path^4^|<|<|0, 1, 2, 3|
|18|Check for error using regular expression|pattern^3^|output^2^|<|0, 1, 2, 3|
|19|Discard unchanged|<|<|<|<|
|20|Discard unchanged with heartbeat|seconds^5, 6^|<|<|<|
|21|JavaScript|script^2^|<|<|<|
|22|Prometheus pattern|pattern^6, 7^|`value`, `label`, `function`|output^8, 9^|0, 1, 2, 3|
|23|Prometheus to JSON|pattern^6, 7^|<|<|0, 1, 2, 3|
|24|CSV to JSON|character^2^|character^2^|0,1|0, 1, 2, 3|
|25|Replace|search string^2^|replacement^2^|<|<|
|26|Check unsupported|scope^1^|pattern^3, 6^|<|1, 2, 3|
|27|XML to JSON|<|<|<|0, 1, 2, 3|
|28|SNMP walk value|OID^2^|Format:<br>0 - Bez zmian<br>1 - UTF-8 z Hex-STRING<br>2 - MAC z Hex-STRING<br>3 - Integer z BITS|<|0, 1, 2, 3|
|29|SNMP walk to JSON^10^|Field name^2^|OID prefix^2^|Format:<br>0 - Bez zmian<br>1 - UTF-8 z Hex-STRING<br>2 - MAC z Hex-STRING<br>3 - Integer z BITS|0, 1, 2, 3|
|30|SNMP get value|Format:<br>1 - UTF-8 z Hex-STRING<br>2 - MAC z Hex-STRING<br>3 - Integer z BITS|<|<|0, 1, 2, 3|

^1^ liczba zmiennoprzecinkowa (liczby całkowite są niejawnie konwertowane do wartości zmiennoprzecinkowych)<br>
^2^ ciąg znaków<br>
^3^ wyrażenie regularne<br>
^4^ JSONPath lub XML XPath<br>
^5^ dodatnia liczba całkowita (z obsługą sufiksów czasu, np. 30s, 1m, 2h,
1d)<br>
^6^ makro użytkownika<br>
^7^ wzorzec Prometheus zgodny ze składnią:
`<metric name>{<label name>="<label value>", ...} == <value>`. Każdy
element wzorca Prometheus (nazwa metryki, nazwa etykiety, wartość etykiety i wartość metryki) może być makrem użytkownika.<br>
^8^ wynik Prometheus zgodny ze składnią: `<label name>` (może być makrem użytkownika), jeśli jako drugi parametr wybrano `label`.<br>
^9^ jedna z funkcji agregujących: `sum`, `min`, `max`, `avg`, `count`, jeśli jako drugi parametr wybrano `function`.<br>
^10^ obsługuje wiele rekordów "Field name,OID prefix,Format" rozdzielonych znakiem nowej linii.

[comment]: # ({/eed27a12-2169bb78})