en-us	### Item  ::: noteclassic Web items cannot be directly created, updated or deleted via the Zabbix API. :::  The item object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |itemid|string|*(readonly)* ID of the item.| |**delay**<br>(required)|string|Update interval of the item. Accepts seconds or a time unit with suffix (30s,1m,2h,1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Optional for Zabbix trapper, dependent items and for Zabbix agent (active) with `mqtt.get` key.| |**hostid**<br>(required)|string|ID of the host or template that the item belongs to.<br><br>For update operations this field is *readonly*.| |**interfaceid**<br>(required)|string|ID of the item's host interface.<br><br>Not required for template items. Optional for internal, active agent, trapper, calculated, dependent and database monitor items.| |**key\_**<br>(required)|string|Item key.| |**name**<br>(required)|string|Name of the item.| |**type**<br>(required)|integer|Type of the item.<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| |**url**<br>(required)|string|URL string, required only for HTTP agent item type. Supports user macros, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |**value\_type**<br>(required)|integer|Type of information of the item.<br><br>Possible values:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text.| |allow\_traps|integer|HTTP agent item field. Allow to populate value as in trapper item type also.<br><br>0 - *(default)* Do not allow to accept incoming data.<br>1 - Allow to accept incoming data.| |authtype|integer|Used only by SSH agent items or HTTP agent items.<br><br>SSH agent authentication method possible values:<br>0 - *(default)* password;<br>1 - public key.<br><br>HTTP agent authentication method possible values:<br>0 - *(default)* none<br>1 - basic<br>2 - NTLM<br>3 - Kerberos| |description|string|Description of the item.| |error|string|*(readonly)* Error text if there are problems updating the item.| |flags|integer|*(readonly)* Origin of the item.<br><br>Possible values:<br>0 - a plain item;<br>4 - a discovered item.| |follow\_redirects|integer|HTTP agent item field. Follow response redirects while pooling data.<br><br>0 - Do not follow redirects.<br>1 - *(default)* Follow redirects.| |headers|object|HTTP agent item field. Object with HTTP(S) request headers, where header name is used as key and header value as value.<br><br>Example:<br>{ "User-Agent": "Zabbix" }| |history|string|A time unit of how long the history data should be stored. Also accepts user macro.<br><br>Default: 90d.| |http\_proxy|string|HTTP agent item field. HTTP(S) proxy connection string.| |inventory\_link|integer|ID of the host inventory field that is populated by the item.<br><br>Refer to the [host inventory page](/manual/api/reference/host/object#host_inventory) for a list of supported host inventory fields and their IDs.<br><br>Default: 0.| |ipmi\_sensor|string|IPMI sensor. Used only by IPMI items.| |jmx\_endpoint|string|JMX agent custom connection string.<br><br>Default value:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi| |lastclock|timestamp|*(readonly)* Time when the item was last updated.<br><br>By default, only values that fall within the last 24 hours are displayed. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section.| |lastns|integer|*(readonly)* Nanoseconds when the item was last updated.<br><br>By default, only values that fall within the last 24 hours are displayed. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section.| |lastvalue|string|*(readonly)* Last value of the item.<br><br>By default, only values that fall within the last 24 hours are displayed. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section.| |logtimefmt|string|Format of the time in log entries. Used only by log items.| |master\_itemid|integer|Master item ID.<br>Recursion up to 3 dependent items and maximum count of dependent items equal to 29999 are allowed.<br><br>Required by dependent items.| |output\_format|integer|HTTP agent item field. Should response be converted to JSON.<br><br>0 - *(default)* Store raw.<br>1 - Convert to JSON.| |params|string|Additional parameters depending on the type of the item:<br>- executed script for SSH and Telnet items;<br>- SQL query for database monitor items;<br>- formula for calculated items;<br>- the script for script item.| |parameters|array|Additional parameters for script items. Array of objects with 'name' and 'value' properties, where name must be unique.| |password|string|Password for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br>When used by JMX, username should also be specified together with password or both properties should be left blank.| |post\_type|integer|HTTP agent item field. Type of post data body stored in posts property.<br><br>0 - *(default)* Raw data.<br>2 - JSON data.<br>3 - XML data.| |posts|string|HTTP agent item field. HTTP(S) request body data. Used with post\_type.| |prevvalue|string|*(readonly)* Previous value of the item.<br><br>By default, only values that fall within the last 24 hours are displayed. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section.| |privatekey|string|Name of the private key file.| |publickey|string|Name of the public key file.| |query\_fields|array|HTTP agent item field. Query parameters. Array of objects with 'key':'value' pairs, where value can be empty string.| |request\_method|integer|HTTP agent item field. Type of request method.<br><br>0 - *(default)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|HTTP agent item field. What part of response should be stored.<br><br>0 - *(default)* Body.<br>1 - Headers.<br>2 - Both body and headers will be stored.<br><br>For request\_method HEAD only 1 is allowed value.| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|HTTP agent item field. Public SSL Key file path.| |ssl\_key\_file|string|HTTP agent item field. Private SSL Key file path.| |ssl\_key\_password|string|HTTP agent item field. Password for SSL Key file.| |state|integer|*(readonly)* State of the item.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - not supported.| |status|integer|Status of the item.<br><br>Possible values:<br>0 - *(default)* enabled item;<br>1 - disabled item.| |status\_codes|string|HTTP agent item field. Ranges of required HTTP status codes separated by commas. Also supports user macros as part of comma separated list.<br><br>Example: 200,200-{$M},{$M},200-400| |templateid|string|(readonly) ID of the parent template item.<br><br>*Hint*: Use the `hostid` property to specify the template that the item belongs to.| |timeout|string|Item data polling request timeout. Used for HTTP agent and script items. Supports user macros.<br><br>default: 3s<br>maximum value: 60s| |trapper\_hosts|string|Allowed hosts. Used by trapper items or HTTP agent items.| |trends|string|A time unit of how long the trends data should be stored. Also accepts user macro.<br><br>Default: 365d.| |units|string|Value units.| |username|string|Username for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>Required by SSH and Telnet items.<br>When used by JMX, password should also be specified together with username or both properties should be left blank.| |uuid|string|Universal unique identifier, used for linking imported item to already existing ones. Used only for items on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| |valuemapid|string|ID of the associated value map.| |verify\_host|integer|HTTP agent item field. Validate host name in URL is in Common Name field or a Subject Alternate Name field of host certificate.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.| |verify\_peer|integer|HTTP agent item field. Validate is host certificate authentic.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.|
pt-br	### Item  ::: noteclassic Os itens da Web não podem ser criados, atualizados ou excluídos diretamente por meio de a API do Zabbix. :::  O objeto item tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |itemid|string|*(readonly)* ID do item.| |**atraso**<br>(obrigatório)|string|Intervalo de atualização do item. Aceita segundos ou uma unidade de tempo com sufixo (30s,1m,2h,1d).<br>Opcionalmente, um ou mais [intervalos personalizados](/manual/config/items/item/custom_intervals) podem ser especificados como intervalos flexíveis ou agendamento .<br>Vários intervalos são separados por um ponto e vírgula.<br>As macros do usuário podem ser usadas. Uma única macro deve preencher todo o campo. Não há suporte para várias macros em um campo ou macros misturadas com texto.<br>Intervalos flexíveis podem ser escritos como duas macros separadas por uma barra (por exemplo, `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br >Opcional para Zabbix trapper, itens dependentes e para Zabbix agent (ativo) com chave `mqtt.get`.| |**hostid**<br>(obrigatório)|string|ID do host ou modelo ao qual o item pertence.<br><br>Para operações de atualização, este campo é *readonly*.| |**interfaceid**<br>(obrigatório)|string|ID da interface do host do item.<br><br>Não obrigatório para itens de modelo. Opcional para itens internos, agente ativo, trapper, calculado, dependente e monitor de banco de dados.| |**chave\_**<br>(obrigatório)|string|Chave do item.| |**nome**<br>(obrigatório)|string|Nome do item.| |**tipo**<br>(obrigatório)|inteiro|Tipo do item.<br><br>Valores possíveis:<br>0 - Zabbix agent;<br>2 - Zabbix trapper;<br>3 - Verificação simples;<br>5 - Zabbix interno;<br>7 - Agente Zabbix (ativo);<br>9 - Item da Web;<br>10 - Verificação externa;<br>11 - Monitor de banco de dados;<br>12 - Agente IPMI;<br>13 - Agente SSH;<br>14 - Agente Telnet;<br>15 - Calculado;<br>16 - Agente JMX;<br>17 - Armadilha SNMP;<br>18 - Item dependente ;<br>19 - Agente HTTP;<br>20 - Agente SNMP;<br>21 - Script| |**url**<br>(obrigatório)|string|string de URL, necessária apenas para o tipo de item de agente HTTP. Suporta macros de usuário, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |**valor\_tipo**<br>(obrigatório)|inteiro|Tipo de informação do item.<br><br>Valores possíveis:<br>0 - número flutuante;<br>1 - caractere;<br >2 - log;<br>3 - numérico sem sinal;<br>4 - texto.| |allow\_traps|inteiro|campo de item do agente HTTP. Permitir preencher valor como no tipo de item trapper também.<br><br>0 - *(padrão)* Não permitir aceitar dados de entrada.<br>1 - Permitir aceitar dados de entrada.| |authtype|integer|Usado apenas por itens do agente SSH ou itens do agente HTTP.<br><br>Valores possíveis do método de autenticação do agente SSH:<br>0 - *(padrão)* senha;<br>1 - chave pública.< br><br>método de autenticação do agente HTTP valores possíveis:<br>0 - *(padrão)* nenhum<br>1 - básico<br>2 - NTLM<br>3 - Kerberos| |descrição|string|Descrição do item.| |error|string|*(readonly)* Texto de erro se houver problemas ao atualizar o item.| |flags|inteiro|*(somente leitura)* Origem do item.<br><br>Valores possíveis:<br>0 - um item simples;<br>4 - um item descoberto.| |follow\_redirects|inteiro|campo de item do agente HTTP. Siga os redirecionamentos de resposta ao agrupar dados.<br><br>0 - Não siga os redirecionamentos.<br>1 - *(padrão)* Siga os redirecionamentos.| |headers|object|campo de item do agente HTTP. Objeto com cabeçalhos de solicitação HTTP(S), onde o nome do cabeçalho é usado como chave e o valor do cabeçalho como valor.<br><br>Exemplo:<br>{ "User-Agent": "Zabbix" }| |history|string|Uma unidade de tempo de quanto tempo os dados do histórico devem ser armazenados. Também aceita macro de usuário.<br><br>Padrão: 90d.| |http\_proxy|string|campo de item do agente HTTP. Cadeia de conexão do proxy HTTP(S).| |inventário\_link|inteiro|ID do campo de inventário do host que é preenchido pelo item.<br><br>Consulte a [página de inventário do host](/manual/api/reference/host/object#host_inventory) para obter um lista de campos de inventário de host suportados e seus IDs.<br><br>Padrão: 0.| |ipmi\_sensor|string|sensor IPMI. Usado apenas por itens do IPMI.| |jmx\_endpoint|string|String de conexão personalizada do agente JMX.<br><br>Valor padrão:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT }/jmxrmi| |lastclock|timestamp|*(readonly)* Hora em que o item foi atualizado pela última vez.<br><br>Por padrão, apenas os valores que se enquadram nas últimas 24 horas são exibidos. Você pode estender esse período alterando o valor do parâmetro *Período máximo de exibição do histórico* na seção de menu *[Administração → Geral](/manual/web_interface/frontend_sections/administration/general#gui)*.| |lastns|integer|*(readonly)* Nanossegundos quando o item foi atualizado pela última vez.<br><br>Por padrão, apenas os valores que se enquadram nas últimas 24 horas são exibidos. Você pode estender esse período alterando o valor do parâmetro *Período máximo de exibição do histórico* na seção de menu *[Administração → Geral](/manual/web_interface/frontend_sections/administration/general#gui)*.| |lastvalue|string|*(readonly)* Último valor do item.<br><br>Por padrão, apenas os valores das últimas 24 horas são exibidos. Você pode estender esse período de tempo alterando o value do parâmetro *Período máximo de exibição do histórico* na seção de menu *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)*.| |logtimefmt|string|Formato da hora nas entradas de log. Usado apenas por itens de log.| |master\_itemid|integer|ID do item mestre.<br>Recursão de até 3 itens dependentes e contagem máxima de itens dependentes igual a 29999 são permitidas.<br><br>Requerido por itens dependentes.| |output\_format|inteiro|campo de item do agente HTTP. A resposta deve ser convertida em JSON.<br><br>0 - *(padrão)* Armazenar raw.<br>1 - Converter em JSON.| |params|string|Parâmetros adicionais dependendo do tipo do item:<br>- script executado para itens SSH e Telnet;<br>- consulta SQL para itens do monitor de banco de dados;<br>- fórmula para itens calculados;<br> - o script para o item de script.| |parameters|array|Parâmetros adicionais para itens de script. Matriz de objetos com propriedades 'nome' e 'valor', onde o nome deve ser exclusivo.| |senha|string|Senha para autenticação. Usado por itens de verificação simples, SSH, Telnet, monitor de banco de dados, JMX e agente HTTP.<br>Quando usado por JMX, o nome de usuário também deve ser especificado junto com a senha ou ambas as propriedades devem ser deixadas em branco.| |post\_type|inteiro|campo de item do agente HTTP. Tipo de corpo de dados de postagem armazenado na propriedade de postagens.<br><br>0 - *(padrão)* Dados brutos.<br>2 - Dados JSON.<br>3 - Dados XML.| |posts|string|campo de item do agente HTTP. Dados do corpo da solicitação HTTP(S). Usado com post\_type.| |prevvalue|string|*(readonly)* Valor anterior do item.<br><br>Por padrão, apenas os valores das últimas 24 horas são exibidos. Você pode estender esse período alterando o valor do parâmetro *Período máximo de exibição do histórico* na seção de menu *[Administração → Geral](/manual/web_interface/frontend_sections/administration/general#gui)*.| |privatekey|string|Nome do arquivo de chave privada.| |publickey|string|Nome do arquivo de chave pública.| |query\_fields|array|campo de item do agente HTTP. Parâmetros de consulta. Matriz de objetos com pares 'chave':'valor', onde valor pode ser uma string vazia.| |request\_method|integer|campo de item do agente HTTP. Tipo de método de solicitação.<br><br>0 - *(padrão)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |recuperar\_modo|inteiro|campo de item do agente HTTP. Qual parte da resposta deve ser armazenada.<br><br>0 - *(padrão)* Corpo.<br>1 - Cabeçalhos.<br>2 - O corpo e os cabeçalhos serão armazenados.<br><br>Para request\_method HEAD somente 1 é o valor permitido.| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|campo de item do agente HTTP. Caminho do arquivo de chave SSL pública.| |ssl\_key\_file|string|campo de item do agente HTTP. Caminho do arquivo de chave SSL privada.| |ssl\_key\_password|string|campo de item do agente HTTP. Senha para arquivo de chave SSL.| |estado|inteiro|*(somente leitura)* Estado do item.<br><br>Valores possíveis:<br>0 - *(padrão)* normal;<br>1 - não suportado.| |status|inteiro|Status do item.<br><br>Valores possíveis:<br>0 - *(padrão)* item habilitado;<br>1 - item desabilitado.| |status\_codes|string|campo de item do agente HTTP. Intervalos de códigos de status HTTP necessários separados por vírgulas. Também suporta macros de usuário como parte da lista separada por vírgulas.<br><br>Exemplo: 200,200-{$M},{$M},200-400| |templateid|string|(somente leitura) ID do item de modelo pai.<br><br>*Dica*: Use a propriedade `hostid` para especificar o modelo ao qual o item pertence.| |timeout|string|Tempo limite da solicitação de sondagem de dados do item. Usado para agente HTTP e itens de script. Suporta macros de usuário.<br><br>padrão: 3s<br>valor máximo: 60s| |trapper\_hosts|string|Hosts permitidos. Usado por itens de trapper ou itens de agente HTTP.| |trends|string|Uma unidade de tempo de quanto tempo os dados de tendências devem ser armazenados. Também aceita macro de usuário.<br><br>Padrão: 365d.| |unidades|string|Unidades de valor.| |username|string|Username para autenticação. Usado por verificação simples, SSH, Telnet, monitor de banco de dados, itens de agente JMX e HTTP.<br><br>Requerido por itens SSH e Telnet.<br>Quando usado por JMX, a senha também deve ser especificada junto com o nome de usuário ou ambas as propriedades deve ser deixado em branco.| |uuid|string|Identificador único universal, usado para vincular item importado a itens já existentes. Usado apenas para itens em modelos. Gerado automaticamente, se não fornecido.<br><br>Para operações de atualização, este campo é *somente leitura*.| |valuemapid|string|ID do mapa de valores associado.| |verify\_host|inteiro|campo de item do agente HTTP. Validar o nome do host na URL está no campo Nome Comum ou em um campo Nome Alternativo da Entidade do certificado do host.<br><br>0 - *(padrão)* Não validar.<br>1 - Validar.| |verify\_peer|integer|campo de item do agente HTTP. Validar é o certificado do host autêntico.<br><br>0 - *(padrão)* Não validar.<br>1 - Validar.|

en-us	# > Item object  The following objects are directly related to the `item` API.
pt-br	# > Objeto de item  Os objetos a seguir estão diretamente relacionados à API `item`.

en-us	### Item preprocessing  The item preprocessing object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |**type**<br>(required)|integer|The preprocessing option type.<br><br>Possible values:<br>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression matching;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check unsupported;<br>27 - XML to JSON.| |**params**<br>(required)|string|Additional parameters used by preprocessing option. Multiple parameters are separated by LF (\\n) character.| |**error\_handler**<br>(required)|integer|Action type used in case of preprocessing step failure.<br><br>Possible values:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.| |**error\_handler\_params**<br>(required)|string|Error handler parameters. Used with `error_handler`.<br><br>Must be empty, if `error_handler` is 0 or 1.<br>Can be empty if, `error_handler` is 2.<br>Cannot be empty, if `error_handler` is 3.|  The following parameters and error handlers are supported for each preprocessing type.  |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|<|<|<|1, 2, 3| |27|XML to JSON|<|<|<|0, 1, 2, 3|  ^1^ integer or floating-point number\ ^2^ string\ ^3^ regular expression\ ^4^ JSONPath or XML XPath\ ^5^ positive integer (with support of time suffixes, e.g. 30s, 1m, 2h, 1d)\ ^6^ user macro\ ^7^ Prometheus pattern following the syntax: `<metric name>{<label name>="<label value>", ...} == <value>`. Each Prometheus pattern component (metric, label name, label value and metric value) can be user macro.\ ^8^ Prometheus output following the syntax: `<label name>` (can be a user macro) if `label` is selected as the second parameter.\ ^9^ One of the aggregation functions: `sum`, `min`, `max`, `avg`, `count` if `function` is selected as the second parameter.
pt-br	### Pré-processamento de itens  O objeto de pré-processamento de item tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |**tipo**<br>(obrigatório)|inteiro|O tipo de opção de pré-processamento.<br><br>Valores possíveis:<br>1 - Multiplicador personalizado;<br>2 - Corte direito;<br>3 - Trim esquerdo;<br>4 - Trim;<br>5 - Correspondência de expressão regular;<br>6 - Booleano para decimal;<br>7 - Octal para decimal;<br>8 - Hexadecimal para decimal;<br>9 - Alteração simples;<br>10 - Alteração por segundo;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - No intervalo;<br>14 - Corresponde à expressão regular;<br>15 - Não corresponde à expressão regular;<br>16 - Verifique se há erro no JSON;<br>17 - Verifique se há erro no XML;<br>18 - Verifique se há erro usando a expressão regular;<br>19 - Descarte inalterado;<br >20 - Descartar inalterado com pulsação;<br>21 - JavaScript;<br>22 - Padrão Prometheus;<br>23 - Prometheus para JSON;<br>24 - CSV para JSON;<br>25 - Substituir;<br >26 - Verificação não suportada;<br>27 - XML para JSON.| |**params**<br>(obrigatório)|string|Parâmetros adicionais usados pela opção de pré-processamento. Vários parâmetros são separados pelo caractere LF (\\n).| |**error\_handler**<br>(obrigatório)|inteiro|Tipo de ação usado em caso de falha na etapa de pré-processamento.<br><br>Valores possíveis:<br>0 - Mensagem de erro é definida pelo servidor Zabbix;< br>1 - Descartar valor;<br>2 - Definir valor personalizado;<br>3 - Definir mensagem de erro personalizada.| |**error\_handler\_params**<br>(obrigatório)|string|Parâmetros do manipulador de erros. Usado com `error_handler`.<br><br>Deve estar vazio, se `error_handler` for 0 ou 1.<br>Pode estar vazio se, `error_handler` for 2.<br>Não pode estar vazio, se `error_handler` é 3.|  Os seguintes parâmetros e manipuladores de erros são suportados para cada tipo de pré-processamento.  |Tipo de pré-processamento|Nome|Parâmetro 1|Parâmetro 2|Parâmetro 3|Manipuladores de erro suportados| |------------------|----|-----------|-----------|- ----------|------------------------| |1|Multiplicador personalizado|número^1,\6^|<|<|0, 1, 2, 3| |2|Corte direito|lista de caracteres^2^|<|<|<| |3|Corte esquerdo|lista de caracteres^2^|<|<|<| |4|Cortar|lista de caracteres^2^|<|<|<| |5|Expressão regular|padrão^3^|saída^2^|<|0, 1, 2, 3| |6|Booleano para decimal|<|<|<|0, 1, 2, 3| |7|Octal para decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal para decimal|<|<|<|0, 1, 2, 3| |9|Mudança simples|<|<|<|0, 1, 2, 3| |10|Mudança por segundo|<|<|<|0, 1, 2, 3| |11|XML XPath|caminho^4^|<|<|0, 1, 2, 3| |12|JSONPath|caminho^4^|<|<|0, 1, 2, 3| |13|No intervalo|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3| |14|Corresponde à expressão regular|padrão^3^|<|<|0, 1, 2, 3| |15|Não corresponde à expressão regular|padrão^3^|<|<|0, 1, 2, 3| |16|Verifique se há erro em JSON|path^4^|<|<|0, 1, 2, 3| |17|Verificar erros em XML|path^4^|<|<|0, 1, 2, 3| |18|Verifique se há erro usando expressão regular|pattern^3^|output^2^|<|0, 1, 2, 3| |19|Descartar inalterado|<|<|<|<| |20|Descartar inalterado com pulsação|segundos^5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Padrão do Prometheus|padrão^6,\ 7^|`valor`, `rótulo`, `função`|saída^8,\ 9^|0, 1, 2, 3| |23|Prometheus para JSON|pattern^6,\7^|<|<|0, 1, 2, 3| |24|CSV para JSON|caractere^2^|caractere^2^|0,1|0, 1, 2, 3| |25|Substituir|sequência de pesquisa^2^|substituição^2^|<|<| |26|Verificação não suportada|<|<|<|1, 2, 3| |27|XML para JSON|<|<|<|0, 1, 2, 3|  ^1^ número inteiro ou de ponto flutuante\ ^2^ seqüência de caracteres\ ^3^ expressão regular\ ^4^ JSONPath ou XML XPath\ ^5^ inteiro positivo (com suporte de sufixos de tempo, por exemplo, 30s, 1m, 2h, 1d)\ ^6^ macro do usuário\ ^7^ Padrão do Prometheus seguindo a sintaxe: `<nome da métrica>{<nome do rótulo>="<valor do rótulo>", ...} == <valor>`. Cada Componente padrão do Prometheus (métrica, nome do rótulo, valor do rótulo e métrica value) pode ser macro do usuário.\ ^8^ Saída do Prometheus seguindo a sintaxe: `<label name>` (pode ser uma macro de usuário) se `label` for selecionado como o segundo parâmetro.\ ^9^ Uma das funções de agregação: `sum`, `min`, `max`, `avg`, `count` se `function` for selecionado como o segundo parâmetro.

en-us	#### itemprototype  Bug fixes:\ [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `itemprototype.create`, `itemprototype.update`: property `interfaceid` is no longer required to create/update a HTTP agent type item prototype.\
pt-br	#### itemprotótipo  Correções de bugs:\ [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `itemprototype.create`, `itemprototype.update`: A propriedade `interfaceid` não é mais necessária para criar/atualizar um protótipo de item do tipo de agente HTTP.\

en-us	#### item prototype  Changes:\ [ZBXNEXT-7049](https://support.zabbix.com/browse/ZBXNEXT-7049) `itemprototype.get`, `itemprototype.create`, `itemprototype.update`: added the third parameter to the Prometheus pattern preprocessing step. The second parameter will now determine an aggregation method: `value`, `label`, `function`. The third parameter will now contain Prometheus output for the aggregation method `label` or an aggregation function for the aggregation method `function`.\
pt-br	#### item prototype  Changes:\ [ZBXNEXT-7049](https://support.zabbix.com/browse/ZBXNEXT-7049) `itemprototype.get`, `itemprototype.create`, `itemprototype.update`: adicionado o terceiro parâmetro ao pré-processamento no padrão Prometheus. O segundo parâmetro agora determinará um método de agregação: `value`, `label`, `function`. O terceiro parâmetro agora conterá a saída do Prometheus para o método de agregação `label` ou a função de agregação para o método de agregação `function`.\

en-us	#### itemprototype  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `itemprototype.update`: the parameter `uuid` can now be updated.\
pt-br	#### itemprototype  Mudanças:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `itemprototype.update`: o parâmetro `uuid` pode agora ser atualizado.\

en-us	# itemprototype.create
pt-br	# itemprototype.create

en-us	# itemprototype.delete
pt-br	# itemprototype.delete

en-us	# itemprototype.get
pt-br	# itemprototype.get

en-us	# > Item prototype object  The following objects are directly related to the `itemprototype` API.
pt-br	# > Objeto protótipo de item  Os objetos a seguir estão diretamente relacionados à API `itemprototype`.

en-us	### Item prototype preprocessing  The item prototype preprocessing object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |**type**<br>(required)|integer|The preprocessing option type.<br><br>Possible values:<br>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression matching;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check unsupported;<br>27 - XML to JSON.| |**params**<br>(required)|string|Additional parameters used by preprocessing option. Multiple parameters are separated by LF (\\n) character.| |**error\_handler**<br>(required)|integer|Action type used in case of preprocessing step failure.<br><br>Possible values:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.| |**error\_handler\_params**<br>(required)|string|Error handler parameters. Used with `error_handler`.<br><br>Must be empty, if `error_handler` is 0 or 1.<br>Can be empty if, `error_handler` is 2.<br>Cannot be empty, if `error_handler` is 3.|  The following parameters and error handlers are supported for each preprocessing type.  |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|<|<|<|1, 2, 3| |27|XML to JSON|<|<|<|0, 1, 2, 3|  ^1^ integer or floating-point number\ ^2^ string\ ^3^ regular expression\ ^4^ JSONPath or XML XPath\ ^5^ positive integer (with support of time suffixes, e.g. 30s, 1m, 2h, 1d)\ ^6^ user macro, LLD macro\ ^7^ Prometheus pattern following the syntax: `<metric name>{<label name>="<label value>", ...} == <value>`. Each Prometheus pattern component (metric, label name, label value and metric value) can be user macro or LLD macro.\ ^8^ Prometheus output following the syntax: `<label name>` (can be a user macro or an LLD macro) if `label` is selected as the second parameter.\ ^9^ One of the aggregation functions: `sum`, `min`, `max`, `avg`, `count` if `function` is selected as the second parameter.
pt-br	### Pré-processamento de protótipo de item  O objeto de pré-processamento de protótipo de item tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |**tipo**<br>(obrigatório)|inteiro|O tipo de opção de pré-processamento.<br><br>Valores possíveis:<br>1 - Multiplicador personalizado;<br>2 - Corte direito;<br>3 - Trim esquerdo;<br>4 - Trim;<br>5 - Correspondência de expressão regular;<br>6 - Booleano para decimal;<br>7 - Octal para decimal;<br>8 - Hexadecimal para decimal;<br>9 - Alteração simples;<br>10 - Alteração por segundo;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - No intervalo;<br>14 - Corresponde à expressão regular;<br>15 - Não corresponde à expressão regular;<br>16 - Verifique se há erro no JSON;<br>17 - Verifique se há erro no XML;<br>18 - Verifique se há erro usando a expressão regular;<br>19 - Descarte inalterado;<br >20 - Descartar inalterado com pulsação;<br>21 - JavaScript;<br>22 - Padrão Prometheus;<br>23 - Prometheus para JSON;<br>24 - CSV para JSON;<br>25 - Substituir;<br >26 - Verificação não suportada;<br>27 - XML para JSON.| |**params**<br>(obrigatório)|string|Parâmetros adicionais usados pela opção de pré-processamento. Vários parâmetros são separados pelo caractere LF (\\n).| |**error\_handler**<br>(obrigatório)|inteiro|Tipo de ação usado em caso de falha na etapa de pré-processamento.<br><br>Valores possíveis:<br>0 - Mensagem de erro é definida pelo servidor Zabbix;< br>1 - Descartar valor;<br>2 - Definir valor personalizado;<br>3 - Definir mensagem de erro personalizada.| |**error\_handler\_params**<br>(obrigatório)|string|Parâmetros do manipulador de erros. Usado com `error_handler`.<br><br>Deve estar vazio, se `error_handler` for 0 ou 1.<br>Pode estar vazio se, `error_handler` for 2.<br>Não pode estar vazio, se `error_handler` é 3.|  Os seguintes parâmetros e manipuladores de erros são suportados para cada tipo de pré-processamento.  |Tipo de pré-processamento|Nome|Parâmetro 1|Parâmetro 2|Parâmetro 3|Manipuladores de erro suportados| |------------------|----|-----------|-----------|- ----------|------------------------| |1|Multiplicador personalizado|número^1,\6^|<|<|0, 1, 2, 3| |2|Corte direito|lista de caracteres^2^|<|<|<| |3|Corte esquerdo|lista de caracteres^2^|<|<|<| |4|Cortar|lista de caracteres^2^|<|<|<| |5|Expressão regular|padrão^3^|saída^2^|<|0, 1, 2, 3| |6|Booleano para decimal|<|<|<|0, 1, 2, 3| |7|Octal para decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal para decimal|<|<|<|0, 1, 2, 3| |9|Mudança simples|<|<|<|0, 1, 2, 3| |10|Mudança por segundo|<|<|<|0, 1, 2, 3| |11|XML XPath|caminho^4^|<|<|0, 1, 2, 3| |12|JSONPath|caminho^4^|<|<|0, 1, 2, 3| |13|No intervalo|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3| |14|Corresponde à expressão regular|padrão^3^|<|<|0, 1, 2, 3| |15|Não corresponde à expressão regular|padrão^3^|<|<|0, 1, 2, 3| |16|Verifique se há erro em JSON|path^4^|<|<|0, 1, 2, 3| |17|Verificar erros em XML|path^4^|<|<|0, 1, 2, 3| |18|Verifique se há erro usando expressão regular|pattern^3^|output^2^|<|0, 1, 2, 3| |19|Descartar inalterado|<|<|<|<| |20|Descartar inalterado com pulsação|segundos^5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Padrão do Prometheus|padrão^6,\ 7^|`valor`, `rótulo`, `função`|saída^8,\ 9^|0, 1, 2, 3| |23|Prometheus para JSON|pattern^6,\7^|<|<|0, 1, 2, 3| |24|CSV para JSON|caractere^2^|caractere^2^|0,1|0, 1, 2, 3| |25|Substituir|sequência de pesquisa^2^|substituição^2^|<|<| |26|Verificação não suportada|<|<|<|1, 2, 3| |27|XML para JSON|<|<|<|0, 1, 2, 3|  ^1^ número inteiro ou de ponto flutuante\ ^2^ seqüência de caracteres\ ^3^ expressão regular\ ^4^ JSONPath ou XML XPath\ ^5^ inteiro positivo (com suporte de sufixos de tempo, por exemplo, 30s, 1m, 2h, 1d)\ ^6^ macro do usuário, macro LLD\ ^7^ Padrão do Prometheus seguindo a sintaxe: `<nome da métrica>{<nome do rótulo>="<valor do rótulo>", ...} == <valor>`. Cada Componente padrão do Prometheus (métrica, nome do rótulo, valor do rótulo e métrica value) pode ser macro de usuário ou macro LLD.\ ^8^ Saída do Prometheus seguindo a sintaxe: `<label name>` (pode ser uma macro de usuário ou uma macro LLD) se `label` for selecionado como o segundo parâmetro.\ ^9^ Uma das funções de agregação: `sum`, `min`, `max`, `avg`, `count` se `function` for selecionado como o segundo parâmetro.

en-us	#### Item prototypes  The following screenshot illustrates how we can use these macros in item prototypes:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/item_prototype_snmp.png)  Again, creating as many item prototypes as needed:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/item_prototypes_snmp.png)
pt-br	#### Protótipos de itens  A captura de tela a seguir ilustra como podemos usar essas macros no item protótipos:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/item_prototype_snmp.png)  Novamente, criando quantos protótipos de itens forem necessários:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/item_prototypes_snmp.png)

en-us	### Item prototype tag  The item prototype tag object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |**tag**<br>(required)|string|Item prototype tag name.| |value|string|Item prototype tag value.|
pt-br	### Tag de protótipo de item  O objeto de tag de protótipo de item tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |**tag**<br>(obrigatório)|string|Nome da tag do protótipo do item.| |valor|string|Valor da tag de protótipo do item.|

en-us	### Item prototype  The item prototype object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |itemid|string|*(readonly)* ID of the item prototype.| |**delay**<br>(required)|string|Update interval of the item prototype. Accepts seconds or a time unit with suffix (30s,1m,2h,1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros and LLD macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Optional for Zabbix trapper, dependent items and for Zabbix agent (active) with `mqtt.get` key.| |**hostid**<br>(required)|string|ID of the host that the item prototype belongs to.<br><br>For update operations this field is *readonly*.| |**ruleid**<br>(required)|string|ID of the LLD rule that the item belongs to.<br><br>For update operations this field is *readonly*.| |**interfaceid**<br>(required)|string|ID of the item prototype's host interface. Used only for host item prototypes.<br><br>Optional for Zabbix agent (active), Zabbix internal, Zabbix trapper, Dependent item, database monitor and calculated item prototypes.| |**key\_**<br>(required)|string|Item prototype key.| |**name**<br>(required)|string|Name of the item prototype.| |**type**<br>(required)|integer|Type of the item prototype.<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>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.| |**url**<br>(required)|string|URL string required only for HTTP agent item prototypes. Supports LLD macros, user macros, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |**value\_type**<br>(required)|integer|Type of information of the item prototype.<br><br>Possible values:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text.| |allow\_traps|integer|HTTP agent item prototype field. Allow to populate value as in trapper item type also.<br><br>0 - *(default)* Do not allow to accept incoming data.<br>1 - Allow to accept incoming data.| |authtype|integer|Used only by SSH agent item prototypes or HTTP agent item prototypes.<br><br>SSH agent authentication method possible values:<br>0 - *(default)* password;<br>1 - public key.<br><br>HTTP agent authentication method possible values:<br>0 - *(default)* none<br>1 - basic<br>2 - NTLM<br>3 - Kerberos| |description|string|Description of the item prototype.| |follow\_redirects|integer|HTTP agent item prototype field. Follow response redirects while pooling data.<br><br>0 - Do not follow redirects.<br>1 - *(default)* Follow redirects.| |headers|object|HTTP agent item prototype field. Object with HTTP(S) request headers, where header name is used as key and header value as value.<br><br>Example:<br>{ "User-Agent": "Zabbix" }| |history|string|A time unit of how long the history data should be stored. Also accepts user macro and LLD macro.<br><br>Default: 90d.| |http\_proxy|string|HTTP agent item prototype field. HTTP(S) proxy connection string.| |ipmi\_sensor|string|IPMI sensor. Used only by IPMI item prototypes.| |jmx\_endpoint|string|JMX agent custom connection string.<br><br>Default value:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi| |logtimefmt|string|Format of the time in log entries. Used only by log item prototypes.| |master\_itemid|integer|Master item ID.<br>Recursion up to 3 dependent items and item prototypes and maximum count of dependent items and item prototypes equal to 29999 are allowed.<br><br>Required by Dependent items.| |output\_format|integer|HTTP agent item prototype field. Should response be converted to JSON.<br><br>0 - *(default)* Store raw.<br>1 - Convert to JSON.| |params|string|Additional parameters depending on the type of the item prototype:<br>- executed script for SSH and Telnet item prototypes;<br>- SQL query for database monitor item prototypes;<br>- formula for calculated item prototypes.| |parameters|array|Additional parameters for script item prototypes. Array of objects with 'name' and 'value' properties, where name must be unique.| |password|string|Password for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent item prototypes.| |post\_type|integer|HTTP agent item prototype field. Type of post data body stored in posts property.<br><br>0 - *(default)* Raw data.<br>2 - JSON data.<br>3 - XML data.| |posts|string|HTTP agent item prototype field. HTTP(S) request body data. Used with post\_type.| |privatekey|string|Name of the private key file.| |publickey|string|Name of the public key file.| |query\_fields|array|HTTP agent item prototype field. Query parameters. Array of objects with 'key':'value' pairs, where value can be empty string.| |request\_method|integer|HTTP agent item prototype field. Type of request method.<br><br>0 - *(default)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|HTTP agent item prototype field. What part of response should be stored.<br><br>0 - *(default)* Body.<br>1 - Headers.<br>2 - Both body and headers will be stored.<br><br>For request\_method HEAD only 1 is allowed value.| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|HTTP agent item prototype field. Public SSL Key file path.| |ssl\_key\_file|string|HTTP agent item prototype field. Private SSL Key file path.| |ssl\_key\_password|string|HTTP agent item prototype field. Password for SSL Key file.| |status|integer|Status of the item prototype.<br><br>Possible values:<br>0 - *(default)* enabled item prototype;<br>1 - disabled item prototype;<br>3 - unsupported item prototype.| |status\_codes|string|HTTP agent item prototype field. Ranges of required HTTP status codes separated by commas. Also supports user macros or LLD macros as part of comma separated list.<br><br>Example: 200,200-{$M},{$M},200-400| |templateid|string|(readonly) ID of the parent template item prototype.| |timeout|string|Item data polling request timeout. Used for HTTP agent and script item prototypes. Supports user macros and LLD macros.<br><br>default: 3s<br>maximum value: 60s| |trapper\_hosts|string|Allowed hosts. Used by trapper item prototypes or HTTP item prototypes.| |trends|string|A time unit of how long the trends data should be stored. Also accepts user macro and LLD macro.<br><br>Default: 365d.| |units|string|Value units.| |username|string|Username for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent item prototypes.<br><br>Required by SSH and Telnet item prototypes.| |uuid|string|Universal unique identifier, used for linking imported item prototypes to already existing ones. Used only for item prototypes on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| |valuemapid|string|ID of the associated value map.| |verify\_host|integer|HTTP agent item prototype field. Validate host name in URL is in Common Name field or a Subject Alternate Name field of host certificate.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.<br>| |verify\_peer|integer|HTTP agent item prototype field. Validate is host certificate authentic.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.| |discover|integer|Item prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new items will be discovered;<br>1 - new items will not be discovered and existing items will be marked as lost.|
pt-br	### Protótipo de item  O objeto protótipo de item tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |itemid|string|*(readonly)* ID do protótipo do item.| |**atraso**<br>(obrigatório)|string|Intervalo de atualização do protótipo do item. Aceita segundos ou uma unidade de tempo com sufixo (30s,1m,2h,1d).<br>Opcionalmente, um ou mais [intervalos personalizados](/manual/config/items/item/custom_intervals) podem ser especificados como intervalos flexíveis ou agendamento .<br>Vários intervalos são separados por um ponto e vírgula.<br>Macros de usuário e macros LLD podem ser usados. Uma única macro deve preencher todo o campo. Não há suporte para várias macros em um campo ou macros misturadas com texto.<br>Intervalos flexíveis podem ser escritos como duas macros separadas por uma barra (por exemplo, `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br >Opcional para Zabbix trapper, itens dependentes e para Zabbix agent (ativo) com chave `mqtt.get`.| |**hostid**<br>(obrigatório)|string|ID do host ao qual o protótipo do item pertence.<br><br>Para operações de atualização, este campo é *readonly*.| |**ruleid**<br>(obrigatório)|string|ID da regra LLD à qual o item pertence.<br><br>Para operações de atualização, este campo é *readonly*.| |**interfaceid**<br>(obrigatório)|string|ID da interface do host do protótipo do item. Usado apenas para protótipos de itens de host.<br><br>Opcional para agente Zabbix (ativo), Zabbix interno, Zabbix trapper, item dependente, monitor de banco de dados e protótipos de itens calculados.| |**chave\_**<br>(obrigatório)|string|Chave de protótipo do item.| |**nome**<br>(obrigatório)|string|Nome do protótipo do item.| |**tipo**<br>(obrigatório)|inteiro|Tipo do protótipo do item.<br><br>Valores possíveis:<br>0 - Zabbix agent;<br>2 - Zabbix trapper;<br>3 - verificação simples;<br>5 - Zabbix interno;<br>7 - agente Zabbix (ativo);<br>10 - verificação externa;<br>11 - monitor de banco de dados;<br>12 - agente IPMI;<br> 13 - Agente SSH;<br>14 - Agente TELNET;<br>15 - calculado;<br>16 - Agente JMX;<br>17 - Trap SNMP;<br>18 - Item dependente;<br>19 - HTTP agente;<br>20 - Agente SNMP;<br>21 - Script.| |**url**<br>(obrigatório)|string|string de URL necessária apenas para protótipos de item de agente HTTP. Suporta macros LLD, macros de usuário, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |**valor\_tipo**<br>(obrigatório)|inteiro|Tipo de informação do protótipo do item.<br><br>Valores possíveis:<br>0 - número flutuante;<br>1 - caractere;< br>2 - log;<br>3 - numérico sem sinal;<br>4 - texto.| |allow\_traps|integer|campo de protótipo de item do agente HTTP. Permitir preencher valor como no tipo de item trapper também.<br><br>0 - *(padrão)* Não permitir aceitar dados de entrada.<br>1 - Permitir aceitar dados de entrada.| |authtype|integer|Usado apenas por protótipos de item de agente SSH ou protótipos de item de agente HTTP.<br><br>Método de autenticação de agente SSH valores possíveis:<br>0 - *(padrão)* senha;<br>1 - chave pública .<br><br>Método de autenticação do agente HTTP valores possíveis:<br>0 - *(padrão)* nenhum<br>1 - básico<br>2 - NTLM<br>3 - Kerberos| |description|string|Descrição do protótipo do item.| |follow\_redirects|integer|campo de protótipo de item do agente HTTP. Siga os redirecionamentos de resposta ao agrupar dados.<br><br>0 - Não siga os redirecionamentos.<br>1 - *(padrão)* Siga os redirecionamentos.| |headers|object|campo protótipo de item do agente HTTP. Objeto com cabeçalhos de solicitação HTTP(S), onde o nome do cabeçalho é usado como chave e o valor do cabeçalho como valor.<br><br>Exemplo:<br>{ "User-Agent": "Zabbix" }| |history|string|Uma unidade de tempo de quanto tempo os dados do histórico devem ser armazenados. Também aceita macro de usuário e macro LLD.<br><br>Padrão: 90d.| |http\_proxy|string|Campo de protótipo de item do agente HTTP. Cadeia de conexão do proxy HTTP(S).| |ipmi\_sensor|string|sensor IPMI. Usado apenas por protótipos de itens do IPMI.| |jmx\_endpoint|string|String de conexão personalizada do agente JMX.<br><br>Valor padrão:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT }/jmxrmi| |logtimefmt|string|Formato da hora nas entradas de log. Usado apenas por protótipos de itens de log.| |master\_itemid|integer|ID do item mestre.<br>Recursão de até 3 itens dependentes e protótipos de item e contagem máxima de itens dependentes e protótipos de item igual a 29999 são permitidos.<br><br>Requerido por itens dependentes.| |output\_format|integer|campo de protótipo de item do agente HTTP. A resposta deve ser convertida em JSON.<br><br>0 - *(padrão)* Armazenar raw.<br>1 - Converter em JSON.| |params|string|Parâmetros adicionais dependendo do tipo de protótipo de item:<br>- script executado para protótipos de itens SSH e Telnet;<br>- consulta SQL para protótipos de itens de monitor de banco de dados;<br>- fórmula para protótipos de itens calculados .| |parameters|array|Parâmetros adicionais para protótipos de itens de script. Matriz de objetos com propriedades 'nome' e 'valor', onde o nome deve ser exclusivo.| |senha|string|Senha para autenticação. Usado por verificação simples, SSH, Telnet, monitor de banco de dados, protótipos de item de agente JMX e HTTP.| |post\_type|integer|campo de protótipo de item do agente HTTP. Tipo de corpo de dados de postagem armazenado na propriedade de postagens.<br><br>0 - *(padrão)* Dados brutos.<br>2 - Dados JSON.<br>3 - Dados XML.| |posts|string|campo de protótipo de item do agente HTTP. Dados do corpo da solicitação HTTP(S). Usado com post\_type.| |privatekey|string|Nome do arquivo de chave privada.| |publickey|string|Nome do arquivo de chave pública.| |query\_fields|array|campo de protótipo de item do agente HTTP. Parâmetros de consulta. Matriz de objetos com pares 'chave':'valor', onde valor pode ser uma string vazia.| |request\_method|integer|campo de protótipo de item do agente HTTP. Tipo de método de solicitação.<br><br>0 - *(padrão)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |recuperar\_modo|inteiro|campo protótipo de item do agente HTTP. Qual parte da resposta deve ser armazenada.<br><br>0 - *(padrão)* Corpo.<br>1 - Cabeçalhos.<br>2 - O corpo e os cabeçalhos serão armazenados.<br><br>Para request\_method HEAD somente 1 é o valor permitido.| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|campo de protótipo de item do agente HTTP. Caminho do arquivo de chave SSL pública.| |ssl\_key\_file|string|campo de protótipo de item do agente HTTP. Caminho do arquivo de chave SSL privada.| |ssl\_key\_password|string|campo de protótipo de item do agente HTTP. Senha para arquivo de chave SSL.| |status|inteiro|Status do protótipo do item.<br><br>Valores possíveis:<br>0 - *(padrão)* protótipo do item ativado;<br>1 - protótipo do item desativado;<br>3 - item não suportado protótipo.| |status\_codes|string|campo de protótipo de item do agente HTTP. Intervalos de códigos de status HTTP necessários separados por vírgulas. Também suporta macros de usuário ou macros LLD como parte da lista separada por vírgulas.<br><br>Exemplo: 200.200-{$M},{$M},200-400| |templateid|string|(somente leitura) ID do protótipo do item de modelo pai.| |timeout|string|Tempo limite da solicitação de sondagem de dados do item. Usado para protótipos de agente HTTP e item de script. Suporta macros de usuário e macros LLD.<br><br>padrão: 3s<br>valor máximo: 60s| |trapper\_hosts|string|Hosts permitidos. Usado por protótipos de item de trapper ou protótipos de item HTTP.| |trends|string|Uma unidade de tempo de quanto tempo os dados de tendências devem ser armazenados. Também aceita macro de usuário e macro LLD.<br><br>Padrão: 365d.| |unidades|string|Unidades de valor.| |username|string|Username para autenticação. Usado por verificação simples, SSH, Telnet, monitor de banco de dados, protótipos de item de agente JMX e HTTP.<br><br>Requerido por protótipos de item SSH e Telnet.| |uuid|string|Identificador único universal, usado para vincular protótipos de itens importados aos já existentes. Usado apenas para protótipos de itens em modelos. Gerado automaticamente, se não fornecido.<br><br>Para operações de atualização, este campo é *somente leitura*.| |valuemapid|string|ID do mapa de valores associado.| |verify\_host|integer|campo de protótipo de item do agente HTTP. Validar o nome do host na URL está no campo Nome Comum ou em um campo Nome Alternativo do Assunto do certificado do host.<br><br>0 - *(padrão)* Não validar.<br>1 - Validar.<br>| |verify\_peer|integer|campo de protótipo de item do agente HTTP. Validar é o certificado do host autêntico.<br><br>0 - *(padrão)* Não validar.<br>1 - Validar.| |discover|inteiro|Status de descoberta do protótipo do item.<br><br>Valores possíveis:<br>0 - *(padrão)* novos itens serão descobertos;<br>1 - novos itens não serão descobertos e os itens existentes serão ser marcado como perdido.|

en-us	# Item prototype  This class is designed to work with item prototypes.  Object references:\  -   [Item     prototype](/manual/api/reference/itemprototype/object#item_prototype)  Available methods:\  -   [itemprototype.create](/manual/api/reference/itemprototype/create) -     creating new item prototypes -   [itemprototype.delete](/manual/api/reference/itemprototype/delete) -     deleting item prototypes -   [itemprototype.get](/manual/api/reference/itemprototype/get) -     retrieving item prototypes -   [itemprototype.update](/manual/api/reference/itemprototype/update) -     updating item prototypes
pt-br	# Protótipo de item  Esta classe foi projetada para trabalhar com protótipos de itens.  Referências de objetos:\  -   [Item     protótipo](/manual/api/reference/itemprototype/object#item_prototype)  Métodos disponíveis:\  - [itemprototype.create](/manual/api/reference/itemprototype/create) -     criando novos protótipos de itens - [itemprototype.delete](/manual/api/reference/itemprototype/delete) -     excluindo protótipos de itens - [itemprototype.get](/manual/api/reference/itemprototype/get) -     recuperando protótipos de itens - [itemprototype.update](/manual/api/reference/itemprototype/update) -     atualizando protótipos de itens

en-us	# itemprototype.update
pt-br	# itemprototype.update

en-us	##### Item prototype  You may want to create an item prototype like this:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_item_prototype_prom.png)  with preprocessing options:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_item_prototype_prom_b.png)
pt-br	##### Protótipo de item  Você pode querer criar um protótipo de item como este:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_item_prototype_prom.png)  com opções de pré-processamento:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_item_prototype_prom_b.png)

en-us	## Items
pt-br	## Itens

en-us	## Items
pt-br	## Itens

en-us	## Items
pt-br	## Itens

en-us	## Items
pt-br	## Itens

en-us	#### Items  Define items to monitor.  [Item API](/manual/api/reference/item)
pt-br	#### Itens  Defina os itens a serem monitorados.  [API do item](/manual/api/reference/item)

en-us	### Items  ##### docker.container_stats  The [docker.container_stats](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#docker) item on Zabbix agent 2 now also returns a `pids_stats` property with the current number of processes/threads on the container.
pt-br	### Items  ##### docker.container_stats  O item  [docker.container_stats](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#docker) no Zabbix agent 2 agora também retorna uma propriedade `pids_stats`, que fornece o número atual de processos/threads no container.

en-us	#### Items  To configure querying of internal stats on another Zabbix instance, you may use two items:  -   `zabbix[stats,<ip>,<port>]` internal item - for direct remote     queries of Zabbix server/proxy. <ip> and <port> are used     to identify the target instance. -   `zabbix.stats[<ip>,<port>]` agent item - for agent-based remote     queries of Zabbix server/proxy. <ip> and <port> are used     to identify the target instance.  See also: [Internal items](/manual/config/items/itemtypes/internal), [Zabbix agent items](/manual/config/items/itemtypes/zabbix_agent)  The following diagram illustrates the use of either item depending on the context.  ![](../../../../assets/en/manual/appendix/items/ext_stats.png)  -   ![](../../../../assets/en/manual/appendix/items/green.png) - Server     → external Zabbix instance (`zabbix[stats,<ip>,<port>]`) -   ![](../../../../assets/en/manual/appendix/items/pink.png) - Server →     proxy → external Zabbix instance (`zabbix[stats,<ip>,<port>]`) -   ![](../../../../assets/en/manual/appendix/items/blue.png) - Server →     agent → external Zabbix instance (`zabbix.stats[<ip>,<port>]`) -   ![](../../../../assets/en/manual/appendix/items/red.png) - Server →     proxy → agent → external Zabbix instance     (`zabbix.stats[<ip>,<port>]`)  To make sure that the target instance allows querying it by the external instance, list the address of the external instance in the 'StatsAllowedIP' parameter on the target instance.
pt-br	#### Itens  Para configurar a consulta de estatísticas internas em outra instância do Zabbix, você pode usar dois itens:  - `zabbix[stats,<ip>,<port>]` item interno - para controle remoto direto     consultas do servidor/proxy Zabbix. <ip> e <port> são usados     para identificar a instância de destino. - `zabbix.stats[<ip>,<port>]` item de agente - para remoto baseado em agente     consultas do servidor/proxy Zabbix. <ip> e <port> são usados     para identificar a instância de destino.  Veja também: [Itens internos](/manual/config/items/itemtypes/internal), [itens do agente Zabbix](/manual/config/items/itemtypes/zabbix_agent)  O diagrama a seguir ilustra o uso de qualquer item dependendo o contexto.  ![](../../../../assets/en/manual/appendix/items/ext_stats.png)  - ![](../../../../assets/en/manual/appendix/items/green.png) - Servidor     → instância externa do Zabbix (`zabbix[stats,<ip>,<port>]`) - ![](../../../../assets/en/manual/appendix/items/pink.png) - Servidor →     proxy → instância externa do Zabbix (`zabbix[stats,<ip>,<port>]`) - ![](../../../../assets/en/manual/appendix/items/blue.png) - Servidor →     agente → instância externa do Zabbix (`zabbix.stats[<ip>,<port>]`) - ![](../../../../assets/en/manual/appendix/items/red.png) - Servidor →     proxy → agente → instância externa do Zabbix     (`zabbix.stats[<ip>,<port>]`)  Para certificar-se de que a instância de destino permite consultá-la pelo instância, liste o endereço da instância externa no Parâmetro 'StatsAllowedIP' na instância de destino.

en-us	### Item tag  The item tag object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |**tag**<br>(required)|string|Item tag name.| |value|string|Item tag value.|
pt-br	### Marca do item  O objeto tag do item tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |**tag**<br>(obrigatório)|string|Nome da tag do item.| |valor|string|Valor da tag do item.|

en-us	# Item  This class is designed to work with items.  Object references:\  -   [Item](/manual/api/reference/item/object#item)  Available methods:\  -   [item.create](/manual/api/reference/item/create) - creating new     items -   [item.delete](/manual/api/reference/item/delete) - deleting items -   [item.get](/manual/api/reference/item/get) - retrieving items -   [item.update](/manual/api/reference/item/update) - updating items
pt-br	# Item  Esta classe foi projetada para trabalhar com itens.  Referências de objetos:\  - [Item](/manual/api/reference/item/object#item)  Métodos disponíveis:\  - [item.create](/manual/api/reference/item/create) - criando novo     Itens - [item.delete](/manual/api/reference/item/delete) - excluindo itens - [item.get](/manual/api/reference/item/get) - recuperando itens - [item.update](/manual/api/reference/item/update) - atualizando itens

en-us	# item.update
pt-br	## item.update

en-us	#### Item value  An *Item value* widget has been added to dashboard widgets.  This type of widget is useful for displaying values of single items prominently. Different visual styles of display are possible:  ![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/item_value_widgets_new.png)  For more information, see [Item value widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value).
pt-br	#### Valor do item  Um widget *Item value* foi adicionado aos widgets do painel.  Esse tipo de widget é útil para exibir valores de itens individuais com destaque. São possíveis diferentes estilos visuais de exibição possíveis:  ![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/item_value_widgets_new.png)  Para obter mais informações, consulte [Item value widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value).

en-us	#### Item values  The following information is exported for a collected item value:  |Field|<|Type|Description| |-----|-|----|-----------| |*host*|<|object|Host name of the item host.| |<|host|string|Host name.| |<|name|string|Visible host name.| |*groups*|<|array|List of host groups of the item host; there should be at least one element in array.| |<|\-|string|Host group name.| |*itemid*|<|number|Item ID.| |*name*|<|string|Visible item name.| |*clock*|<|number|Number of seconds since Epoch to the moment when value was collected (integer part).| |*ns*|<|number|Number of nanoseconds to be added to `clock` to get a precise value collection time.| |*timestamp*<br>(*Log* only)|<|number|0 if not available.| |*source*<br>(*Log* only)|<|string|Empty string if not available.| |*severity*<br>(*Log* only)|<|number|0 if not available.| |*eventid*<br>(*Log* only)|<|number|0 if not available.| |*value*|<|number (for numeric items) or<br>string (for text items)|Collected item value.| |*type*|<|number|Collected value type:<br>0 - numeric float, 1 - character, 2 - log, 3 - numeric unsigned, 4 - text|
pt-br	#### Valores dos itens  As seguintes informações são exportadas para um valor de item coletado:  |Campo|<|Tipo|Descrição| |-----|-|----|-----------| |*host*|<|object|Nome do host do item host.| |<|host|string|Nome do host.| |<|name|string|Nome do host visível.| |*grupos*|<|array|Lista de grupos de hosts do host do item; deve haver pelo menos um elemento no array.| |<|\-|string|Nome do grupo de hosts.| |*itemid*|<|número|ID do item.| |*nome*|<|string|Nome do item visível.| |*clock*|<|number|Número de segundos desde Epoch até o momento em que o valor foi coletado (parte inteira).| |*ns*|<|number|Número de nanossegundos a serem adicionados ao `clock` para obter um tempo de coleta de valor preciso.| |*timestamp*<br>(*Log* apenas)|<|number|0 se não estiver disponível.| |*source*<br>(*Log* apenas)|<|string|String vazia se não estiver disponível.| |*gravidade*<br>(*Log* apenas)|<|número|0 se não estiver disponível.| |*eventid*<br>(*Log* apenas)|<|number|0 se não estiver disponível.| |*valor*|<|número (para itens numéricos) ou<br>string (para itens de texto)|Valor do item coletado.| |*tipo*|<|número|Tipo de valor coletado:<br>0 - numérico flutuante, 1 - caractere, 2 - log, 3 - numérico sem sinal, 4 - texto|

en-us	##### Item value  The following parameters are supported if *Data* is set to "Item value".  ::: noteclassic The first number in the *Thresholds* property name (e.g. columnsthresholds.color.0.0) references the column for which thresholds are configured, while the second number references threshold place in a list, sorted in ascending order. However, if thresholds are configured in a different order, the values will be sorted in ascending order after updating widget configuration in Zabbix frontend (e.g. `"threshold.threshold.0":"5"` → `"threshold.threshold.0":"1"`; `"threshold.threshold.1":"1"` → `"threshold.threshold.1": "5"`). :::  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Item*|<|1 |columns.item.0|Valid item name.| |***Time shift***<br>(required)|<|1|columns.timeshift.0|Valid numeric or time string value (e.g. `3600` or `1h`).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes). Negative values are allowed.| |*Aggregation function*|<|0|columns.aggregate_function.0|0 - *(default)* none;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - last.| |*Aggregation interval*|<|1|columns.aggregate_interval.0|Valid time string (e.g. `3600`, `1h`, etc.).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes).<br><br>Parameter *Aggregation interval* not available if *Aggregation function* is set to *none*.<br><br>Default: `1h`.| |*Display*|<|0|columns.display.0|1 - *(default)* As is;<br>2 - Bar;<br>3 - Indicators.| |*Min*|<|1|columns.min.0|Any numeric value.<br><br>Parameter *Min* not available if *Display* is set to "As is".| |*Max*|<|1|columns.max.0|Any numeric value.<br><br>Parameter *Max* not available if *Display* is set to "As is".| |*History data*|<|0|columns.history.0|1 - *(default)* Auto;<br>2 - History;<br>3 - Trends.| |*Thresholds*|<|<|<|<| |<|*Color*|1|columnsthresholds.color.0.0|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |^|*Threshold*|1|columnsthresholds.threshold.0.0|Any string value.|
pt-br	##### Valor do item   Os seguintes parâmetros são suportados se *Data* estiver configurado como "Valor do item".  ::: noteclassic O primeiro número no nome da propriedade *Thresholds* (por exemplo, columnsthresholds.color.0.0) refere-se à coluna para qual os thresholds estão configurados, enquanto o segundo número faz referência à posição dos thresholds em uma lista, ordenada em ordem crescente. Contudo, se thresholds estiverem configurados em uma ordem diferente, os valores serão ordenados em ordem crescente após a atualização da configuração do widget no frontend do Zabbix.  (por exemplo,  `"threshold.threshold.0":"5"` → `"threshold.threshold.0":"1"`; `"threshold.threshold.1":"1"` → `"threshold.threshold.1": "5"`). :::  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|nome|valor| |-|--------|--|--------|-------------------------------| |*Item*|<|1 |columns.item.0|Valide o nome do item.| |***Time shift***<br>(required)|<|1|columns.timeshift.0|Valide o valor numérico ou o tempo da string (por exemplo, `3600` ou `1h`).<br>Você pode usar [time suffixes](/manual/appendix/suffixes#time-suffixes). Valores negativos são permitidos.| |*Aggregation function*|<|0|columns.aggregate_function.0|0 - *(padrão)* nenhum;<br>1 - min;<br>2 - max;<br>3 - média;<br>4 - contar;<br>5 - somar;<br>6 - primeiro;<br>7 - último.| |*Aggregation interval*|<|1|columns.aggregate_interval.0|Valide o tempo da string (por exemplo, `3600`, `1h`, etc.).<br>Você pode usar [time suffixes](/manual/appendix/suffixes#time-suffixes).<br><br>Parâmetro *Intervalo de agregação* indisponível se *Função da agregação* estiver configurado como *none*.<br><br>Padrão: `1h`.| |*Display*|<|0|columns.display.0|1 - *(padrão)* As is;<br>2 - Barra;<br>3 - Indicadores.| |*Min*|<|1|columns.min.0|Qualquer valor numérico.<br><br>Parâmetro *Min* indisponível se *Display* estiver configurado como "As is".| |*Max*|<|1|columns.max.0|Qualquer valor numérico.<br><br>Parâmetro *Max* indisponível se *Display* estiver configurado como "As is".| |*History data*|<|0|columns.history.0|1 - *(padrão)* Automático;<br>2 - Histórico;<br>3 - Trends.| |*Thresholds*|<|<|<|<| |<|*Color*|1|columnsthresholds.color.0.0|Código de cor Hexadecimal (por exemplo, `FF0000`).<br><br>Padrão: `""` (vazio).| |^|*Threshold*|1|columnsthresholds.threshold.0.0|Qualquer valor da string.|

en-us	### Item value widget  An *Item value* widget has been added to dashboard widgets.   This type of widget is useful for displaying values of  single items prominently. Different visual styles of display  are possible:  ![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/item_value_widgets_new.png)  For more information, see [Item value widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value).  
pt-br	Macros for internal actions contain the reason why an item, an LLD-rule, or a trigger became unsupported:   - {ITEM.STATE.ERROR} - for item-based internal notifications;  - {LLDRULE.STATE.ERROR} -  for LLD-rule based internal notifications;  - {TRIGGER.STATE.ERROR} - for trigger-based internal notifications.  For more details, see [Supported macros](/manual/appendix/macros/supported_by_location).  

en-us	It is possible to zoom in and out the map by using the plus and minus buttons in the widget's upper left corner or by using the mouse scroll wheel or touchpad. To set the current view as default, right-click anywhere on the map and select *Set this view as default*. This setting will override *Initial view* widget parameter for the current user. To undo this action, right-click anywhere on the map again and select *Reset the initial view*.  When *Initial view* or *Default view* is set, you can return to this view at any time by pressing on the home icon on the left.  ![](../../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/geomap_widget3.png)
pt-br	É possível ampliar e reduzir o mapa usando o sinal de mais e menos botões no canto superior esquerdo do widget ou usando a rolagem do mouse volante ou touchpad. Para definir a visualização atual como padrão, clique com o botão direito do mouse em qualquer lugar no mapa e selecione *Definir esta visualização como padrão*. Esta configuração substituirá o parâmetro de widget *Visualização inicial* para o usuário atual. Para desfaça esta ação, clique com o botão direito em qualquer lugar do mapa novamente e selecione *Redefinir a visualização inicial*.  Quando *Visualização inicial* ou *Visualização padrão* estiver definida, você poderá retornar a esta visualizar a qualquer momento pressionando o ícone inicial à esquerda.  ![](../../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/geomap_widget3.png)

en-us	### Java gateway installation  It is required to install [Java gateway](/manual/concepts/java) only if you want to monitor JMX applications. Java gateway is lightweight and does not require a database.  Once the required repository is added, you can install Zabbix Java gateway by running:      dnf install zabbix-java-gateway  Proceed to [setup](/manual/concepts/java/from_rhel) for more details on configuring and running Java gateway.
pt-br	### Instalação do  Java gateway  É necessário instalar o [Java gateway](/manual/concepts/java) somente se você seja monitorar as aplicações JMX.  O gateway Java é leve e não requer um banco de dados.   Uma vez que o repositório necessário é adicionado, você pode instalar o Zabbix Java gateway executando:      dnf install zabbix-java-gateway  Prossiga para [setup](/manual/concepts/java/from_rhel) para mais detalhes da configuração e execução do Java gateway.

en-us	#### JavaScript methods  HTTP methods PATCH, HEAD, OPTIONS, TRACE, CONNECT have been added to the JavaScript engine. Also, the engine now allows sending custom HTTP method requests with the new JS method HttpRequest.customRequest.  See also: [Additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects).
pt-br	#### Métodos JavaScript  Os métodos HTTP PATCH, HEAD, OPTIONS, TRACE e CONNECT foram adicionados ao mecanismo JavaScript. Além disso, o mecanismo agora permite enviar solicitações de métodos HTTP personalizados com o novo método JS HttpRequest.customRequest.  Veja também: [Objetos JavaScript adicionais](/manual/config/items/preprocessing/javascript/javascript_objects).

en-us	#### JMX monitoring  See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details.
pt-br	#### Monitorar JMX   Consultar página [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) para mais detalhes.

en-us	#### JMX monitoring  See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details.
pt-br	#### Monitorar JMX   Ver página [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) para mais detalhes.

en-us	#### JMX monitoring  See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details.
pt-br	#### Monitorarmento JMX   Para mais detalhes, consultar a seguinte página [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) para mais detalhes.

en-us	#### JMX monitoring  See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details.
pt-br	#### Monitoramento JMX   Para mais detalhes, consulte a página [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring).

en-us	 ### JMX monitoring  The template *Generic Java JMX* now contains discovery rules for low-level discovery of memory pools and garbage collectors. 
pt-br	### Moritoramento JMX   O template *Generic Java JMX* agora contém regras de descoberta para descoberta de baixo nível de pools de memória e coletores de lixo.

en-us	# JMX template operation  Steps to ensure correct operation of templates that collect metrics by [JMX](/manual/config/items/itemtypes/jmx_monitoring):  1\. Make sure Zabbix [Java gateway](/manual/concepts/java#getting_java_gateway) is installed and set up properly.\ 2. [Link](/manual/config/templates/linking#linking_a_template) the template to the target host. The host should have JMX interface set up.\ If the template is not available in your Zabbix installation, you may need to import the template's .xml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions.\ 3. Adjust the values of mandatory macros as needed.\ 4. Configure the instance being monitored to allow sharing data with Zabbix - see instructions in the *Additional steps/comments* column.  ::: notetip  This page contains only a minimum set of macros and setup steps that are required for proper template operation. A detailed description of a template, including the full list of macros, items, and triggers, is available in the template's Readme.md file (accessible by clicking on a template name).  :::  |Template|Mandatory macros|Additional steps/comments| |--------|----------------|-------------------------| |[Apache ActiveMQ by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/activemq_jmx/README.md)|**{$ACTIVEMQ.PORT}** - port for JMX (default: 1099).<br>**{$ACTIVEMQ.USERNAME}**, **{$ACTIVEMQ.PASSWORD}** - login credentials for JMX<br>(default username: admin, password: activemq).|JMX access to Apache ActiveMQ should be enabled and configured per instructions in [the official documentation](https://activemq.apache.org/jmx.html).| |[Apache Cassandra by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/cassandra_jmx/README.md)|**{$CASSANDRA.USER}**, **{$CASSANDRA.PASSWORD}** - Apache Cassandra login credentials<br>(default username: zabbix, password: zabbix)|JMX access to Apache Cassandra should be enabled and configured per instructions in [the official documentation](https://cassandra.apache.org/doc/latest/operating/security.html#jmx-access).| |[Apache Kafka by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kafka_jmx/README.md)|**{$KAFKA.USER}**, **{$KAFKA.PASSWORD}** - Apache Kafka login credentials<br>(default username: zabbix, password: zabbix)|JMX access to Apache Kafka should be enabled and configured per instructions in [the official documentation](https://kafka.apache.org/documentation/#remote_jmx).| |[Apache Tomcat by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/tomcat_jmx/README.md)|**{$TOMCAT.USER}**, **{$TOMCAT.PASSWORD}** - Apache Tomcat login credentials; leave blank if Tomcat installation does not require authentication<br>(default: not set).|JMX access to Apache Tomcat should be enabled and configured per instructions in [the official documentation](https://tomcat.apache.org/tomcat-10.0-doc/monitoring.html#Enabling_JMX_Remote) (choose the correct version).| |[GridGain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/gridgain_jmx/README.md)|**{$GRIDGAIN.USER}**, **{$GRIDGAIN.PASSWORD}** - GridGain login credentials (default username: zabbix, password: <secret>).|JMX access to GridGain In-Memory Computing Platform should be enabled and configured per instructions in [the documentation](https://docs.oracle.com/javase/8/docs/technotes/guides/management/agent.html).| |[Ignite by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/ignite_jmx/README.md)|**{$IGNITE.USER}**, **{$IGNITE.PASSWORD}** - Apache Ignite login credentials (default username: zabbix, password: <secret>).|Enable and configure JMX access to Apache Ignite.<br><br>JMX tree hierarchy contains ClassLoader by default. Adding the following Java Virtual Machine option `-DIGNITE_MBEAN_APPEND_CLASS_LOADER_ID=false` will exclude one level with ClassLoader name.<br><br>Cache and Data Region metrics can be configured as needed - see [Ignite documentation](https://ignite.apache.org/docs/latest/monitoring-metrics/configuring-metrics) for details.<br><br>See also: [Monitoring and Management Using JMX Technology](https://docs.oracle.com/javase/8/docs/technotes/guides/management/agent.html)| |[WildFly Domain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_domain_jmx/README.md)|**{$WILDFLY.JMX.PROTOCOL}** - JMX scheme (default: remote+http)<br>**{$WILDFLY.USER}**, **{$WILDFLY.PASSWORD}** - WildFly login credentials (default username: zabbix, password: zabbix).|1\. Enable and configure JMX access to WildFly according to instructions in [the official documentation](https://docs.wildfly.org/23/Admin_Guide.html#JMX).<br><br>2. Copy *jboss-client.jar* from `/(wildfly,EAP,Jboss,AS)/bin/client` into directory `/usr/share/zabbix-java-gateway/lib`.<br><br>3. Restart Zabbix Java gateway.| |[WildFly Server by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_server_jmx/README.md)|**{$WILDFLY.JMX.PROTOCOL}** - JMX scheme (default: remote+http)<br>**{$WILDFLY.USER}**, **{$WILDFLY.PASSWORD}** - WildFly login credentials (default username: zabbix, password: zabbix).|1\. Enable and configure JMX access to WildFly according to instructions in [the official documentation](https://docs.wildfly.org/23/Admin_Guide.html#JMX).<br><br>2. Copy *jboss-client.jar* from `/(wildfly,EAP,Jboss,AS)/bin/client` into directory `/usr/share/zabbix-java-gateway/lib`.<br><br>3. Restart Zabbix Java gateway.|
pt-br	# Operação do modelo JMX  Etapas para garantir a operação correta de modelos que coletam métricas por [JMX](/manual/config/items/itemtypes/jmx_monitoring):  1\. Certifique-se de que o Zabbix [Java gateway](/manual/concepts/java#getting_java_gateway) está instalado e configurar corretamente.\ 2. [Link](/manual/config/templates/linking#linking_a_template) o modelo para o host de destino. O host deve ter a interface JMX configurada.\ Se o template não estiver disponível em sua instalação do Zabbix, você pode precisa importar primeiro o arquivo .xml do modelo - veja [Modelos pronto para uso](/manual/config/templates_out_of_the_box) para instruções.\ 3. Ajuste os valores das macros obrigatórias conforme necessário.\ 4. Configure a instância que está sendo monitorada para permitir o compartilhamento de dados com Zabbix - veja as instruções na coluna *Passos/comentários adicionais*.  ::: dica  Esta página contém apenas um conjunto mínimo de macros e etapas de configuração necessárias para a operação adequada do modelo. Uma detalhada descrição de um modelo, incluindo a lista completa de macros, itens e triggers, está disponível no arquivo Readme.md do modelo (acessível por clicando em um nome de modelo). :::  |Modelo|Macros obrigatórios|Passos/comentários adicionais| |--------|----------------|----------------------- --| |[Apache ActiveMQ por JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/activemq_jmx/README.md)|**{$ACTIVEMQ.PORT}** - porta para JMX (padrão: 1099).<br>**{$ACTIVEMQ.USERNAME}**, **{$ACTIVEMQ.PASSWORD}** - credenciais de login para JMX<br>(nome de usuário padrão: admin, senha: activemq ).|O acesso JMX ao Apache ActiveMQ deve ser habilitado e configurado de acordo com as instruções na [documentação oficial](https://activemq.apache.org/jmx.html).| |[Apache Cassandra por JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/cassandra_jmx/README.md)|**{$CASSANDRA.USER}**, **{$CASSANDRA.PASSWORD}** - Credenciais de login do Apache Cassandra<br>(nome de usuário padrão: zabbix, senha: zabbix)|O acesso JMX ao Apache Cassandra deve ser habilitado e configurado de acordo com as instruções na [documentação oficial](https: //cassandra.apache.org/doc/latest/operating/security.html#jmx-access).| |[Apache Kafka por JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kafka_jmx/README.md)|**{$KAFKA.USER}**, **{$KAFKA.PASSWORD}** - Credenciais de login do Apache Kafka<br>(nome de usuário padrão: zabbix, senha: zabbix)|O acesso JMX ao Apache Kafka deve ser habilitado e configurado de acordo com as instruções na [documentação oficial](https: //kafka.apache.org/documentation/#remote_jmx).| |[Apache Tomcat por JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/tomcat_jmx/README.md)|**{$TOMCAT.USER}**, **{$TOMCAT.PASSWORD}** - Credenciais de login do Apache Tomcat; deixe em branco se a instalação do Tomcat não exigir autenticação<br>(padrão: não definido).|O acesso JMX ao Apache Tomcat deve ser habilitado e configurado de acordo com as instruções na [documentação oficial](https://tomcat.apache.org/tomcat -10.0-doc/monitoring.html#Enabling_JMX_Remote) (escolha a versão correta).| |[GridGain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/gridgain_jmx/README.md)|**{$GRIDGAIN.USER}**, * *{$GRIDGAIN.PASSWORD}** - Credenciais de login do GridGain (nome de usuário padrão: zabbix, senha: <secret>).|O acesso JMX à plataforma de computação em memória GridGain deve ser ativado e configurado de acordo com as instruções na [documentação](https ://docs.oracle.com/javase/8/docs/technotes/guides/management/agent.html).| |[Ignite by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/ignite_jmx/README.md)|**{$IGNITE.USER}**, * *{$IGNITE.PASSWORD}** - Credenciais de login do Apache Ignite (nome de usuário padrão: zabbix, senha: <secret>).|Ative e configure o acesso JMX ao Apache Ignite.<br><br>A hierarquia da árvore JMX contém ClassLoader por padrão . Adicionar a seguinte opção de máquina virtual Java `-DIGNITE_MBEAN_APPEND_CLASS_LOADER_ID=false` excluirá um nível com o nome do ClassLoader.<br><br>As métricas de cache e região de dados podem ser configuradas conforme necessário - consulte [documentação do Ignite](https://ignite. apache.org/docs/latest/monitoring-metrics/configuring-metrics) para obter detalhes.<br><br>Veja também: [Monitoring and Management Using JMX Technology](https://docs.oracle.com/javase/8 /docs/technotes/guides/management/agent.html)| |[WildFly Domain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_domain_jmx/README.md)|**{$WILDFLY.JMX.PROTOCOL}* * - Esquema JMX (padrão: remote+http)<br>**{$WILDFLY.USER}**, **{$WILDFLY.PASSWORD}** - Credenciais de login do WildFly (nome de usuário padrão: zabbix, senha: zabbix). |1\. Habilite e configure o acesso JMX ao WildFly de acordo com as instruções na [documentação oficial](https://docs.wildfly.org/23/Admin_Guide.html#JMX).<br><br>2. Copie *jboss-client.jar* de `/(wildfly,EAP,Jboss,AS)/bin/client` para o diretório `/usr/share/zabbix-java-gateway/lib`.<br><br>3. Reinicie o Zabbix Java Gateway.| |[WildFly Server by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_server_jmx/README.md)|**{$WILDFLY.JMX.PROTOCOL}* * - Esquema JMX (padrão: remote+http)<br>**{$WILDFLY.USER}**, **{$WILDFLY.PASSWORD}** - Credenciais de login do WildFly (nome de usuário padrão: zabbix, senha: zabbix). |1\. Habilite e configure o acesso JMX ao WildFly de acordo com as instruções na [documentação oficial](https://docs.wildfly.org/23/Admin_Guide.html#JMX).<br><br>2. Copie *jboss-client.jar* de `/(wildfly,EAP,Jboss,AS)/bin/client` para o diretório `/usr/share/zabbix-java-gateway/lib`.<br><br>3. Reinicie o Zabbix Java Gateway.|

en-us	 ### JSONPath parsing errors  JSONPath parsing errors occur in this version in case of leading whitespace and empty array/object. Fixed in Zabbix 6.0.12.
pt-br	### Erros de análise do JSONPath   Os erros de análise de JSONPath ocorrem nessa versão em casos de espaços em branco iniciais e em casos de arrays/objetos vazios. Corrido em  Zabbix 6.0.12.

en-us	#### Keeping history  You can set for how many days history will be kept:  -   in the item properties [form](/manual/config/items/item) -   when mass-updating items -   when [setting     up](/manual/web_interface/frontend_sections/administration/general#housekeeper)     housekeeper tasks  Any older data will be removed by the housekeeper.  The general strong advice is to keep history for the smallest possible number of days and that way not to overload the database with lots of historical values.  Instead of keeping a long history, you can keep longer data of trends. For example, you could keep history for 14 days and trends for 5 years.  You can get a good idea of how much space is required by history versus trends data by referring to the [database sizing page](/manual/installation/requirements#database_size).  While keeping shorter history, you will still be able to review older data in graphs, as graphs will use trend values for displaying older data.  ::: noteimportant If history is set to '0', the item will update only dependent items and inventory. No trigger functions will be evaluated because trigger evaluation is based on history data only. :::   ::: notetip As an alternative way to preserve history consider to use [history export](/manual/config/items/loadablemodules#providing_history_export_callbacks) functionality of loadable modules. :::
pt-br	#### Mantendo o histórico  Você pode definir por quantos dias o histórico será mantido:  - nas propriedades do item [form](/manual/config/items/item) - ao atualizar itens em massa - quando [configuração     up](/manual/web_interface/frontend_sections/administration/general#housekeeper)     tarefas de governanta  Quaisquer dados mais antigos serão removidos pela governanta.  O forte conselho geral é manter o histórico pelo menor tempo possível número de dias e assim não sobrecarregar o banco de dados com muitos valores históricos.  Em vez de manter um longo histórico, você pode manter dados mais longos de tendências. Por exemplo, você pode manter o histórico por 14 dias e as tendências por 5 anos.  Você pode ter uma boa ideia de quanto espaço é necessário para o histórico versus dados de tendências consultando o [dimensionamento do banco de dados page](/manual/installation/requirements#database_size).  Mantendo um histórico mais curto, você ainda poderá revisar dados em gráficos, pois os gráficos usarão valores de tendência para exibir dados.  ::: não importante Se o histórico estiver definido como '0', o item será atualizado apenas itens dependentes e estoque. Nenhuma função de gatilho será avaliado porque a avaliação do gatilho é baseada em dados do histórico só. :::  ::: dica Como alternativa para preservar história considere usar [história export](/manual/config/items/loadablemodules#providing_history_export_callbacks) funcionalidade de módulos carregáveis. :::

en-us	#### Keeping trends  Trends is a built-in historical data reduction mechanism which stores minimum, maximum, average and the total number of values per every hour for numeric data types.  You can set for how many days trends will be kept:  -   in the item properties [form](/manual/config/items/item) -   when mass-updating items -   when setting up Housekeeper tasks  Trends usually can be kept for much longer than history. Any older data will be removed by the housekeeper.  Zabbix server accumulates trend data in runtime in the trend cache, as the data flows in. Server flushes **previous hour** trends of every item into the database (where frontend can find them) in these situations:  -   server receives the first current hour value of the item -   5 or less minutes of the current hour left and still no current hour     values of the item -   server stops  To see trends on a graph you need to wait at least to the beginning of the next hour (if item is updated frequently) and at most to the end of the next hour (if item is updated rarely), which is 2 hours maximum.  When server flushes trend cache and there are already trends in the database for this hour (for example, server has been restarted mid-hour), server needs to use update statements instead of simple inserts. Therefore on a bigger installation if restart is needed it is desirable to stop server in the end of one hour and start in the beginning of the next hour to avoid trend data overlap.  History tables do not participate in trend generation in any way.  ::: noteimportant If trends are set to '0', Zabbix server does not calculate or store trends at all. :::  ::: noteclassic The trends are calculated and stored with the same data type as the original values. As a result the average value calculations of unsigned data type values are rounded and the less the value interval is the less precise the result will be. For example if item has values 0 and 1, the average value will be 0, not 0.5.  Also restarting server might result in the precision loss of unsigned data type average value calculations for the current hour. :::
pt-br	#### Mantendo as tendências  O Trends é um mecanismo integrado de redução de dados históricos que armazena mínimo, máximo, médio e o número total de valores por cada hora para tipos de dados numéricos.  Você pode definir por quantos dias as tendências serão mantidas:  - nas propriedades do item [form](/manual/config/items/item) - ao atualizar itens em massa - ao configurar tarefas de governanta  As tendências geralmente podem ser mantidas por muito mais tempo do que a história. Quaisquer dados mais antigos será removido pela governanta.  O servidor Zabbix acumula dados de tendências em tempo de execução no cache de tendências, conforme os dados fluem. O servidor libera tendências de **hora anterior** de cada item no banco de dados (onde o frontend pode encontrá-los) nestas situações:  - o servidor recebe o valor da primeira hora atual do item - Faltam 5 minutos ou menos da hora atual e ainda não há hora atual     valores do item - servidor parado  Para ver as tendências em um gráfico, você precisa esperar pelo menos até o início do próxima hora (se o item for atualizado com frequência) e no máximo até o final do a próxima hora (se o item for atualizado raramente), que é de 2 horas no máximo.  Quando o servidor libera o cache de tendências e já existem tendências no banco de dados para esta hora (por exemplo, o servidor foi reiniciado meio da hora), o servidor precisa usar instruções de atualização em vez de simples inserções. Portanto, em uma instalação maior, se for necessário reiniciar, é desejável parar o servidor no final de uma hora e iniciar no início da próxima hora para evitar sobreposição de dados de tendência.  As tabelas de histórico não participam da geração de tendências de forma alguma.  ::: não importante Se as tendências forem definidas como '0', o servidor Zabbix não calcular ou armazenar tendências. :::  ::: noteclassic As tendências são calculadas e armazenadas com o mesmo tipo de dados como os valores originais. Como resultado, os cálculos do valor médio de valores de tipo de dados sem sinal são arredondados e quanto menor o intervalo de valor menos preciso será o resultado. Por exemplo, se o item tiver valores 0 e 1, o valor médio será 0, não 0,5.  Além disso, reiniciar o servidor pode resultar na perda de precisão de arquivos não assinados cálculos do valor médio do tipo de dados para a hora atual. :::

en-us	 ##### Kernel data  |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**kernel.maxfiles**|<|<|<| |Maximum number of opened files supported by OS.|Integer| | | |**kernel.maxproc**|<|<|<| |Maximum number of processes supported by OS.|Integer| | | |**kernel.openfiles**|<|<|<| |Return the number of currently open file descriptors.|Integer| |This item is supported since Zabbix 6.0.|
pt-br	##### Dados do Kernel  |Chave do Item|<|<|<| |--|--|------|------| |Descrição|Valor de Retorno|Parâmetros|Comentários| |**kernel.maxfiles**|<|<|<| |Número máximo de arquivos abertos suportados pelo sistema operacional.|Inteiro| | | |**kernel.maxproc**|<|<|<| |Número máximo de processos suportados pelo sistema operacional.|Inteiro| | | |**kernel.openfiles**|<|<|<| |Retorna o número de descritores de arquivos atualmente abertos.|Inteiro| |Este item é suportado desde o Zabbix 6.0.|

en-us	 ### Keyboard navigation  Keyboard control has been implemented for info icons in the frontend. Thus it is now  possible to focus on info icons, and open the hints, using the keyboard.
pt-br	### Navegação por teclado   O controle por teclado foi implementado para os ícones de informações no frontend. Assim, agora é possível focar nos ícones de informações, e abrir dicas usando o teclado.

en-us	 |Key|<|<|<|<| |---|-|-|-|-| |<|**Description**|**Return value**|**Parameters**|**Comments**| |agent.hostmetadata|<|<|<|<| |<|Agent host metadata.|String||Returns the value of HostMetadata or HostMetadataItem parameters, or empty string if none are defined.<br><br>Supported since Zabbix 6.0.| |agent.hostname|<|<|<|<| |<|Agent host name.|String| |Returns:<br>As passive check - the name of the first host listed in the Hostname parameter of the agent configuration file;<br>As active check - the name of the current hostname.| |agent.ping|<|<|<|<| |<|Agent availability check.|Nothing - unavailable<br><br>1 - available| |Use the **nodata()** trigger function to check for host unavailability.| |agent.variant|<|<|<|<| |<|Variant of Zabbix agent (Zabbix agent or Zabbix agent 2).|Integer| |Example of returned value:<br>1 - Zabbix agent<br>2 - Zabbix agent 2| |agent.version|<|<|<|<| |<|Version of Zabbix agent.|String| |Example of returned value:<br>6.0.3| |kernel.maxfiles|<|<|<|<| |<|Maximum number of opened files supported by OS.|Integer| | | |kernel.maxproc|<|<|<|<| |<|Maximum number of processes supported by OS.|Integer| | | |kernel.openfiles|<|<|<|<| |<|Return the number of currently open file descriptors.|Integer||This item is supported on Linux only since Zabbix 6.0.| |log\[file,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]|<|<|<|<| |<|Monitoring of a log file.|Log|**file** - full path and name of log file<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)<br>**maxlines** - maximum number of new lines per second the agent will send to Zabbix server or proxy. This parameter overrides the value of 'MaxLinesPerSecond' in [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd)<br>**mode** (since version 2.0)- possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).<br>**output** (since version 2.2) - an optional output formatting template. The **\\0** escape sequence is replaced with the matched part of text (from the first character where match begins until the character where match ends) while an **\\N** (where N=1...9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups).<br>**maxdelay** (since version 3.2) - maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the [maxdelay](log_items#using_maxdelay_parameter) notes before using it!<br>**options** (since version 4.4.7) - additional options:<br>*mtime-noreread* - non-unique records, reread only if the file size changes (ignore modification time change). (This parameter is deprecated since 5.0.2, because now mtime is ignored.)<br>**persistent\_dir** (since versions 5.0.18, 5.4.9, only in zabbix\_agentd on Unix systems; not supported in Agent2) - absolute pathname of directory where to store persistent files. See also additional notes on [persistent files](log_items#notes-on-persistent-files-for-log-items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks).<br>If file is missing or permissions do not allow access, item turns unsupported.<br><br>If `output` is left empty - the whole line containing the matched text is returned. Note that all global regular expression types except 'Result is TRUE' always return the whole matched line and the `output` parameter is ignored.<br><br>Content extraction using the `output` parameter takes place on the agent.<br><br>Examples:<br>=> log\[/var/log/syslog\]<br>=> log\[/var/log/syslog,error\]<br>=> log\[/home/zabbix/logs/logfile,,,100\]<br><br>*Using `output` parameter for extracting a number from log record:*<br>=> log\[/app1/app.log,"task run \[0-9.\]+ sec, processed (\[0-9\]+) records, \[0-9\]+ errors",,,,\\1\] → will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send only '6080' to server. Because a numeric value is being sent, the "Type of information" for this item can be set to "Numeric (unsigned)" and the value can be used in graphs, triggers etc.<br><br>*Using `output` parameter for rewriting log record before sending to server:*<br>=> log\[/app1/app.log,"(\[0-9 :-\]+) task run (\[0-9.\]+) sec, processed (\[0-9\]+) records, (\[0-9\]+) errors",,,,"\\1 RECORDS: \\3, ERRORS: \\4, DURATION: \\2"\] → will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send a modified record "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" to server.<br><br>See also additional information on [log monitoring](log_items).| |log.count\[file,\<regexp\>,\<encoding\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]|<|<|<|<| |<|Count of matched lines in a monitored log file.|Integer|**file** - full path and name of log file<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)<br>**maxproclines** - maximum number of new lines per second the agent will analyze (cannot exceed 10000). Default value is 10\*'MaxLinesPerSecond' in [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>**mode** - possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).<br>**maxdelay** - maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the [maxdelay](log_items#using_maxdelay_parameter) notes before using it!<br>**options** (since version 4.4.7) - additional options:<br>*mtime-noreread* - non-unique records, reread only if the file size changes (ignore modification time change). (This parameter is deprecated since 5.0.2, because now mtime is ignored.)<br>**persistent\_dir** (since versions 5.0.18, 5.4.9, only in zabbix\_agentd on Unix systems; not supported in Agent2) - absolute pathname of directory where to store persistent files. See also additional notes on [persistent files](log_items#notes-on-persistent-files-for-log-items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks).<br>If file is missing or permissions do not allow access, item turns unsupported.<br><br>See also additional information on [log monitoring](log_items).<br><br>This item is not supported for Windows Event Log.<br><br>Supported since Zabbix 3.2.0.| |logrt\[file\_regexp,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]|<|<|<|<| |<|Monitoring of a log file that is rotated.|Log|**file\_regexp** - absolute path to file and the file name described by a regular [expression](/manual/regular_expressions#overview). *Note* that only the file name is a regular expression<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required content pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)<br>**maxlines** - maximum number of new lines per second the agent will send to Zabbix server or proxy. This parameter overrides the value of 'MaxLinesPerSecond' in [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd)<br>**mode** (since version 2.0) - possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).<br>**output** (since version 2.2) - an optional output formatting template. The **\\0** escape sequence is replaced with the matched part of text (from the first character where match begins until the character where match ends) while an **\\N** (where N=1...9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups).<br>**maxdelay** (since version 3.2) - maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the [maxdelay](log_items#using_maxdelay_parameter) notes before using it!<br>**options** (since version 4.0; *mtime-reread*, *mtime-noreread* options since 4.4.7) - type of log file rotation and other options. Possible values:<br>*rotate* (default),<br>*copytruncate* - note that *copytruncate* cannot be used together with *maxdelay*. In this case *maxdelay* must be 0 or not specified; see [copytruncate](log_items#notes_on_handling_copytruncate_log_file_rotation) notes,<br>*mtime-reread* - non-unique records, reread if modification time or size changes (default),<br>*mtime-noreread* - non-unique records, reread only if the size changes (ignore modification time change).<br>**persistent\_dir** (since versions 5.0.18, 5.4.9, only in zabbix\_agentd on Unix systems; not supported in Agent2) - absolute pathname of directory where to store persistent files. See also additional notes on [persistent files](log_items#notes-on-persistent-files-for-log-items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks).<br>Log rotation is based on the last modification time of files.<br><br>Note that logrt is designed to work with one currently active log file, with several other matching inactive files rotated. If, for example, a directory has many active log files, a separate logrt item should be created for each one. Otherwise if one logrt item picks up too many files it may lead to exhausted memory and a crash of monitoring.<br><br>If `output` is left empty - the whole line containing the matched text is returned. Note that all global regular expression types except 'Result is TRUE' always return the whole matched line and the `output` parameter is ignored.<br><br>Content extraction using the `output` parameter takes place on the agent.<br><br>Examples:<br>=> logrt\["/home/zabbix/logs/\^logfile\[0-9\]{1,3}$",,,100\] → will match a file like "logfile1" (will not match ".logfile1")<br>=> logrt\["/home/user/\^logfile\_.\*\_\[0-9\]{1,3}$","pattern\_to\_match","UTF-8",100\] → will collect data from files such "logfile\_abc\_1" or "logfile\_\_001".<br><br>*Using `output` parameter for extracting a number from log record:*<br>=> logrt\[/app1/\^test.\*log$,"task run \[0-9.\]+ sec, processed (\[0-9\]+) records, \[0-9\]+ errors",,,,\\1\] → will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send only '6080' to server. Because a numeric value is being sent, the "Type of information" for this item can be set to "Numeric (unsigned)" and the value can be used in graphs, triggers etc.<br><br>*Using `output` parameter for rewriting log record before sending to server:*<br>=> logrt\[/app1/\^test.\*log$,"(\[0-9 :-\]+) task run (\[0-9.\]+) sec, processed (\[0-9\]+) records, (\[0-9\]+) errors",,,,"\\1 RECORDS: \\3, ERRORS: \\4, DURATION: \\2"\] → will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send a modified record "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" to server.<br><br>See also additional information on [log monitoring](log_items).| |logrt.count\[file\_regexp,\<regexp\>,\<encoding\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]|<|<|<|<| |<|Count of matched lines in a monitored log file that is rotated.|Integer|**file\_regexp** - absolute path to file and regular [expression](/manual/regular_expressions#overview) describing the file name pattern<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required content pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)<br>**maxproclines** - maximum number of new lines per second the agent will analyze (cannot exceed 10000). Default value is 10\*'MaxLinesPerSecond' in [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>**mode** - possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).<br>**maxdelay** - maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the [maxdelay](log_items#using_maxdelay_parameter) notes before using it!<br>**options** (since version 4.0; *mtime-reread*, *mtime-noreread* options since 4.4.7) - type of log file rotation and other options. Possible values:<br>*rotate* (default),<br>*copytruncate* - note that *copytruncate* cannot be used together with *maxdelay*. In this case *maxdelay* must be 0 or not specified; see [copytruncate](log_items#notes_on_handling_copytruncate_log_file_rotation) notes,<br>*mtime-reread* - non-unique records, reread if modification time or size changes (default),<br>*mtime-noreread* - non-unique records, reread only if the size changes (ignore modification time change).<br>**persistent\_dir** (since versions 5.0.18, 5.4.9, only in zabbix\_agentd on Unix systems; not supported in Agent2) - absolute pathname of directory where to store persistent files. See also additional notes on [persistent files](log_items#notes-on-persistent-files-for-log-items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks).<br>Log rotation is based on the last modification time of files.<br><br>See also additional information on [log monitoring](log_items).<br><br>This item is not supported for Windows Event Log.<br><br>Supported since Zabbix 3.2.0.| |modbus.get\[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>\]|<|<|<|<| |<|Reads Modbus data.|JSON object|**endpoint** - endpoint defined as `protocol://connection_string`<br>**slave id** - slave ID<br>**function** - Modbus function<br>**address** - address of first registry, coil or input<br>**count** - number of records to read<br>**type** - type of data<br>**endianness** - endianness configuration<br>**offset** - number of registers, starting from 'address', the results of which will be discarded.<br><br>See a [detailed description](/manual/appendix/items/modbus) of parameters.|Supported since Zabbix 5.2.0.| |net.dns\[<ip>,name,<type>,<timeout>,<count>,<protocol>\]|<|<|<|<| |<|Checks if DNS service is up.|0 - DNS is down (server did not respond or DNS resolution failed)<br><br>1 - DNS is up|**ip** - IP address of DNS server (leave empty for the default DNS server, ignored on Windows)<br>**name** - DNS name to query<br>**type** - record type to be queried (default is *SOA*)<br>**timeout** (ignored on Windows) - timeout for the request in seconds (default is 1 second)<br>**count** (ignored on Windows) - number of tries for the request (default is 2)<br>**protocol** (since version 3.0) - the protocol used to perform DNS queries: *udp* (default) or *tcp*|Example:<br>=> net.dns\[8.8.8.8,example.com,MX,2,1\]<br><br>The possible values for `type` are:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (except for Windows), *HINFO*, *MINFO*, *TXT*, *SRV*<br><br>Internationalized domain names are not supported, please use IDNA encoded names instead.<br><br>SRV record type is supported since Zabbix 1.8.6 (Unix) and 2.0.0 (Windows).<br><br>Naming before Zabbix 2.0 (still supported): *net.tcp.dns*| |net.dns.record\[<ip>,name,<type>,<timeout>,<count>,<protocol>\]|<|<|<|<| |<|Performs a DNS query.|Character string with the required type of information|**ip** - IP address of DNS server (leave empty for the default DNS server, ignored on Windows)<br>**name** - DNS name to query<br>**type** - record type to be queried (default is *SOA*)<br>**timeout** (ignored on Windows) - timeout for the request in seconds (default is 1 second)<br>**count** (ignored on Windows) - number of tries for the request (default is 2)<br>**protocol**(since version 3.0) - the protocol used to perform DNS queries: *udp* (default) or *tcp*|Example:<br>=> net.dns.record\[8.8.8.8,example.com,MX,2,1\]<br><br>The possible values for `type` are:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (except for Windows), *HINFO*, *MINFO*, *TXT*, *SRV*<br><br>Internationalized domain names are not supported, please use IDNA encoded names instead.<br><br>SRV record type is supported since Zabbix 1.8.6 (Unix) and 2.0.0 (Windows).<br><br>Naming before Zabbix 2.0 (still supported): *net.tcp.dns.query*| |net.if.collisions\[if\]|<|<|<|<| |<|Number of out-of-window collisions.|Integer|**if** - network interface name| | |net.if.discovery|<|<|<|<| |<|List of network interfaces. Used for low-level discovery.|JSON object| |Supported since Zabbix 2.0.<br><br>On FreeBSD, OpenBSD and NetBSD supported since Zabbix 2.2.<br><br>Some Windows versions (for example, Server 2008) might require the latest updates installed to support non-ASCII characters in interface names.| |net.if.in\[if,<mode>\]|<|<|<|<| |<|Incoming traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*frame* - the number of packet framing errors<br>*compressed* - the number of compressed packets transmitted or received by the device driver<br>*multicast* - the number of multicast frames received by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Multi-byte interface names on Windows are supported since Zabbix 1.8.6.<br><br>Examples:<br>=> net.if.in\[eth0,errors\]<br>=> net.if.in\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.| |net.if.out\[if,<mode>\]|<|<|<|<| |<|Outgoing traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*collisions (colls)* - the number of collisions detected on the interface<br>*carrier* - the number of carrier losses detected by the device driver<br>*compressed* - the number of compressed packets transmitted by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Multi-byte interface names on Windows are supported since Zabbix agent 1.8.6 version.<br><br>Examples:<br>=> net.if.out\[eth0,errors\]<br>=> net.if.out\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.| |net.if.total\[if,<mode>\]|<|<|<|<| |<|Sum of incoming and outgoing traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*compressed* - the number of compressed packets transmitted or received by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Examples:<br>=> net.if.total\[eth0,errors\]<br>=> net.if.total\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.<br><br>Note that dropped packets are supported only if both net.if.in and net.if.out work for dropped packets on your platform.| |net.tcp.listen\[port\]|<|<|<|<| |<|Checks if this TCP port is in LISTEN state.|0 - it is not in LISTEN state<br><br>1 - it is in LISTEN state|**port** - TCP port number|Example:<br>=> net.tcp.listen\[80\]<br><br>On Linux supported since Zabbix 1.8.4<br><br>Since Zabbix 3.0.0, on Linux kernels 2.6.14 and above, information about listening TCP sockets is obtained from the kernel's NETLINK interface, if possible. Otherwise, the information is retrieved from /proc/net/tcp and /proc/net/tcp6 files.| |net.tcp.port\[<ip>,port\]|<|<|<|<| |<|Checks if it is possible to make TCP connection to specified port.|0 - cannot connect<br><br>1 - can connect|**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number|Example:<br>=> net.tcp.port\[,80\] → can be used to test availability of web server running on port 80.<br><br>For simple TCP performance testing use net.tcp.service.perf\[tcp,<ip>,<port>\]<br><br>Note that these checks may result in additional messages in system daemon logfiles (SMTP and SSH sessions being logged usually).| |net.tcp.service\[service,<ip>,<port>\]|<|<|<|<| |<|Checks if service is running and accepting TCP connections.|0 - service is down<br><br>1 - service is running|**service** - either of:<br>*ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP address (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.tcp.service\[ftp,,45\] → can be used to test the availability of FTP server on TCP port 45.<br><br>Note that these checks may result in additional messages in system daemon logfiles (SMTP and SSH sessions being logged usually).<br><br>Checking of encrypted protocols (like IMAP on port 993 or POP on port 995) is currently not supported. As a workaround, please use net.tcp.port for checks like these.<br><br>Checking of LDAP and HTTPS on Windows is only supported by Zabbix agent 2.<br><br>Note that the telnet check looks for a login prompt (':' at the end).<br><br>See also [known issues](/manual/installation/known_issues#https_checks) of checking HTTPS service.<br><br>*https* and *telnet* services are supported since Zabbix 2.0.| |net.tcp.service.perf\[service,<ip>,<port>\]|<|<|<|<| |<|Checks performance of TCP service.|0 - service is down<br><br>seconds - the number of seconds spent while connecting to the service|**service** - either of:<br>*ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP address (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.tcp.service.perf\[ssh\] → can be used to test the speed of initial response from SSH server.<br><br>Checking of encrypted protocols (like IMAP on port 993 or POP on port 995) is currently not supported. As a workaround, please use net.tcp.service.perf\[tcp,<ip>,<port>\] for checks like these.<br><br>Checking of LDAP and HTTPS on Windows is only supported by Zabbix agent 2.<br><br>Note that the telnet check looks for a login prompt (':' at the end).<br><br>See also [known issues](/manual/installation/known_issues#https_checks) of checking HTTPS service.<br><br>*https* and *telnet* services are supported since Zabbix 2.0.| |net.tcp.socket.count\[<laddr>,<lport>,<raddr>,<rport>,<state>\]|<|<|<|<| |<|Return the number of TCP sockets that match parameters.|Integer|**laddr** - local IPv4/6 address or CIDR subnet<br>**lport** - local port number or service name<br>**raddr** - remote IPv4/6 address or CIDR subnet<br>**rport** - remote port number or service name<br>**state** - connection state (*established*, *syn\_sent*, *syn\_recv*, *fin\_wait1*, *fin\_wait2*, *time\_wait*, *close*, *close\_wait*, *last\_ack*, *listen*, *closing*)|This item is supported on Linux only on both Zabbix agent/agent 2. On Zabbix agent 2 it is also supported on 64-bit Windows.<br><br>Example:<br>=> net.tcp.socket.count\[,80,,,established\] → check if local TCP port 80 is in "established" state<br><br>This item is supported since Zabbix 6.0.| |net.udp.listen\[port\]|<|<|<|<| |<|Checks if this UDP port is in LISTEN state.|0 - it is not in LISTEN state<br><br>1 - it is in LISTEN state|**port** - UDP port number|Example:<br>=> net.udp.listen\[68\]<br><br>On Linux supported since Zabbix 1.8.4| |net.udp.service\[service,<ip>,<port>\]|<|<|<|<| |<|Checks if service is running and responding to UDP requests.|0 - service is down<br><br>1 - service is running|**service** - *ntp* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP address (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.udp.service\[ntp,,45\] → can be used to test the availability of NTP service on UDP port 45.<br><br>This item is supported since Zabbix 3.0.0, but *ntp* service was available for net.tcp.service\[\] item in prior versions.| |net.udp.service.perf\[service,<ip>,<port>\]|<|<|<|<| |<|Checks performance of UDP service.|0 - service is down<br><br>seconds - the number of seconds spent waiting for response from the service|**service** - *ntp* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP address (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.udp.service.perf\[ntp\] → can be used to test response time from NTP service.<br><br>This item is supported since Zabbix 3.0.0, but *ntp* service was available for net.tcp.service\[\] item in prior versions.| |net.udp.socket.count\[<laddr>,<lport>,<raddr>,<rport>,<state>\]|<|<|<|<| |<|Return the number of TCP sockets that match parameters.|Integer|**laddr** - local IPv4/6 address or CIDR subnet<br>**lport** - local port number or service name<br>**raddr** - remote IPv4/6 address or CIDR subnet<br>**rport** - remote port number or service name<br>**state** - connection state (*established*, *unconn*)|This item is supported on Linux only on both Zabbix agent/agent 2. On Zabbix agent 2 it is also supported on 64-bit Windows.<br><br>Example:<br>=> net.udp.socket.count\[,,,,listening\] → check if any UDP socket is in "listening" state<br><br>This item is supported since Zabbix 6.0.| |proc.cpu.util\[<name>,<user>,<type>,<cmdline>,<mode>,<zone>\]|<|<|<|<| |<|Process CPU utilization percentage.|Float|**name** - process name (default is *all processes*)<br>**user** - user name (default is *all users*)<br>**type** - CPU utilization type:<br>*total* (default), *user*, *system*<br>**cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview))<br>**mode** - data gathering mode: *avg1* (default), *avg5*, *avg15*<br>**zone** - target zone: *current* (default), *all*. This parameter is supported on Solaris only.|Examples:<br>=> proc.cpu.util\[,root\] → CPU utilization of all processes running under the "root" user<br>=> proc.cpu.util\[zabbix\_server,zabbix\] → CPU utilization of all zabbix\_server processes running under the zabbix user<br><br>The returned value is based on single CPU core utilization percentage. For example CPU utilization of a process fully using two cores is 200%.<br><br>The process CPU utilization data is gathered by a collector which supports the maximum of 1024 unique (by name, user and command line) queries. Queries not accessed during the last 24 hours are removed from the collector.<br><br>*Note* that when setting the `zone` parameter to *current* (or default) in case the agent has been compiled on a Solaris without zone support, but running on a newer Solaris where zones are supported, then the agent will return NOTSUPPORTED (the agent cannot limit results to only the current zone). However, *all* is supported in this case.<br><br>This key is supported since Zabbix 3.0.0 and is available on several platforms (see [Items supported by platform](/manual/appendix/items/supported_by_platform)).| |proc.mem\[<name>,<user>,<mode>,<cmdline>,<memtype>\]|<|<|<|<| |<|Memory used by process in bytes.|Integer - with `mode` as *max*, *min*, *sum*<br><br>Float - with `mode` as *avg*|**name** - process name (default is *all processes*)<br>**user** - user name (default is *all users*)<br>**mode** - possible values:<br>*avg*, *max*, *min*, *sum* (default)<br>**cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview))<br>**memtype** - [type of memory](/manual/appendix/items/proc_mem_notes) used by process|Examples:<br>=> proc.mem\[,root\] → memory used by all processes running under the "root" user<br>=> proc.mem\[zabbix\_server,zabbix\] → memory used by all zabbix\_server processes running under the zabbix user<br>=> proc.mem\[,oracle,max,oracleZABBIX\] → memory used by the most memory-hungry process running under oracle having oracleZABBIX in its command line<br><br>*Note*: When several processes use shared memory, the sum of memory used by processes may result in large, unrealistic values.<br><br>See [notes](/manual/appendix/items/proc_mem_num_notes) on selecting processes with `name` and `cmdline` parameters (Linux-specific).<br><br>When this item is invoked from the command line and contains a command line parameter (e.g. using the agent test mode: `zabbix_agentd -t proc.mem[,,,apache2]`), one extra process will be counted, as the agent will count itself.<br><br>The `memtype` parameter is supported on several [platforms](/manual/appendix/items/supported_by_platform) since Zabbix 3.0.0.| |proc.num\[<name>,<user>,<state>,<cmdline>,<zone>\]|<|<|<|<| |<|The number of processes.|Integer|**name** - process name (default is *all processes*)<br>**user** - user name (default is *all users*)<br>**state** (*disk* and *trace* options since version 3.4.0) - possible values:<br>*all* (default),<br>*disk* - uninterruptible sleep,<br>*run* - running,<br>*sleep* - interruptible sleep,<br>*trace* - stopped,<br>*zomb* - zombie<br>**cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview))<br>**zone** - target zone: *current* (default), *all*. This parameter is supported on Solaris only.|Examples:<br>=> proc.num\[,mysql\] → number of processes running under the mysql user<br>=> proc.num\[apache2,www-data\] → number of apache2 processes running under the www-data user<br>=> proc.num\[,oracle,sleep,oracleZABBIX\] → number of processes in sleep state running under oracle having oracleZABBIX in its command line<br><br>See [notes](/manual/appendix/items/proc_mem_num_notes) on selecting processes with `name` and `cmdline` parameters (Linux-specific).<br><br>On Windows, only the `name` and `user` parameters are supported.<br><br>When this item is invoked from the command line and contains a command line parameter (e.g. using the agent test mode: `zabbix_agentd -t proc.num[,,,apache2]`), one extra process will be counted, as the agent will count itself.<br><br>*Note* that when setting the `zone` parameter to *current* (or default) in case the agent has been compiled on a Solaris without zone support, but running on a newer Solaris where zones are supported, then the agent will return NOTSUPPORTED (the agent cannot limit results to only the current zone). However, *all* is supported in this case.| |sensor\[device,sensor,<mode>\]|<|<|<|<| |<|Hardware sensor reading.|Float|**device** - device name<br>**sensor** - sensor name<br>**mode** - possible values:<br>*avg*, *max*, *min* (if this parameter is omitted, device and sensor are treated verbatim).|Reads /proc/sys/dev/sensors on Linux 2.4.<br><br>Example:<br>=> sensor\[w83781d-i2c-0-2d,temp1\]<br><br>Prior to Zabbix 1.8.4, the *sensor\[temp1\]* format was used.| |^|^|^|^|Reads /sys/class/hwmon on Linux 2.6+.<br><br>See a more detailed description of [sensor](/manual/appendix/items/sensor) item on Linux.| |^|^|^|^|Reads the *hw.sensors* MIB on OpenBSD.<br><br>Examples:<br>=> sensor\[cpu0,temp0\] → temperature of one CPU<br>=> sensor\["cpu\[0-2\]$",temp,avg\] → average temperature of the first three CPU's<br><br>Supported on OpenBSD since Zabbix 1.8.4.| |system.boottime|<|<|<|<| |<|System boot time.|Integer (Unix timestamp)| | | |system.cpu.discovery|<|<|<|<| |<|List of detected CPUs/CPU cores. Used for low-level discovery.|JSON object| |Supported on all platforms since 2.4.0.| |system.cpu.intr|<|<|<|<| |<|Device interrupts.|Integer| | | |system.cpu.load\[<cpu>,<mode>\]|<|<|<|<| |<|[CPU load](http://en.wikipedia.org/wiki/Load_(computing)).|Float|**cpu** - possible values:<br>*all* (default), *percpu* (since version 2.0; total load divided by online CPU count)<br>**mode** - possible values:<br>*avg1* (one-minute average, default), *avg5*, *avg15*|Example:<br>=> system.cpu.load\[,avg5\].| |system.cpu.num\[<type>\]|<|<|<|<| |<|Number of CPUs.|Integer|**type** - possible values:<br>*online* (default), *max*|Example:<br>=> system.cpu.num| |system.cpu.switches|<|<|<|<| |<|Count of context switches.|Integer| | | |system.cpu.util\[<cpu>,<type>,<mode>,<logical\_or\_physical>\]|<|<|<|<| |<|CPU utilization percentage.|Float|**cpu** - *<CPU number>* or *all* (default)<br>**type** - possible values:<br>*user* (default), *idle*, *nice*, *system* (default for Windows), *iowait*, *interrupt*, *softirq*, *steal*, *guest* (on Linux kernels 2.6.24 and above), *guest\_nice* (on Linux kernels 2.6.33 and above).<br>See also [platform-specific](/manual/appendix/items/supported_by_platform) details for this parameter.<br>**mode** - possible values:<br>*avg1* (one-minute average, default), *avg5*, *avg15*<br>**logical\_or\_physical** (since version 5.0.3; on AIX only) - possible values: *logical* (default), *physical*. This parameter is supported on AIX only.|Example:<br>=> system.cpu.util\[0,user,avg5\]<br><br>Old naming: *system.cpu.idleX, system.cpu.niceX, system.cpu.systemX, system.cpu.userX*| |system.hostname\[<type>, <transform>\]|<|<|<|<| |<|System host name.|String|**type** (before version 5.4.7 supported on Windows only) - possible values: *netbios* (default on Windows), *host* (default on Linux), *shorthost* (since version 5.4.7; returns part of the hostname before the first dot, a full string for names without dots).<br>**transform** (since version 5.4.7) - possible values:<br>*none* (default), *lower* (convert to lowercase)|The value is acquired by either GetComputerName() (for **netbios**) or gethostname() (for **host**) functions on Windows and by "hostname" command on other systems.<br><br>Examples of returned values:<br>*on Linux*:<br>=> system.hostname → linux-w7x1<br>=> system.hostname → example.com<br>=> system.hostname\[shorthost\] → example<br>*on Windows*:<br>=> system.hostname → WIN-SERV2008-I6<br>=> system.hostname\[host\] → Win-Serv2008-I6LonG<br>=> system.hostname\[host,lower\] → win-serv2008-i6long<br><br>See also a [more detailed description](/manual/appendix/install/windows_agent#configuration).| |system.hw.chassis\[<info>\]|<|<|<|<| |<|Chassis information.|String|**info** - one of full (default), model, serial, type or vendor|Example: system.hw.chassis\[full\]<br>Hewlett-Packard HP Pro 3010 Small Form Factor PC CZXXXXXXXX Desktop\]<br><br>This key depends on the availability of the [SMBIOS](http://en.wikipedia.org/wiki/System_Management_BIOS) table.<br>Will try to read the DMI table from sysfs, if sysfs access fails then try reading directly from memory.<br><br>**Root permissions** are required because the value is acquired by reading from sysfs or memory.<br><br>Supported since Zabbix 2.0.| |system.hw.cpu\[<cpu>,<info>\]|<|<|<|<| |<|CPU information.|String or integer|**cpu** - *<CPU number>* or *all* (default)<br>**info** - possible values:<br>*full* (default), *curfreq*, *maxfreq*, *model* or *vendor*|Example:<br>=> system.hw.cpu\[0,vendor\] → AuthenticAMD<br><br>Gathers info from /proc/cpuinfo and /sys/devices/system/cpu/\[cpunum\]/cpufreq/cpuinfo\_max\_freq.<br><br>If a CPU number and *curfreq* or *maxfreq* is specified, a numeric value is returned (Hz).<br><br>Supported since Zabbix 2.0.| |system.hw.devices\[<type>\]|<|<|<|<| |<|Listing of PCI or USB devices.|Text|**type** (since version 2.0) - *pci* (default) or *usb*|Example:<br>=> system.hw.devices\[pci\] → 00:00.0 Host bridge: Advanced Micro Devices \[AMD\] RS780 Host Bridge<br>\[..\]<br><br>Returns the output of either lspci or lsusb utility (executed without any parameters).| |system.hw.macaddr\[<interface>,<format>\]|<|<|<|<| |<|Listing of MAC addresses.|String|**interface** - *all* (default) or a regular [expression](/manual/regular_expressions#overview)<br>**format** - *full* (default) or *short*|Lists MAC addresses of the interfaces whose name matches the given `interface` regular [expression](/manual/regular_expressions#overview) (*all* lists for all interfaces).<br><br>Example:<br>=> system.hw.macaddr\["eth0$",full\] → \[eth0\] 00:11:22:33:44:55<br><br>If `format` is specified as *short*, interface names and identical MAC addresses are not listed.<br><br>Supported since Zabbix 2.0.| |system.localtime\[<type>\]|<|<|<|<| |<|System time.|Integer - with `type` as *utc*<br><br>String - with `type` as *local*|**type** (since version 2.0) - possible values:<br>*utc* - (default) the time since the Epoch (00:00:00 UTC, January 1, 1970), measured in seconds.<br>*local* - the time in the 'yyyy-mm-dd,hh:mm:ss.nnn,+hh:mm' format<br>|Must be used as a [passive check](/manual/appendix/items/activepassive#passive_checks) only.<br><br>Example:<br>=> system.localtime\[local\] → create an item using this key and then use it to display host time in the *Clock* [dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#clock).| |system.run\[command,<mode>\]|<|<|<|<| |<|Run specified command on the host.|Text result of the command<br><br>1 - with `mode` as *nowait* (regardless of command result)|**command** - command for execution<br>**mode** - possible values:<br>*wait* - wait end of execution (default),<br>*nowait* - do not wait|Up to 512KB of data can be returned, including trailing whitespace that is truncated.<br>To be processed correctly, the output of the command must be text.<br><br>Example:<br>=> system.run\[ls -l /\] → detailed file list of root directory.<br><br>*Note*: system.run items are disabled by default. Learn how to [enable them](/manual/config/items/restrict_checks).<br><br>The return value of the item is standard output together with standard error produced by command. The exit code is not checked.<br><br>Empty result is allowed starting with Zabbix 2.4.0.<br>See also: [Command execution](/manual/appendix/command_execution).| |system.stat\[resource,<type>\]|<|<|<|<| |<|System statistics.|Integer or float|**ent** - number of processor units this partition is entitled to receive (float)<br>**kthr,<type>** - information about kernel thread states:<br>*r* - average number of runnable kernel threads (float)<br>*b* - average number of kernel threads placed in the Virtual Memory Manager wait queue (float)<br>**memory,<type>** - information about the usage of virtual and real memory:<br>*avm* - active virtual pages (integer)<br>*fre* - size of the free list (integer)<br>**page,<type>** - information about page faults and paging activity:<br>*fi* - file page-ins per second (float)<br>*fo* - file page-outs per second (float)<br>*pi* - pages paged in from paging space (float)<br>*po* - pages paged out to paging space (float)<br>*fr* - pages freed (page replacement) (float)<br>*sr* - pages scanned by page-replacement algorithm (float)<br>**faults,<type>** - trap and interrupt rate:<br>*in* - device interrupts (float)<br>*sy* - system calls (float)<br>*cs* - kernel thread context switches (float)<br>**cpu,<type>** - breakdown of percentage usage of processor time:<br>*us* - user time (float)<br>*sy* - system time (float)<br>*id* - idle time (float)<br>*wa* - idle time during which the system had outstanding disk/NFS I/O request(s) (float)<br>*pc* - number of physical processors consumed (float)<br>*ec* - the percentage of entitled capacity consumed (float)<br>*lbusy* - indicates the percentage of logical processor(s) utilization that occurred while executing at the user and system level (float)<br>*app* - indicates the available physical processors in the shared pool (float)<br>**disk,<type>** - disk statistics:<br>*bps* - indicates the amount of data transferred (read or written) to the drive in bytes per second (integer)<br>*tps* - indicates the number of transfers per second that were issued to the physical disk/tape (float)|<| |<|^|^|Comments|<| |<|^|^|This item is [supported](/manual/appendix/items/supported_by_platform) on AIX only, since Zabbix 1.8.1.<br>Take note of the following limitations in these items:<br>=> system.stat\[cpu,app\] - supported only on AIX LPAR of type "Shared"<br>=> system.stat\[cpu,ec\] - supported on AIX LPAR of type "Shared" and "Dedicated" ("Dedicated" always returns 100 (percent))<br>=> system.stat\[cpu,lbusy\] - supported only on AIX LPAR of type "Shared"<br>=> system.stat\[cpu,pc\] - supported on AIX LPAR of type "Shared" and "Dedicated"<br>=> system.stat\[ent\] - supported on AIX LPAR of type "Shared" and "Dedicated"|<| |system.sw.arch|<|<|<|<| |<|Software architecture information.|String| |Example:<br>=> system.sw.arch → i686<br><br>Info is acquired from uname() function.<br><br>Supported since Zabbix 2.0.| |system.sw.os\[<info>\]|<|<|<|<| |<|Operating system information.|String|**info** - possible values:<br>*full* (default), *short* or *name*|Example:<br>=> system.sw.os\[short\]→ Ubuntu 2.6.35-28.50-generic 2.6.35.11<br><br>Info is acquired from (note that not all files and options are present in all distributions):<br>/proc/version (*full*)<br>/proc/version\_signature (*short*)<br>PRETTY\_NAME parameter from /etc/os-release on systems supporting it, or /etc/issue.net (*name*)<br><br>Supported since Zabbix 2.0.| |system.sw.packages\[<package>,<manager>,<format>\]|<|<|<|<| |<|Listing of installed packages.|Text|**package** - *all* (default) or a regular [expression](/manual/regular_expressions#overview)<br>**manager** - *all* (default) or a package manager<br>**format** - *full* (default) or *short*|Lists (alphabetically) installed packages whose name matches the given `package` regular [expression](/manual/regular_expressions#overview) (*all* lists them all).<br><br>Example:<br>=> system.sw.packages\[mini,dpkg,short\] → python-minimal, python2.6-minimal, ubuntu-minimal<br><br>Supported package managers (executed command):<br>dpkg (dpkg --get-selections)<br>pkgtool (ls /var/log/packages)<br>rpm (rpm -qa)<br>pacman (pacman -Q)<br><br>If `format` is specified as *full*, packages are grouped by package managers (each manager on a separate line beginning with its name in square brackets).<br>If `format` is specified as *short*, packages are not grouped and are listed on a single line.<br><br>Supported since Zabbix 2.0.| |system.swap.in\[<device>,<type>\]|<|<|<|<| |<|Swap in (from device into memory) statistics.|Integer|**device** - device used for swapping (default is *all*)<br>**type** - possible values:<br>*count* (number of swapins), *sectors* (sectors swapped in), *pages* (pages swapped in).<br>See also [platform-specific](/manual/appendix/items/supported_by_platform) details for this parameter.|Example:<br>=> system.swap.in\[,pages\]<br><br>The source of this information is:<br>/proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)<br>/proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)| |system.swap.out\[<device>,<type>\]|<|<|<|<| |<|Swap out (from memory onto device) statistics.|Integer|**device** - device used for swapping (default is *all*)<br>**type** - possible values:<br>*count* (number of swapouts), *sectors* (sectors swapped out), *pages* (pages swapped out).<br>See also [platform-specific](/manual/appendix/items/supported_by_platform) details for this parameter.|Example:<br>=> system.swap.out\[,pages\]<br><br>The source of this information is:<br>/proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)<br>/proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)| |system.swap.size\[<device>,<type>\]|<|<|<|<| |<|Swap space size in bytes or in percentage from total.|Integer - for bytes<br><br>Float - for percentage|**device** - device used for swapping (default is *all*)<br>**type** - possible values:<br>*free* (free swap space, default), *pfree* (free swap space, in percent), *pused* (used swap space, in percent), *total* (total swap space), *used* (used swap space)<br>Note that *pfree*, *pused* are not supported on Windows if swap size is 0.<br>See also [platform-specific](/manual/appendix/items/supported_by_platform) details for this parameter.|Example:<br>=> system.swap.size\[,pfree\] → free swap space percentage<br><br>If *device* is not specified Zabbix agent will only take into account swap devices (files), physical memory will be ignored. For example, on Solaris systems *swap -s* command includes a portion of physical memory and swap devices (unlike *swap -l*).<br><br>Note that this key might report incorrect swap space size/percentage on virtualized (VMware ESXi, VirtualBox) Windows platforms. In this case you may use the `perf_counter[\700(_Total)\702]` key to obtain correct swap space percentage.| |system.uname|<|<|<|<| |<|Identification of the system.|String| |Example of returned value (Unix):<br>FreeBSD localhost 4.2-RELEASE FreeBSD 4.2-RELEASE \#0: Mon Nov i386<br><br>Example of returned value (Windows):<br>Windows ZABBIX-WIN 6.0.6001 Microsoft® Windows Server® 2008 Standard Service Pack 1 x86<br><br>On Unix since Zabbix 2.2.0 the value for this item is obtained with uname() system call. Previously it was obtained by invoking "uname -a". The value of this item might differ from the output of "uname -a" and does not include additional information that "uname -a" prints based on other sources.<br><br>On Windows since Zabbix 3.0 the value for this item is obtained from Win32\_OperatingSystem and Win32\_Processor WMI classes. Previously it was obtained from volatile Windows APIs and undocumented registry keys. The OS name (including edition) might be translated to the user's display language. On some versions of Windows it contains trademark symbols and extra spaces.<br><br>Note that on Windows the item returns OS architecture, whereas on Unix it returns CPU architecture.| |system.uptime|<|<|<|<| |<|System uptime in seconds.|Integer| |In [item configuration](/manual/config/items/item#configuration), use **s** or **uptime** units to get readable values.| |system.users.num|<|<|<|<| |<|Number of users logged in.|Integer| |**who** command is used on the agent side to obtain the value.| |vfs.dev.discovery|<|<|<|<| |<|List of block devices and their type. Used for low-level discovery.|JSON object| |This item is supported on Linux platform only.<br><br>Supported since Zabbix 4.4.0.| |vfs.dev.read\[<device>,<type>,<mode>\]|<|<|<|<| |<|Disk read statistics.|Integer - with `type` in *sectors*, *operations*, *bytes*<br><br>Float - with `type` in *sps*, *ops*, *bps*<br><br>*Note*: if using an update interval of three hours or more^**[2](#footnotes)**^, will always return '0'|**device** - disk device (default is *all* ^**[3](#footnotes)**^)<br>**type** - possible values: *sectors*, *operations*, *bytes*, *sps*, *ops*, *bps*<br>Note that 'type' parameter support and defaults depend on the platform. See [platform-specific](/manual/appendix/items/supported_by_platform) details.<br>*sps*, *ops*, *bps* stand for: sectors, operations, bytes per second, respectively.<br>**mode** - possible values: *avg1* (one-minute average, default), *avg5*, *avg15*.<br>This parameter is supported only with `type` in: sps, ops, bps.|You may use relative device names (for example, `sda`) as well as an optional /dev/ prefix (for example, `/dev/sda`).<br><br>LVM logical volumes are supported.<br><br>Default values of 'type' parameter for different OSes:<br>AIX - operations<br>FreeBSD - bps<br>Linux - sps<br>OpenBSD - operations<br>Solaris - bytes<br><br>Example:<br>=> vfs.dev.read\[,operations\]<br><br>*sps*, *ops* and *bps* on supported platforms used to be limited to 8 devices (7 individual and one *all*). Since Zabbix 2.0.1 this limit is 1024 devices (1023 individual and one for *all*).| |vfs.dev.write\[<device>,<type>,<mode>\]|<|<|<|<| |<|Disk write statistics.|Integer - with `type` in *sectors*, *operations*, *bytes*<br><br>Float - with `type` in *sps*, *ops*, *bps*<br><br>*Note*: if using an update interval of three hours or more^**[2](#footnotes)**^, will always return '0'|**device** - disk device (default is *all* ^**[3](#footnotes)**^)<br>**type** - possible values: *sectors*, *operations*, *bytes*, *sps*, *ops*, *bps*<br>Note that 'type' parameter support and defaults depend on the platform. See [platform-specific](/manual/appendix/items/supported_by_platform) details.<br>*sps*, *ops*, *bps* stand for: sectors, operations, bytes per second, respectively.<br>**mode** - possible values: *avg1* (one-minute average, default), *avg5*, *avg15*.<br>This parameter is supported only with `type` in: sps, ops, bps.|You may use relative device names (for example, `sda`) as well as an optional /dev/ prefix (for example, `/dev/sda`).<br><br>LVM logical volumes are supported.<br><br>Default values of 'type' parameter for different OSes:<br>AIX - operations<br>FreeBSD - bps<br>Linux - sps<br>OpenBSD - operations<br>Solaris - bytes<br><br>Example:<br>=> vfs.dev.write\[,operations\]<br><br>*sps*, *ops* and *bps* on supported platforms used to be limited to 8 devices (7 individual and one *all*). Since Zabbix 2.0.1 this limit is 1024 (1023 individual and one for *all*).| |vfs.dir.count\[dir,<regex\_incl>,<regex\_excl>,<types\_incl>,<types\_excl>,<max\_depth>,<min\_size>,<max\_size>,<min\_age>,<max\_age>,<regex\_excl\_dir>\]|<|<|<|<| |<|Directory entry count.|Integer|**dir** - absolute path to directory<br>**regex\_incl** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the entity (file, directory, symbolic link) to include; include all if empty (default value)<br>**regex\_excl** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the entity (file, directory, symbolic link) to exclude; don't exclude any if empty (default value)<br>**types\_incl** - directory entry types to count, possible values:<br>*file* - regular file, *dir* - subdirectory, *sym* - symbolic link, *sock* - socket, *bdev* - block device, *cdev* - character device, *fifo* - FIFO, *dev* - synonymous with "bdev,cdev", *all* - all types (default), i.e. "file,dir,sym,sock,bdev,cdev,fifo". Multiple types must be separated with comma and quoted.<br>**types\_excl** - directory entry types (see <types\_incl>) to NOT count. If some entry type is in both <types\_incl> and <types\_excl>, directory entries of this type are NOT counted.<br>**max\_depth** - maximum depth of subdirectories to traverse. **-1** (default) - unlimited, **0** - no descending into subdirectories.<br>**min\_size** - minimum size (in bytes) for file to be counted. Smaller files will not be counted. [Memory suffixes](/manual/appendix/suffixes#memory_suffixes) can be used.<br>**max\_size** - maximum size (in bytes) for file to be counted. Larger files will not be counted. [Memory suffixes](/manual/appendix/suffixes#memory_suffixes) can be used.<br>**min\_age** - minimum age (in seconds) of directory entry to be counted. More recent entries will not be counted. [Time suffixes](/manual/appendix/suffixes#time_suffixes) can be used.<br>**max\_age** - maximum age (in seconds) of directory entry to be counted. Entries so old and older will not be counted (modification time). [Time suffixes](/manual/appendix/suffixes#time_suffixes) can be used.<br>**regex\_excl\_dir** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the directory to exclude. All content of the directory will be excluded (in contrast to regex\_excl)|Environment variables, e.g. %APP\_HOME%, $HOME and %TEMP% are not supported.<br><br>Pseudo-directories "." and ".." are never counted.<br><br>Symbolic links are never followed for directory traversal.<br><br>On Windows, directory symlinks are skipped and hard links are counted only once.<br><br>Both `regex_incl` and `regex_excl` are being applied to files and directories when calculating entry size, but are ignored when picking subdirectories to traverse (if regex\_incl is “(?i)\^.+\\.zip$” and max\_depth is not set, then all subdirectories will be traversed, but only files of type zip will be counted).<br><br>Execution time is limited by the default timeout value in agent [configuration](/manual/appendix/config/zabbix_agentd) (3 sec). Since large directory traversal may take longer than that, no data will be returned and the item will turn unsupported. Partial count will not be returned.<br><br>When filtering by size, only regular files have meaningful sizes. Under Linux and BSD, directories also have non-zero sizes (a few Kb typically). Devices have zero sizes, e.g. the size of **/dev/sda1** does not reflect the respective partition size. Therefore, when using `<min_size>` and `<max_size>`, it is advisable to specify `<types_incl>` as "*file*", to avoid surprises.<br><br>Examples:<br>⇒ vfs.dir.count\[/dev\] - monitors number of devices in /dev (Linux)<br>⇒ vfs.dir.count\["C:\\Users\\ADMINI\~1\\AppData\\Local\\Temp"\] - monitors number of files in temporary directory (Windows)<br><br>Supported since Zabbix 4.0.0.| |vfs.dir.get\[dir,<regex\_incl>,<regex\_excl>,<types\_incl>,<types\_excl>,<max\_depth>,<min\_size>,<max\_size>,<min\_age>,<max\_age>,<regex\_excl\_dir>\]|<|<|<|<| |<|Directory entry list.|JSON|**dir** - absolute path to directory<br>**regex\_incl** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the entity (file, directory, symbolic link) to include; include all if empty (default value)<br>**regex\_excl** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the entity (file, directory, symbolic link) to exclude; don't exclude any if empty (default value)<br>**types\_incl** - directory entry types to list, possible values:<br>*file* - regular file, *dir* - subdirectory, *sym* - symbolic link, *sock* - socket, *bdev* - block device, *cdev* - character device, *fifo* - FIFO, *dev* - synonymous with "bdev,cdev", *all* - all types (default), i.e. "file,dir,sym,sock,bdev,cdev,fifo". Multiple types must be separated with comma and quoted.<br>**types\_excl** - directory entry types (see <types\_incl>) to NOT list. If some entry type is in both <types\_incl> and <types\_excl>, directory entries of this type are NOT listed.<br>**max\_depth** - maximum depth of subdirectories to traverse. **-1** (default) - unlimited, **0** - no descending into subdirectories.<br>**min\_size** - minimum size (in bytes) for file to be listed. Smaller files will not be listed. [Memory suffixes](/manual/appendix/suffixes#memory_suffixes) can be used.<br>**max\_size** - maximum size (in bytes) for file to be listed. Larger files will not be counted. [Memory suffixes](/manual/appendix/suffixes#memory_suffixes) can be used.<br>**min\_age** - minimum age (in seconds) of directory entry to be listed. More recent entries will not be listed. [Time suffixes](/manual/appendix/suffixes#time_suffixes) can be used.<br>**max\_age** - maximum age (in seconds) of directory entry to be listed. Entries so old and older will not be listed (modification time). [Time suffixes](/manual/appendix/suffixes#time_suffixes) can be used.<br>**regex\_excl\_dir** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the directory to exclude. All content of the directory will be excluded (in contrast to regex\_excl)|Environment variables, e.g. %APP\_HOME%, $HOME and %TEMP% are not supported.<br><br>Pseudo-directories "." and ".." are never listed.<br><br>Symbolic links are never followed for directory traversal.<br><br>On Windows, directory symlinks are skipped and hard links are listed only once.<br><br>Both `regex_incl` and `regex_excl` are being applied to files and directories when calculating entry size, but are ignored when picking subdirectories to traverse (if regex\_incl is “(?i)\^.+\\.zip$” and max\_depth is not set, then all subdirectories will be traversed, but only files of type zip will be listed).<br><br>Execution time is limited by the default timeout value in agent [configuration](/manual/appendix/config/zabbix_agentd) (3 sec). Since large directory traversal may take longer than that, no data will be returned and the item will turn unsupported. Partial list will not be returned.<br><br>When filtering by size, only regular files have meaningful sizes. Under Linux and BSD, directories also have non-zero sizes (a few Kb typically). Devices have zero sizes, e.g. the size of **/dev/sda1** does not reflect the respective partition size. Therefore, when using `<min_size>` and `<max_size>`, it is advisable to specify `<types_incl>` as "*file*", to avoid surprises.<br><br>Examples:<br>⇒ vfs.dir.get\[/dev\] - retrieves device list in /dev (Linux)<br>⇒ vfs.dir.get\["C:\\Users\\ADMINI\~1\\AppData\\Local\\Temp"\] - retrieves file list in temporary directory (Windows)<br><br>Supported since Zabbix 6.0.0.| |vfs.dir.size\[dir,<regex\_incl>,<regex\_excl>,<mode>,<max\_depth>,<regex\_excl\_dir>\]|<|<|<|<| |<|Directory size (in bytes).|Integer|**dir** - absolute path to directory<br>**regex\_incl** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the entity (file, directory, symbolic link) to include; include all if empty (default value)<br>**regex\_excl** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the entity (file, directory, symbolic link) to exclude; don't exclude any if empty (default value)<br>**mode** - possible values:<br>*apparent* (default) - gets apparent file sizes rather than disk usage (acts as `du -sb dir`), *disk* - gets disk usage (acts as `du -s -B1 dir`). Unlike du command, vfs.dir.size item takes hidden files in account when calculating directory size (acts as `du -sb .[^.]* *` within dir).<br>**max\_depth** - maximum depth of subdirectories to traverse. **-1** (default) - unlimited, **0** - no descending into subdirectories.<br>**regex\_excl\_dir** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the directory to exclude. All content of the directory will be excluded (in contrast to regex\_excl)|Only directories with at least read permission for *zabbix* user are calculated.<br><br>On Windows any symlink is skipped and hard links are taken into account only once.<br><br>With large directories or slow drives this item may time out due to the Timeout setting in [agent](/manual/appendix/config/zabbix_agentd) and [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) configuration files. Increase the timeout values as necessary.<br><br>Examples:<br>⇒ vfs.dir.size\[/tmp,log\] - calculates size of all files in /tmp which contain 'log'<br>⇒ vfs.dir.size\[/tmp,log,\^.+\\.old$\] - calculates size of all files in /tmp which contain 'log', excluding files containing '.old'<br><br>The file size limit depends on [large file support](/manual/appendix/items/large_file_support).<br><br>Supported since Zabbix 3.4.0.| |vfs.file.cksum\[file,<mode>\]|<|<|<|<| |<|File checksum, calculated by the UNIX cksum algorithm.|Integer - with `mode` as *crc32*<br><br>String - with `mode` as *md5*, *sha256*|**file** - full path to file<br>**mode** - *crc32* (default), *md5*, *sha256*|Example:<br>=> vfs.file.cksum\[/etc/passwd\]<br><br>Example of returned values (crc32/md5/sha256 respectively):<br>675436101<br>9845acf68b73991eb7fd7ee0ded23c44<br>ae67546e4aac995e5c921042d0cf0f1f7147703aa42bfbfb65404b30f238f2dc<br><br>The file size limit depends on [large file support](/manual/appendix/items/large_file_support).<br><br>The `mode` parameter is supported since Zabbix 6.0.| |vfs.file.contents\[file,<encoding>\]|<|<|<|<| |<|Retrieving contents of a file.|Text|**file** - full path to file<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)|Returns an empty string if the file is empty or contains LF/CR characters only.<br><br>Byte order mark (BOM) is excluded from the output.<br><br>Example:<br>=> vfs.file.contents\[/etc/passwd\]<br><br>This item is limited to files no larger than 64 Kbytes.<br><br>Supported since Zabbix 2.0.| |vfs.file.exists\[file,<types\_incl>,<types\_excl>\]|<|<|<|<| |<|Checks if file exists.|0 - not found<br><br>1 - file of the specified type exists|**file** - full path to file<br>**types\_incl** - list of file types to include, possible values: *file* (regular file, default (if types\_excl is not set)), *dir* (directory), *sym* (symbolic link), *sock* (socket), *bdev* (block device), *cdev* (character device), *fifo* (FIFO), *dev* (synonymous with "bdev,cdev"), *all* (all mentioned types, default if types\_excl is set).<br>**types\_excl** - list of file types to exclude, see types\_incl for possible values (by default no types are excluded)|Multiple types must be separated with a comma and the entire set enclosed in quotes "".<br>On Windows the double quotes have to be backslash '\\' escaped and the whole item key enclosed in double quotes when using the command line utility for calling zabbix\_get.exe or agent2.<br><br>If the same type is in both <types\_incl> and <types\_excl>, files of this type are excluded.<br><br>Examples:<br>=> vfs.file.exists\[/tmp/application.pid\]<br>=> vfs.file.exists\[/tmp/application.pid,"file,dir,sym"\]<br>=> vfs.file.exists\[/tmp/application\_dir,dir\]<br><br>The file size limit depends on [large file support](/manual/appendix/items/large_file_support).<br><br>Note that the item may turn unsupported on Windows if a directory is searched within a non-existing directory, e.g. vfs.file.exists\[C:\\no\\dir,dir\] (where 'no' does not exist).| |vfs.file.get\[file\]|<|<|<|<| |<|Return information about a file.|JSON object|**file** - full path to file|Supported file types on UNIX-like systems: regular file, directory, symbolic link, socket, block device, character device, FIFO<br><br>Supported file types on Windows: regular file, directory, symbolic link<br><br>Example:<br>=> vfs.file.get\[/etc/passwd\] → return a JSON with information about the /etc/passwd file (type, user, permissions, SID, uid etc)<br><br>Supported since Zabbix 6.0.| |vfs.file.md5sum\[file\]|<|<|<|<| |<|MD5 checksum of file.|Character string (MD5 hash of the file)|**file** - full path to file|Example:<br>=> vfs.file.md5sum\[/usr/local/etc/zabbix\_agentd.conf\]<br><br>Example of returned value:<br>b5052decb577e0fffd622d6ddc017e82<br><br>The file size limit (64 MB) for this item was removed in version 1.8.6.<br><br>The file size limit depends on [large file support](/manual/appendix/items/large_file_support).| |vfs.file.owner\[file,<ownertype>,<resulttype>\]|<|<|<|<| |<|Retrieve owner of a file.|Character string|**file** - full path to file<br>**ownertype** - *user* (default) or *group* (Unix only)<br>**resulttype** - *name* (default) or *id*; for id - return uid/gid on Unix, SID on Windows|Example:<br>=> vfs.file.owner\[/tmp/zabbix\_server.log\] → return file owner of /tmp/zabbix\_server.log<br>=> vfs.file.owner\[/tmp/zabbix\_server.log,,id\] → return file owner ID of /tmp/zabbix\_server.log<br><br>Supported since Zabbix 6.0.| |vfs.file.permissions\[file\]|<|<|<|<| |<|Return a 4-digit string containing the octal number with Unix permissions.|String|**file** - full path to the file|Not supported on Windows.<br><br>Example:<br>=> vfs.file.permissions\[/etc/passwd\] → return permissions of /etc/passwd, for example, '0644'<br><br>Supported since Zabbix 6.0.| |vfs.file.regexp\[file,regexp,<encoding>,<start line>,<end line>,<output>\]|<|<|<|<| |<|Find string in a file.|The line containing the matched string, or as specified by the optional `output` parameter|**file** - full path to file<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)<br>**start line** - the number of first line to search (first line of file by default).<br>**end line** - the number of last line to search (last line of file by default).<br>**output** - an optional output formatting template. The **\\0** escape sequence is replaced with the matched part of text (from the first character where match begins until the character where match ends) while an **\\N** (where N=1...9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups).|Only the first matching line is returned.<br>An empty string is returned if no line matched the expression.<br><br>Byte order mark (BOM) is excluded from the output.<br><br>Content extraction using the `output` parameter takes place on the agent.<br><br>The `start line`, `end line` and `output` parameters are supported from version 2.2.<br><br>Examples:<br>=> vfs.file.regexp\[/etc/passwd,zabbix\]<br>=> vfs.file.regexp\[/path/to/some/file,"(\[0-9\]+)$",,3,5,\\1\]<br>=> vfs.file.regexp\[/etc/passwd,"\^zabbix:.:(\[0-9\]+)",,,,\\1\] → getting the ID of user *zabbix*| |vfs.file.regmatch\[file,regexp,<encoding>,<start line>,<end line>\]|<|<|<|<| |<|Find string in a file.|0 - match not found<br><br>1 - found|**file** - full path to file<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)<br>**start line** - the number of first line to search (first line of file by default).<br>**end line** - the number of last line to search (last line of file by default).|Byte order mark (BOM) is ignored.<br><br>The `start line` and `end line` parameters are supported from version 2.2.<br><br>Example:<br>=> vfs.file.regmatch\[/var/log/app.log,error\]| |vfs.file.size\[file,<mode>\]|<|<|<|<| |<|File size (in bytes).|Integer|**file** - full path to file<br>**mode** - possible values:<br>*bytes* (default) or *lines* (empty lines are counted, too)|The file must have read permissions for user *zabbix*.<br><br>Example:<br>=> vfs.file.size\[/var/log/syslog\]<br><br>The file size limit depends on [large file support](/manual/appendix/items/large_file_support).<br><br>The `mode` parameter is supported since Zabbix 6.0.| |vfs.file.time\[file,<mode>\]|<|<|<|<| |<|File time information.|Integer (Unix timestamp)|**file** - full path to the file<br>**mode** - possible values:<br>*modify* (default) - last time of modifying file content,<br>*access* - last time of reading file,<br>*change* - last time of changing file properties|Example:<br>=> vfs.file.time\[/etc/passwd,modify\]<br><br>The file size limit depends on [large file support](/manual/appendix/items/large_file_support).| |vfs.fs.discovery|<|<|<|<| |<|List of mounted filesystems and their types. Used for low-level discovery.|JSON object| |Supported since Zabbix 2.0.<br><br>The {\#FSDRIVETYPE} macro is supported on Windows since Zabbix 3.0.<br><br>The {\#FSLABEL} macro is supported on Windows since Zabbix 6.0.| |vfs.fs.get|<|<|<|<| |<|List of mounted filesystems, their types, disk space and inode statistics. Can be used for low-level discovery.|JSON object| |Supported since Zabbix 4.4.5.<br><br>The {\#FSLABEL} macro is supported on Windows since Zabbix 6.0.| |vfs.fs.inode\[fs,<mode>\]|<|<|<|<| |<|Number or percentage of inodes.|Integer - for number<br><br>Float - for percentage|**fs** - filesystem<br>**mode** - possible values:<br>*total* (default), *free*, *used*, //pfree // (free, percentage), *pused* (used, percentage)|Example:<br>=> vfs.fs.inode\[/,pfree\]| |vfs.fs.size\[fs,<mode>\]|<|<|<|<| |<|Disk space in bytes or in percentage from total.|Integer - for bytes<br><br>Float - for percentage|**fs** - filesystem<br>**mode** - possible values:<br>*total* (default), *free*, *used*, *pfree* (free, percentage), *pused* (used, percentage)|In case of a mounted volume, disk space for local file system is returned.<br><br>Example:<br>=> vfs.fs.size\[/tmp,free\]<br><br>Reserved space of a file system is taken into account and not included when using the *free* mode.| |vm.memory.size\[<mode>\]|<|<|<|<| |<|Memory size in bytes or in percentage from total.|Integer - for bytes<br><br>Float - for percentage|**mode** - possible values:<br>*total* (default), *active*, *anon*, *buffers*, *cached*, *exec*, *file*, *free*, *inactive*, *pinned*, *shared*, *slab*, *wired*, *used*, *pused* (used, percentage), *available*, *pavailable* (available, percentage)<br>See also [platform-specific](/manual/appendix/items/supported_by_platform) support and [additional details](/manual/appendix/items/vm.memory.size_params) for this parameter.|This item accepts three categories of parameters:<br><br>1) *total* - total amount of memory;<br>2) platform-specific memory types: *active*, *anon*, *buffers*, *cached*, *exec*, *file*, *free*, *inactive*, *pinned*, *shared*, *slab*, *wired*;<br>3) user-level estimates on how much memory is used and available: *used*, *pused*, *available*, *pavailable*.| |web.page.get\[host,<path>,<port>\]|<|<|<|<| |<|Get content of web page.|Web page source as text (including headers)|**host** - hostname or URL (as `scheme://host:port/path`, where only *host* is mandatory).<br>Allowed URL schemes: *http*, *https*^**[4](#footnotes)**^. Missing scheme will be treated as *http*. If URL is specified `path` and `port` must be empty. Specifying user name/password when connecting to servers that require authentication, for example: `http://user:password@www.example.com` is only possible with cURL support ^**[4](#footnotes)**^.<br>Punycode is supported in hostnames.<br>**path** - path to HTML document (default is /)<br>**port** - port number (default is 80 for HTTP)|This item turns unsupported if the resource specified in `host` does not exist or is unavailable.<br><br>`host` can be hostname, domain name, IPv4 or IPv6 address. But for IPv6 address Zabbix agent must be compiled with IPv6 support enabled.<br><br>Example:<br>=> web.page.get\[www.example.com,index.php,80\]<br>=> web.page.get\[https://www.example.com\]<br>=> web.page.get\[https://blog.example.com/?s=zabbix\]<br>=> web.page.get\[localhost:80\]<br>=> web.page.get\["\[::1\]/server-status"\]| |web.page.perf\[host,<path>,<port>\]|<|<|<|<| |<|Loading time of full web page (in seconds).|Float|**host** - hostname or URL (as `scheme://host:port/path`, where only *host* is mandatory).<br>Allowed URL schemes: *http*, *https*^**[4](#footnotes)**^. Missing scheme will be treated as *http*. If URL is specified `path` and `port` must be empty. Specifying user name/password when connecting to servers that require authentication, for example: `http://user:password@www.example.com` is only possible with cURL support ^**[4](#footnotes)**^.<br>Punycode is supported in hostnames.<br>**path** - path to HTML document (default is /)<br>**port** - port number (default is 80 for HTTP)|This item turns unsupported if the resource specified in `host` does not exist or is unavailable.<br><br>`host` can be hostname, domain name, IPv4 or IPv6 address. But for IPv6 address Zabbix agent must be compiled with IPv6 support enabled.<br><br>Example:<br>=> web.page.perf\[www.example.com,index.php,80\]<br>=> web.page.perf\[https://www.example.com\]| |web.page.regexp\[host,<path>,<port>,regexp,<length>,<output>\]|<|<|<|<| |<|Find string on a web page.|The matched string, or as specified by the optional `output` parameter|**host** - hostname or URL (as `scheme://host:port/path`, where only *host* is mandatory).<br>Allowed URL schemes: *http*, *https*^**[4](#footnotes)**^. Missing scheme will be treated as *http*. If URL is specified `path` and `port` must be empty. Specifying user name/password when connecting to servers that require authentication, for example: `http://user:password@www.example.com` is only possible with cURL support ^**[4](#footnotes)**^.<br>Punycode is supported in hostnames.<br>**path** - path to HTML document (default is /)<br>**port** - port number (default is 80 for HTTP)<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required pattern<br>**length** - maximum number of characters to return<br>**output** - an optional output formatting template. The **\\0** escape sequence is replaced with the matched part of text (from the first character where match begins until the character where match ends) while an **\\N** (where N=1...9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups).|This item turns unsupported if the resource specified in `host` does not exist or is unavailable.<br><br>`host` can be hostname, domain name, IPv4 or IPv6 address. But for IPv6 address Zabbix agent must be compiled with IPv6 support enabled.<br><br>Content extraction using the `output` parameter takes place on the agent.<br><br>The `output` parameter is supported from version 2.2.<br><br>Example:<br>=> web.page.regexp\[www.example.com,index.php,80,OK,2\]<br>=> web.page.regexp\[https://www.example.com,,,OK,2\]| |zabbix.stats\[<ip>,<port>\]|<|<|<|<| |<|Return a set of Zabbix server or proxy internal metrics remotely.|JSON object|**ip** - IP/DNS/network mask list of servers/proxies to be remotely queried (default is 127.0.0.1)<br>**port** - port of server/proxy to be remotely queried (default is 10051)|Note that the stats request will only be accepted from the addresses listed in the 'StatsAllowedIP' [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) parameter on the target instance.<br><br>A selected set of internal metrics is returned by this item. For details, see [Remote monitoring of Zabbix stats](/manual/appendix/items/remote_stats#exposed_metrics).| |zabbix.stats\[<ip>,<port>,queue,<from>,<to>\]|<|<|<|<| |<|Return number of monitored items in the queue which are delayed on Zabbix server or proxy remotely.|JSON object|**ip** - IP/DNS/network mask list of servers/proxies to be remotely queried (default is 127.0.0.1)<br>**port** - port of server/proxy to be remotely queried (default is 10051)<br>**queue** - constant (to be used as is)<br>**from** - delayed by at least (default is 6 seconds)<br>**to** - delayed by at most (default is infinity)|Note that the stats request will only be accepted from the addresses listed in the 'StatsAllowedIP' [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) parameter on the target instance.|  
pt-br	#### Codificações disponíveis  O parâmetro `encoding` é utilizado para especificar uma codificação para processar as verificações de itens correspondentes, de modo que o dado recebido não seja corrompido. Para uma lista de codificações suportadas  (identificadores de código de página), favor consultar a documentação  relacionada, assim como a documentação para o [libiconv](http://www.gnu.org/software/libiconv/) (projeto GNU)  ou a documentação do Microsoft Windows SDK para "Identificadores de  código de página".  Se não for definido o parâmetro `encoding`, então a codificação UTF-8 (codificação padrão para distribuições Unix/Linux mais recentes, veja as configurações do seu SO) ou ANSI com extensão específica para o ambiente (Windows) é utilizada como padrão.  

en-us	#### Key name  The key name itself has a limited range of allowed characters, which just follow each other. Allowed characters are:      0-9a-zA-Z_-.  Which means:  -   all numbers; -   all lowercase letters; -   all uppercase letters; -   underscore; -   dash; -   dot.  ![](../../../../../assets/en/manual/config/key_name.png)
pt-br	#### Nome da chave  O nome da chave em si possui um intervalo limitado de caracteres permitidos, que simplesmente se seguem. Os caracteres permitidos são:      0-9a-zA-Z_-.  O que significa:  -   todos os números; -   todas as letras; -   todas as letras maiúsculas; -   sublinhado; -   hífen -   ponto.  ![](../../../../../assets/en/manual/config/key_name.png)

en-us	#### Key parameters  An item key can have multiple parameters that are comma separated.  ![](../../../../../assets/en/manual/config/key_parameters.png)  Each key parameter can be either a quoted string, an unquoted string or an array.  ![](../../../../../assets/en/manual/config/item_parameter.png)  The parameter can also be left empty, thus using the default value. In that case, the appropriate number of commas must be added if any further parameters are specified. For example, item key **icmpping\[,,200,,500\]** would specify that the interval between individual pings is 200 milliseconds, timeout - 500 milliseconds, and all other parameters are left at their defaults.  It is possible to include macros in the parameters. Those can be [user macros](/manual/appendix/macros/supported_by_location_user#items-item-prototypes) or some of the built-in macros. To see what particular built-in macros are supported in item key parameters, search the page [Supported macros](/manual/appendix/macros/supported_by_location) for "item key parameters".
pt-br	#### Parâmetros da chave  Uma chave de item pode ter múltiplos parâmetros que são separados por vírgulas..  ![](../../../../../assets/en/manual/config/key_parameters.png)  Cada parâmetro de chave pode ser uma string entre aspas, uma string sem aspas ou um array.  ![](../../../../../assets/en/manual/config/item_parameter.png)  O parâmetro também pode ser deixado vazio, assim utilizando o valor padrão. Nesse caso, o número apropriado de vírgulas deve ser adicionado se quaisquer outros parâmetros forem especificados. Por exemplo, a chave de item **icmpping\[,,200,,500\]** especificaria que o intervalo entre os pings individuais é de 200 milissegundos, o timeout - 500 milissegundos, e todos os outros parâmetros são deixados em seus valores padrão.  É possível incluir macros nos parâmetros. Essas podem ser [user macros](/manual/appendix/macros/supported_by_location_user#items-item-prototypes) ou algumas das macros integradas. Para ver quais macros integradas são suportadas nos parâmetros da chave de item, procure a página [Supported macros](/manual/appendix/macros/supported_by_location) por "parâmetros da chave de item".

en-us	#### Kiosk mode  The kiosk mode in supported frontend pages can be activated using URL parameters. For example, in dashboards:  -   `/zabbix.php?action=dashboard.view&kiosk=1` - activate kiosk mode -   `/zabbix.php?action=dashboard.view&kiosk=0` - activate normal mode
pt-br	#### Modo Kiosk  O modo kiosk em páginas frontend suportadas pode ser ativado usando URL parâmetros. Por exemplo, em painéis:  - `/zabbix.php?action=dashboard.view&kiosk=1` - ativa o modo kiosk - `/zabbix.php?action=dashboard.view&kiosk=0` - ativa o modo normal

en-us	#### Known issues  See [known issues](/manual/installation/known_issues#graphs) for graphs.
pt-br	#### Problemas conhecidos  Consulte [problemas conhecidos](/manual/installation/known_issues#graphs) para obter gráficos.

en-us	#### Kubernetes   - *Kubernetes nodes by HTTP*  - *Kubernetes cluster state by HTTP* - *Kubernetes API server by HTTP* - *Kubernetes Controller manager by HTTP* - *Kubernetes Scheduler by HTTP* - *Kubernetes kubelet by HTTP*  To enable Kubernetes monitoring, you need to use the new tool [Zabbix Helm Chart](https://git.zabbix.com/projects/ZT/repos/kubernetes-helm/browse?at=refs%2Fheads%2Frelease%2F6.0), which installs Zabbix proxy and Zabbix agents in the Kubernetes cluster.  To learn more about configuring templates, see [HTTP template operation](/manual/config/templates_out_of_the_box/http).
pt-br	#### Kubernetes  - *Nós do Kubernetes por HTTP - *Estado do cluster do Kubernetes por HTTP - *Servidor de API do Kubernetes por HTTP - *Gerenciador de controle do Kubernetes por HTTP - *Agendador do Kubernetes por HTTP - *Kubelet do Kubernetes por HTTP  Para ativar o monitoramento do Kubernetes, você precisa usar a nova ferramenta [Zabbix Helm Chart](https://git.zabbix.com/projects/ZT/repos/kubernetes-helm/browse?at=refs%2Fheads%2Frelease%2F6.0), que instala o proxy Zabbix e os agentes Zabbix no cluster do Kubernetes.  Para saber mais sobre a configuração de modelos, consulte [HTTP template operation](/manual/config/templates_out_of_the_box/http).

en-us	#### Legend  The following parameters are supported for configuring *Legend*.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Show legend*|0|legend|0 - Disabled;<br>1 - *(default)* Enabled.| |*Number of rows*|0|legend_lines|Valid values range from 1-5.<br><br>Default: 1.|
pt-br	#### Legenda  Os seguintes parâmetros são suportados para configurar a *Legenda*.  |Parâmetro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|nome|valor| |-----|-|-----|-------------------| |*Mostrar legenda*|0|legend|0 - Desativado;<br>1 - *(padrão)* Ativado.| |*Mostrar linhas*|0|legend_lines|Valores válidos variam entre 1-5.<br><br>Padrão: 1.|

en-us	#### Library in a non-standard location  Zabbix allows you to specify a library located in a non-standard location. In the example below, Zabbix will run `curl-config` from the specified non-standard location and use its output to determine the correct libcurl to use.      $ ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config  This will work if it is the only libcurl installed in the system, but might not if there is another libcurl installed in a standard location (by the package manager, for example). Such is the case when you need a newer version of the library for Zabbix and the older one for other applications.  Therefore, specifying a component in a non-standard location will not always work when the same component also exists in a standard location.  For example, if you use a newer libcurl installed in `/usr/local` with the libcurl package still installed, Zabbix might pick up the wrong one and compilation will fail:      usr/bin/ld: ../../src/libs/zbxhttp/libzbxhttp.a(http.o): in function 'zbx_http_convert_to_utf8':     /tmp/zabbix-master/src/libs/zbxhttp/http.c:957: undefined reference to 'curl_easy_header'     collect2: error: ld returned 1 exit status  Here, the function `curl_easy_header()` is not available in the older `/usr/lib/x86_64-linux-gnu/libcurl.so`, but is available in the newer `/usr/local/lib/libcurl.so`.  The problem lies with the order of linker flags, and one solution is to specify the full path to the library in an LDFLAGS variable:      $ LDFLAGS="-Wl,--no-as-needed /usr/local/lib/libcurl.so" ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config  Note the `-Wl,--no-as-needed` option which might be needed on some systems (see also: default linking options on [Debian-based](https://wiki.debian.org/ToolChain/DSOLinking) systems).
pt-br	#### Biblioteca em um local não padrão  O zabbix permite especificar uma biblioteca localizada em uma local não padrão. No exemplo abaixo, o Zabbix executará  `curl-config` a partir do local não padrão especificado e usará sua saída para determinar a versão correta da libcurl a ser utilizada.      $ ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config   Isso funcionará se for a única instalação da liburl no sistema, mas pode não funcionar se houver outra libcurl instalada em um local padrão (por exemplo, pelo gerenciador de pacotes). Esse é o caso quando você precisa de uma versão mais recente da biblioteca para o Zabbix e a versão antiga para outras aplicações.   Portanto, especificar um componente em um local não padrão nem sempre funcionará quando o mesmo componente também existir em um local padrão.   Por exemplo, se você utilizar uma versão mais recente da libcurl instalada`/usr/local` , o Zabbix pode selecionar a versão errada e a compilação falhar:      usr/bin/ld: ../../src/libs/zbxhttp/libzbxhttp.a(http.o): in function 'zbx_http_convert_to_utf8':     /tmp/zabbix-master/src/libs/zbxhttp/http.c:957: undefined reference to 'curl_easy_header'     collect2: error: ld returned 1 exit status  Aqui,  a função `curl_easy_header()` não está disponível na versão mais antiga`/usr/lib/x86_64-linux-gnu/libcurl.so`, mas está disponível na versão mais recente `/usr/local/lib/libcurl.so`.  O problema está na ordem das flags do linker, e uma solução é especificar o caminho completo para a biblioteca em uma variável LDFLAGS:      $ LDFLAGS="-Wl,--no-as-needed /usr/local/lib/libcurl.so" ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config  Observe que a opção `-Wl,--no-as-needed` pode ser necessária para alguns sistemas (consulte também: opções padrão de linking nos sistemas [Debian-based](https://wiki.debian.org/ToolChain/DSOLinking) ).

en-us	#### Limitations  -   Private keys are stored in plain text in files readable by Zabbix     components during startup -   Pre-shared keys are entered in Zabbix frontend and stored in Zabbix     database in plain text -   Built-in encryption does not protect communications:     -   Between the web server running Zabbix frontend and user web         browser     -   Between Zabbix frontend and Zabbix server -   Currently each encrypted connection opens with a full TLS handshake,     no session caching and tickets are implemented -   Adding encryption increases the time for item checks and actions,     depending on network latency:     -   For example, if packet delay is 100ms then opening a TCP         connection and sending unencrypted request takes around 200ms.         With encryption about 1000 ms are added for establishing the TLS         connection;     -   Timeouts may need to be increased, otherwise some items and         actions running remote scripts on agents may work with         unencrypted connections, but fail with timeout with encrypted. -   Encryption is not supported by [network     discovery](/manual/discovery/network_discovery). Zabbix agent checks     performed by network discovery will be unencrypted and if Zabbix     agent is configured to reject unencrypted connections such checks     will not succeed.
pt-br	#### Limitações  - As chaves privadas são armazenadas em texto simples em arquivos legíveis pelo Zabbix     componentes durante a inicialização - Chaves pré-compartilhadas são inseridas no frontend do Zabbix e armazenadas no Zabbix     banco de dados em texto simples - A criptografia integrada não protege as comunicações:     - Entre o servidor web rodando o frontend Zabbix e a web do usuário         navegador     - Entre o frontend Zabbix e o servidor Zabbix - Atualmente, cada conexão criptografada é aberta com um handshake TLS completo,     nenhum cache de sessão e tickets são implementados - A adição de criptografia aumenta o tempo para verificações e ações de itens,     dependendo da latência da rede:     - Por exemplo, se o atraso do pacote for de 100ms, abrir um TCP         conexão e envio de solicitação não criptografada leva cerca de 200ms.         Com criptografia são adicionados cerca de 1000 ms para estabelecer o TLS         conexão;     - Os tempos limite podem precisar ser aumentados, caso contrário, alguns itens e         ações que executam scripts remotos em agentes podem funcionar com         conexões não criptografadas, mas falham com o tempo limite com criptografado. - A criptografia não é suportada por [network     descoberta](/manual/discovery/network_discovery). Verificações do agente Zabbix     realizada pela descoberta de rede não será criptografada e se o Zabbix     agente está configurado para rejeitar conexões não criptografadas, tais verificações     não terá sucesso.

en-us	#### - Limitations  Support of loadable modules is implemented for the Unix platform only. It means that it does not work for Windows agents.  In some cases a module may need to read module-related configuration parameters from *zabbix\_agentd.conf*. It is not supported currently. If you need your module to use some configuration parameters you should probably implement parsing of a module-specific configuration file.
pt-br	#### - Limitações  O suporte de módulos carregáveis é implementado apenas para a plataforma Unix. Isso significa que não funciona para agentes do Windows.  Em alguns casos, um módulo pode precisar ler a configuração relacionada ao módulo parâmetros de *zabbix\_agentd.conf*. Não é suportado atualmente. Se você precisa que seu módulo use alguns parâmetros de configuração que você deve provavelmente implementa a análise de um arquivo de configuração específico do módulo.

en-us	#### Limiting access to API  Update role with ID "5", deny to call any "create", "update" or "delete" methods.  Request:  ```json {     "jsonrpc": "2.0",     "method": "role.update",     "params": [         {             "roleid": "5",             "rules": {                 "api.access": "1",                 "api.mode": "0",                 "api": ["*.create", "*.update", "*.delete"]             }         }     ],     "auth": "3a57200802b24cda67c4e4010b50c065",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "roleids": [             "5"         ]     },     "id": 1 } ```
pt-br	#### Limitando o acesso à API      Atualize a função com o ID "5", negue chamar qualquer método "criar", "atualizar" ou "excluir".  Request:  ```json {     "jsonrpc": "2.0",     "method": "role.update",     "params": [         {             "roleid": "5",             "rules": {                 "api.access": "1",                 "api.mode": "0",                 "api": ["*.create", "*.update", "*.delete"]             }         }     ],     "auth": "3a57200802b24cda67c4e4010b50c065",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "roleids": [             "5"         ]     },     "id": 1 } ```

en-us	### Limits for JavaScript objects in preprocessing  The following limits for [JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects#additional-javascript-objects) in preprocessing have been introduced:  -   The total size of all messages that can be logged with the `log()` method has been limited to 8 MB per script execution. -   The initialization of multiple `HttpRequest` objects has been limited to 10 per script execution. -   The total length of header fields that can be added to a single `HttpRequest` object with the `addHeader()` method has been limited to 128 Kbytes (special characters and header names included).
pt-br	### Limites para objetos JavaScript no pré-processamento  Os seguintes limites para [JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects#additional-javascript-objects) no pré-processamento foram inseridos:  -   O tamanho total de todas as mensagens que pode ser carregado com o método `log()` foi limitado para 8MB por execução de script.  -  A inicialização de múltiplos objetos  `HttpRequest` foi limitada a 10 por execução de script.  -  O tamanho total do comprimento dos campos de cabeçalho que podem ser adicionados a um único objeto  `HttpRequest` com o método `addHeader()` foi limitado a 128 Kbytes (caracteres especiais e nomes de cabeçalho estão incluídos).

en-us	#### Link a group to templates  Add host group "2" to two templates.  Request:  ```json {     "jsonrpc": "2.0",     "method": "template.massadd",     "params": {         "templates": [             {                 "templateid": "10085"             },             {                 "templateid": "10086"             }         ],         "groups": [             {                 "groupid": "2"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "templateids": [             "10085",             "10086"         ]     },     "id": 1 } ```
pt-br	#### Vincular um grupo a modelos  Adicione o grupo de hosts "2" a dois templates.  Requisição:  ```json {     "jsonrpc": "2.0",     "method": "template.massadd",     "params": {         "templates": [             {                 "templateid": "10085"             },             {                 "templateid": "10086"             }         ],         "groups": [             {                 "groupid": "2"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "templateids": [             "10085",             "10086"         ]     },     "id": 1 } ```

en-us	#### Linking a template  To link a template to the host, do the following:  -   Go to *Configuration → Hosts* -   Click on the required host -   Start typing the template name in the *Templates* field. A list of     matching templates will appear; scroll down to select. -   Alternatively, you may click on *Select* next to the field and     select one or several templates from the list in a popup window -   Click on *Add/Update* in the host attributes form  The host will now have all the entities (items, triggers, graphs, etc) of the template.  ::: noteimportant Linking multiple templates to the same host will fail if in those templates there are items with the same item key. And, as triggers and graphs use items, they cannot be linked to a single host from multiple templates either, if using identical item keys. :::  When entities (items, triggers, graphs etc.) are added from the template:  -   previously existing identical entities on the host are updated as     entities of the template -   entities from the template are added -   any directly linked entities that, prior to template linkage,     existed only on the host remain untouched  In the lists, all entities from the template now are prefixed by the template name, indicating that these belong to the particular template. The template name itself (in gray text) is a link allowing to access the list of those entities on the template level.  If some entity (item, trigger, graph etc.) is not prefixed by the template name, it means that it existed on the host before and was not added by the template.
pt-br	#### Vinculando um modelo  Para vincular um modelo ao host, faça o seguinte:  - Vá para *Configuração → Hosts* - Clique no host desejado - Comece a digitar o nome do modelo no campo *Modelos*. Uma lista de     os modelos correspondentes aparecerão; role para baixo para selecionar. - Alternativamente, você pode clicar em *Selecionar* ao lado do campo e     selecione um ou vários modelos da lista em uma janela pop-up - Clique em *Adicionar/Atualizar* no formulário de atributos do host  O host agora terá todas as entidades (itens, gatilhos, gráficos, etc.) do modelo.  ::: não importante Vincular vários modelos ao mesmo host falhará se nesses modelos houver itens com a mesma chave de item. E, como gatilhos e gráficos usam itens, eles não podem ser vinculados a um único host de vários modelos, se estiver usando itens idênticos chaves. :::  Quando entidades (itens, gatilhos, gráficos etc.) modelo:  - entidades idênticas previamente existentes no host são atualizadas conforme     entidades do modelo - entidades do modelo são adicionadas - quaisquer entidades diretamente vinculadas que, antes da vinculação do modelo,     existia apenas no host permanecem intocados  Nas listas, todas as entidades do modelo agora são prefixadas pelo nome do modelo, indicando que eles pertencem ao modelo específico. O próprio nome do modelo (em texto cinza) é um link que permite acessar o lista dessas entidades no nível do modelo.  Se alguma entidade (item, gatilho, gráfico etc.) nome do modelo, significa que ele existia no host antes e não foi adicionado pelo modelo.

en-us	#### Linking elements  Once you have put some elements on the map, it is time to start linking them. To link two elements you must first select them. With the elements selected, click on *Add* next to Link.  With a link created, the single element form now contains an additional *Links* section. Click on *Edit* to edit link attributes.  ![](../../../../../assets/en/manual/config/visualization/map_links.png){width="600"}  Link attributes:  |Parameter|Description| |---------|-----------| |*Label*|Label that will be rendered on top of the link.<br>Expression [macros](/manual/appendix/macros/supported_by_location) are supported in this field, but only with `avg`, `last`, `min` and `max` functions, with time as parameter (for example, `{?avg(/host/key,1h)}`).| |*Connect to*|The element that the link connects to.| |*Type (OK)*|Default link style:<br>**Line** - single line<br>**Bold line** - bold line<br>**Dot** - dots<br>**Dashed line** - dashed line| |*Color (OK)*|Default link color.| |*[Link indicators](links)*|List of triggers linked to the link. In case a trigger has status PROBLEM, its style is applied to the link.|
pt-br	#### Elementos de ligação  Depois de colocar alguns elementos no mapa, é hora de começar a vincular eles. Para vincular dois elementos, você deve primeiro selecioná-los. Com os elementos selecionado, clique em *Adicionar* ao lado de Link.  Com um link criado, o formulário de elemento único agora contém um seção *Links*. Clique em *Editar* para editar os atributos do link.  ![](../../../../../assets/en/manual/config/visualization/map_links.png){width="600"}  Atributos do link:  |Parâmetro|Descrição| |---------|-----------| |*Rótulo*|Rótulo que será renderizado no topo do link.<br>Expressão [macros](/manual/appendix/macros/supported_by_location) são suportadas neste campo, mas apenas com `avg`, `last`, Funções `min` e `max`, com tempo como parâmetro (por exemplo, `{?avg(/host/key,1h)}`).| |*Connect to*|O elemento ao qual o link se conecta.| |*Digite (OK)*|Estilo de link padrão:<br>**Linha** - linha única<br>**Linha em negrito** - linha em negrito<br>**Ponto** - pontos<br>** Linha tracejada** - linha tracejada| |*Cor (OK)*|Cor padrão do link.| |*[Indicadores de link](links)*|Lista de gatilhos vinculados ao link. Caso uma trigger tenha o status PROBLEM, seu estilo é aplicado ao link.|

en-us	##### Linking pre-defined templates to hosts  As you may have noticed, Zabbix comes with a set of predefined templates for various OS, devices and applications. To get started with monitoring very quickly, you may link the appropriate one of them to a host, but beware that these templates need to be fine-tuned for your environment. Some checks may not be needed, and polling intervals may be way too frequent.  More information about [templates](/manual/config/templates) is available.
pt-br	##### Associando modelos pré-definidos aos hosts  Como você deve ter notado, o Zabbix vem com um conjunto de modelo pré-definidos para vários SOs, dispositivos e aplicações. Para começar com o monitoramento de forma muito rápida, você pode associar o modelo apropriado a um host, mas cuide que estes modelos precisam estar bem ajustados para o seu ambiente. Algumas verificações podem não ser necessárias, e intervalos de sondagem (polling) podem ser frequentes demais.  Mais informações sobre [modelos](/manual/config/templates) estão disponíveis.

en-us	##### Linking templates to several hosts  To update template linkage of many hosts, in *Configuration → Hosts* select some hosts by marking their checkboxes, then click on **[Mass update](/manual/config/hosts/hostupdate)** below the list and then select *Link templates*:  ![](../../../../assets/en/manual/config/mass_link.png)  To link additional templates, start typing the template name in the auto-complete field until a dropdown appears offering the matching templates. Just scroll down to select the template to link.  The *Replace* option will allow to link a new template while unlinking any template that was linked to the hosts before. The *Unlink* option will allow to specify which templates to unlink. The *Clear when unlinking* option will allow to not only unlink any previously linked templates, but also remove all elements inherited from them (items, triggers, etc.).  ::: notetip Zabbix offers a sizable set of predefined templates. You can use these for reference, but beware of using them unchanged in production as they may contain too many items and poll for data too often. If you feel like using them, finetune them to fit you real needs. :::
pt-br	##### Vinculando modelos a vários hosts  Para atualizar a vinculação de modelos de muitos hosts, em *Configuração → Hosts* selecione alguns hosts marcando suas caixas de seleção e clique em **[Mass update](/manual/config/hosts/hostupdate)** abaixo da lista e depois selecione *Modelos de links*:  ![](../../../../assets/en/manual/config/mass_link.png)  Para vincular modelos adicionais, comece a digitar o nome do modelo no campo de preenchimento automático até que uma lista suspensa apareça oferecendo a correspondência modelos. Basta rolar para baixo para selecionar o modelo para vincular.  A opção *Substituir* permitirá vincular um novo modelo ao desvincular qualquer modelo que tenha sido vinculado aos hosts antes. A opção *Desvincular* permitirá especificar quais modelos devem ser desvinculados. O *Limpar quando unlinking* permitirá não apenas desvincular qualquer link anteriormente templates, mas também remover todos os elementos herdados deles (itens, gatilhos, etc).  ::: dica O Zabbix oferece um conjunto considerável de templates predefinidos. Vocês pode usá-los como referência, mas tome cuidado ao usá-los inalterados em produção, pois podem conter muitos itens e pesquisar dados também muitas vezes. Se você sentir vontade de usá-los, ajuste-os para se adequarem a você precisa. :::

en-us	#### Linking template to host  With a template ready, it only remains to add it to a host. For that, go to *Configuration → Hosts*, click on 'New host' to open its property form and find the **Templates** field.  Start typing *New template* in the *Templates* field. The name of template we have created should appear in the dropdown list. Scroll down to select. See that it appears in the *Templates* field.  ![](../../../assets/en/manual/quickstart/link_template.png)  Click *Update* in the form to save the changes. The template is now added to the host, with all entities that it holds.  As you may have guessed, this way it can be applied to any other host as well. Any changes to the items, triggers and other entities at the template level will propagate to the hosts the template is linked to.
pt-br	#### Associando modelo ao host  Com um modelo pronto, resta apenas adicioná-lo a um host. Para isso, vá até *Configuração → Hosts*, clique em 'Novo host' para abrir seu formulário de propriedades e encontre o campo **Modelos**.  Comece digitando *Novo modelo* no campo *Modelos*. O nome do modelo que criamos deve aparecer na lista suspensa. Arraste para baixo para selecionar. Veja que ele aparece no campo *Modelos*.  ![](../../../assets/en/manual/quickstart/link_template.png)  Clique em *Atualizar* no formulário para salvar as mudanças. O modelo está agora adicionado ao host, com todas as entidades que ele contém.  Como você deve ter suposto, desta forma ele pode ser aplicado a qualquer outro host. Quaisquer alterações nos itens, gatilhos e outras entidades no nível do modelo serão propagadas aos hosts aos quais o modelo está associado.

en-us	#### Links available  For each entry the following links are available:  -   Hosts     -   Monitoring         -   Latest data         -   Problems         -   Graphs         -   Host dashboards         -   Web scenarios     -   Configuration         -   Items         -   Triggers         -   Graphs         -   Discovery rules         -   Web scenarios  ```{=html} <!-- --> ``` -   Host groups     -   Monitoring         -   Latest data         -   Problems         -   Web scenarios     -   Configuration         -   Hosts         -   Templates  ```{=html} <!-- --> ``` -   Templates     -   Configuration         -   Items         -   Triggers         -   Graphs         -   Template dashboards         -   Discovery rules         -   Web scenarios
pt-br	#### Links disponíveis  Para cada entrada estão disponíveis os seguintes links:  - Anfitriões     - Monitoramento         - Dados mais recentes         - Problemas         - Gráficos         - Painéis de hospedagem         - Cenários da Web     - Configuração         -   Itens         -   Gatilhos         - Gráficos         - Regras de descoberta         - Cenários da Web  ```{=html} <!-- --> ``` - Grupos de anfitriões     - Monitoramento         - Dados mais recentes         - Problemas         - Cenários da Web     - Configuração         - Anfitriões         -   Modelos  ```{=html} <!-- --> ``` -   Modelos     - Configuração         -   Itens         -   Gatilhos         - Gráficos         - Painéis de modelos         - Regras de descoberta         - Cenários da Web

en-us	#### Link two templates to a template  Link templates "10106" and "10104" to template.  Request:  ```json {     "jsonrpc": "2.0",     "method": "template.massadd",     "params": {         "templates": [             {                 "templateid": "10073"             }         ],         "templates_link": [             {                 "templateid": "10106"             },             {                 "templateid": "10104"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "templateids": [             "10073"         ]     },     "id": 1 } ```
pt-br	#### Vincular dois templates a um template  Vincule os templates "10106" e "10104" ao modelo.  Requisição:  ```json {     "jsonrpc": "2.0",     "method": "template.massadd",     "params": {         "templates": [             {                 "templateid": "10073"             }         ],         "templates_link": [             {                 "templateid": "10106"             },             {                 "templateid": "10104"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "templateids": [             "10073"         ]     },     "id": 1 } ```

en-us	#### Linux kernel threads
pt-br	#### Threads do kernel Linux

en-us	##### Linux  On Linux systems `ps` command can be used together with `watch` command for observing how Zabbix is doing. For example, to run `ps` command 5 times per second to see process activities:      watch -n 0.2 ps -fu zabbix  To show only Zabbix proxy and agent processes:      watch -tn 0.2 'ps -f -C zabbix_proxy -C zabbix_agentd'  To show only history syncer processes:      watch -tn 0.2 'ps -fC zabbix_server | grep history'  The `ps` command produces a wide output (approximately 190 columns) as some activity messages are long. If your terminal has less than 190 columns of text you can try      watch -tn 0.2 'ps -o cmd -C zabbix_server -C zabbix_proxy -C zabbix_agentd'  to display only commandlines without UID, PID, start time etc.  `top` command also can be used for observing Zabbix performance. Pressing 'c' key in `top` shows processes with their commandlines. In our tests on Linux `top` and `atop` correctly displayed changing activities of Zabbix processes, but `htop` was not displaying changing activities.
pt-br	##### Linux  Em sistemas Linux o comando `ps` pode ser usado junto com o comando `watch` para observar como o Zabbix está se saindo. Por exemplo, para executar o comando `ps` 5 vezes por segundo para ver as atividades do processo:      assistir -n 0,2 ps -fu zabbix  Para mostrar apenas os processos de proxy e agente do Zabbix:      watch -tn 0.2 'ps -f -C zabbix_proxy -C zabbix_agentd'  Para mostrar apenas os processos do sincronizador de histórico:      watch -tn 0.2 'ps -fC zabbix_server | história do grep'  O comando `ps` produz uma saída ampla (aproximadamente 190 colunas) como algumas mensagens de atividade são longas. Se o seu terminal tiver menos de 190 colunas de texto que você pode tentar      watch -tn 0.2 'ps -o cmd -C zabbix_server -C zabbix_proxy -C zabbix_agentd'  para exibir apenas linhas de comando sem UID, PID, hora de início etc.  O comando `top` também pode ser usado para observar o desempenho do Zabbix. Pressionar a tecla 'c' em 'top' mostra os processos com suas linhas de comando. Dentro nossos testes no Linux `top` e `atop` exibiram corretamente as alterações atividades dos processos Zabbix, mas `htop` não estava exibindo mudanças Atividades.

en-us	#### Linux  See values supported for 'memtype' parameter on Linux in the table.  |Supported value|Description|Source in /proc/<pid>/status file| |---------------|-----------|---------------------------------------| |vsize ^[1](proc_mem_notes#footnotes)^|Virtual memory size|VmSize| |pmem|Percentage of real memory|(VmRSS/total\_memory) \* 100| |rss|Resident set size|VmRSS| |data|Size of data segment|VmData| |exe|Size of code segment|VmExe| |hwm|Peak resident set size|VmHWM| |lck|Size of locked memory|VmLck| |lib|Size of shared libraries|VmLib| |peak|Peak virtual memory size|VmPeak| |pin|Size of pinned pages|VmPin| |pte|Size of page table entries|VmPTE| |size|Size of process code + data + stack segments|VmExe + VmData + VmStk| |stk|Size of stack segment|VmStk| |swap|Size of swap space used|VmSwap|  Notes for Linux:  1.  Not all 'memtype' values are supported by older Linux kernels. For     example, Linux 2.4 kernels do not support `hwm`, `pin`, `peak`,     `pte` and `swap` values. 2.  We have noticed that self-monitoring of the Zabbix agent active     check process with `proc.mem[...,...,...,...,data]` shows a value     that is 4 kB larger than reported by `VmData` line in the agent's     /proc/<pid>/status file. At the time of self-measurement the     agent's data segment increases by 4 kB and then returns to the     previous size.
pt-br	#### Linux  Consulte os valores suportados para o parâmetro 'memtype' no Linux na tabela.  |Valor suportado|Descrição|Fonte no arquivo /proc/<pid>/status| |---------------|-----------|---------- ------------------| |vsize ^[1](proc_mem_notes#footnotes)^|Tamanho da memória virtual|VmSize| |pmem|Porcentagem de memória real|(VmRSS/total\_memory) \* 100| |rss|Tamanho do conjunto residente|VmRSS| |dados|Tamanho do segmento de dados|VmData| |exe|Tamanho do segmento de código|VmExe| |hwm|Tamanho do conjunto residente de pico|VmHWM| |lck|Tamanho da memória bloqueada|VmLck| |lib|Tamanho das bibliotecas compartilhadas|VmLib| |pico|Tamanho da memória virtual de pico|VmPeak| |pin|Tamanho das páginas fixadas|VmPin| |pte|Tamanho das entradas da tabela de páginas|VmPTE| |size|Tamanho do código do processo + dados + segmentos de pilha|VmExe + VmData + VmStk| |stk|Tamanho do segmento de pilha|VmStk| |swap|Tamanho do espaço de troca usado|VmSwap|  Notas para Linux:  1. Nem todos os valores 'memtype' são suportados por kernels Linux mais antigos. Para     Por exemplo, kernels Linux 2.4 não suportam `hwm`, `pin`, `peak`,     valores `pte` e `swap`. 2. Percebemos que o automonitoramento do agente Zabbix ativo     processo de verificação com `proc.mem[...,...,...,...,data]` mostra um valor     que é 4 kB maior do que o relatado pela linha `VmData` no agente     arquivo /proc/<pid>/status. No momento da auto-medição, o     segmento de dados do agente aumenta em 4 kB e então retorna ao     tamanho anterior.

en-us	##### List of sorting fields available for each type of diagnostic information request  Following statistic fields can be used to sort and limit requested information.  |Diagnostic type|Available fields|[Type](/manual/api/reference_commentary#data_types)| |---------------|----------------|---------------------------------------------------| |historycache|values|integer| |valuecache|values|integer| |^|request.values|integer| |preprocessing|values|integer| |alerting|media.alerts|integer| |^|source.alerts|integer| |lld|values|integer|
pt-br	##### Lista de campos de classificação disponíveis para cada tipo de solicitação de informações de diagnóstico      Os campos estatísticos a seguir podem ser usados ​​para classificar e limitar as informações solicitadas.      |Tipo de diagnóstico|Campos disponíveis|[Tipo](/manual/api/reference_commentary#data_types)| |---------------|----------------|---------------------------------------------------| |historycache|values|integer| |valuecache|values|integer| |^|request.values|integer| |preprocessing|values|integer| |alerting|media.alerts|integer| |^|source.alerts|integer| |lld|values|integer|

en-us	##### List of statistic fields available for each type of diagnostic information request  Following statistic fields can be requested for each type of diagnostic information request property.  |Diagnostic type|Available fields|Description| |---------------|----------------|-----------| |historycache|items|Number of cached items.| |^|values|Number of cached values.| |^|memory|Shared memory statistics (free space, number of used chunks, number of free chunks, max size of free chunk).| |^|memory.data|History data cache shared memory statistics.| |^|memory.index|History index cache shared memory statistics.| |valuecache|items|Number of cached items.| |^|values|Number of cached values.| |^|memory|Shared memory statistics (free space, number of used chunks, number of free chunks, max size of free chunk).| |^|mode|Value cache mode.| |preprocessing|values|Number of queued values.| |^|preproc.values|Number of queued values with preprocessing steps.| |alerting|alerts|Number of queued alerts.| |lld|rules|Number of queued rules.| |^|values|Number of queued values.|
pt-br	##### Lista de campos estatísticos disponíveis para cada tipo de solicitação de informações de diagnóstico      Os campos de estatística a seguir podem ser solicitados para cada tipo de propriedade de solicitação de informações de diagnóstico.      |Tipo de diagnóstico|Campos disponíveis|Descrição| |---------------|----------------|-----------| |historycache|items|Número de itens em cache.| |^|values|Número de valores em cache.| |^|memory|Estatísticas de memória compartilhada (free space, number of used chunks, number of free chunks, max size of free chunk).| |^|memory.data|Estatísticas de memória compartilhada do cache de dados do histórico.| |^|memory.index|Estatísticas de memória compartilhada do cache de índice de histórico.|   |valuecache|items|Número de itens em cache.| |^|values|Número de valores em cache.| |^|memory|Estatísticas de memória compartilhada (free space, number of used chunks, number of free chunks, max size of free chunk).| |^|mode|Modo de cache de valor.| |preprocessing|values|Número de valores enfileirados.| |^|preproc.values|Número de valores enfileirados com etapas de pré-processamento.| |alerting|alerts|Número de alertas na fila.| |lld|rules|Número de regras enfileiradas.| |^|values|Número de valores enfileirados.|

en-us	##### List of waiting items  In this screen, each waiting item is listed.  ![](../../../../../assets/en/manual/web_interface/queue_details.png){width="600"}  Displayed data:  |Column|Description| |------|-----------| |*Scheduled check*|The time when the check was due is displayed.| |*Delayed by*|The length of the delay is displayed.| |*Host*|Host of the item is displayed.| |*Name*|Name of the waiting item is displayed.| |*Proxy*|The proxy name is displayed, if the host is monitored by proxy.|
pt-br	##### Lista de itens em espera  Nesta tela, cada item em espera é listado.  ![](../../../../../assets/en/manual/web_interface/queue_details.png){width="600"}  Dados exibidos:  |Coluna|Descrição| |------|-----------| |*Cheque agendado*|É exibida a hora de vencimento do cheque.| |*Atrasado por*|A duração do atraso é exibida.| |*Host*|Host do item é exibido.| |*Nome*|O nome do item em espera é exibido.| |*Proxy*|O nome do proxy é exibido, se o host for monitorado por proxy.|

en-us	### LLD macro path  The LLD macro path has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**lld\_macro**<br>(required)|string|LLD macro.| |**path**<br>(required)|string|Selector for value which will be assigned to corresponding macro.|
pt-br	### Caminho da macro LLD  O caminho da macro LLD tem as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**lld\_macro**<br>(requerido)|string|Macro LLD.| |**path**<br>(requerido)|string|Seletor para valor que será atribuído à macro correspondente.|

en-us	#### LLD rule filter condition  The LLD rule filter condition object defines a separate check to perform on the value of an LLD macro. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**macro**<br>(required)|string|LLD macro to perform the check on.| |**value**<br>(required)|string|Value to compare with.| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition operator.<br><br>Possible values:<br>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.|  ::: notetip To better understand how to use filters with various types of expressions, see examples on the [discoveryrule.get](get#retrieving_filter_conditions) and [discoveryrule.create](create#using_a_custom_expression_filter) method pages. :::
pt-br	#### Condição do filtro de regra LLD  O objeto de condição de filtro de regra LLD define uma  verificação separada a ser executada no valor de uma  macro LLD. Possui as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**macro**<br>(requerido)|string|Macro LLD para realizar a verificação.| |**value**<br>(requerido)|string|Valor para comparar.| |formulaid|string|ID exclusivo arbitrário que é usado para fazer referência à condição de uma expressão personalizada. Só pode conter letras maiúsculas. O ID deve ser definido pelo usuário ao modificar as condições do filtro, mas será gerado novamente ao solicitá-los posteriormente.| |operator|integer|Operador de condição.<br><br>Valores possíveis:<br>8 - *(padrão)* corresponde à expressão regular;<br>9 - não corresponde à expressão regular;<br>12 - existe;<br>13 - não existe.|  ::: notetip Para entender melhor como usar filtros com vários tipos de  expressões, veja exemplos nas páginas de método [discoveryrule.get](get#retrieving_filter_conditions)  e [discoveryrule.create](create#using_a_custom_expression_filter). :::

en-us	### LLD rule filter  The LLD rule filter object defines a set of conditions that can be used to filter discovered objects. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**conditions**<br>(required)|array|Set of filter conditions to use for filtering results.| |**evaltype**<br>(required)|integer|Filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |eval\_formula|string|*(readonly)* Generated expression that will be used for evaluating filter conditions. The expression contains IDs that reference specific filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.| |formula|string|User-defined expression to be used for evaluating conditions of filters with a custom expression. The expression must contain IDs that reference specific filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the filter conditions: no condition can remain unused or omitted.<br><br>Required for custom expression filters.|
pt-br	### Filtro de regra LLD  O objeto de filtro de regras LLD define um conjunto de condições que podem ser usadas   para filtrar objetos descobertos. Tem as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**conditions**<br>(requerido)|array|Conjunto de condições de filtro a serem usadas para filtrar resultados.| |**evaltype**<br>(requerido)|integer|Método de avaliação da condição do filtro.<br><br>Valores possíveis:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - expressão personalizada.| |eval\_formula|string|*(somente leitura)* Expressão gerada que será usada para avaliar as condições do filtro. A expressão contém IDs que fazem referência a condições de filtro específicas por seu `formulaid`. O valor de `eval_formula` é igual ao valor de `formula` para filtros com uma expressão personalizada.| |formula|string|Expressão definida pelo usuário a ser usada para avaliar condições de filtros com uma expressão personalizada. A expressão deve conter IDs que façam referência a condições de filtro específicas por seu `formulaid`. Os IDs usados ​​na expressão devem corresponder exatamente aos definidos nas condições do filtro: nenhuma condição pode permanecer não utilizada ou omitida.<br><br>Obrigatório para filtros de expressão personalizados.|

en-us	# > LLD rule object  The following objects are directly related to the `discoveryrule` API.
pt-br	# > Regra de objeto LLD  Os objetos a seguir estão diretamente relacionados à API `discoveryrule`.

en-us	#### LLD rule override filter condition  The LLD rule override filter condition object defines a separate check to perform on the value of an LLD macro. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**macro**<br>(required)|string|LLD macro to perform the check on.| |**value**<br>(required)|string|Value to compare with.| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition operator.<br><br>Possible values:<br>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.|
pt-br	#### Condição de filtro de substituição de regra LLD  O objeto de condição de filtro de substituição de regra LLD define uma verificação separada a ser executada no valor de uma macro LLD. Possui as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**macro**<br>(requerido)|string|Macro LLD para realizar a verificação.| |**value**<br>(requerido)|string|Valor para comparar.| |formulaid|string|ID exclusivo arbitrário que é usado para fazer referência à condição de uma expressão personalizada. Só pode conter letras maiúsculas. O ID deve ser definido pelo usuário ao modificar as condições do filtro, mas será gerado novamente ao solicitá-los posteriormente.| |operator|integer|Operador de condição.<br><br>Valores possíveis:<br>8 - *(padrão)* corresponde à expressão regular;<br>9 - não corresponde à expressão regular;<br>12 - existe;<br>13 - corresponde não existe.|

en-us	#### LLD rule override filter  The LLD rule override filter object defines a set of conditions that if they match the discovered object the override is applied. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**evaltype**<br>(required)|integer|Override filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |**conditions**<br>(required)|array|Set of override filter conditions to use for matching the discovered objects.| |eval\_formula|string|*(readonly)* Generated expression that will be used for evaluating override filter conditions. The expression contains IDs that reference specific override filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.| |formula|string|User-defined expression to be used for evaluating conditions of override filters with a custom expression. The expression must contain IDs that reference specific override filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the override filter conditions: no condition can remain unused or omitted.<br><br>Required for custom expression override filters.|
pt-br	#### Filtro de substituição de regra LLD  O objeto de filtro de substituição de regra LLD define um conjunto de condições que, se corresponderem ao objeto descoberto, a substituição será aplicada. Possui as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**evaltype**<br>(requerido)|integer|Substituir o método de avaliação da condição do filtro.<br><br>Valores possíveis:<br>0 - e/ou;<br>1 - e;<br>2 - ou;<br>3 - expressão personalizada.| |**conditions**<br>(requerido)|array|Conjunto de condições de filtro de substituição a serem usadas para corresponder aos objetos descobertos.| |eval\_formula|string|*(somente leitura)* Expressão gerada que será usada para avaliar as condições do filtro de substituição. A expressão contém códigos que fazem referência a condições de filtro de substituição específicas por seu `formulaid`. O valor de `eval_formula` é igual ao valor de `formula` para filtros com uma expressão personalizada.| |formula|string|Expressão definida pelo usuário a ser usada para avaliar condições de filtros de substituição com uma expressão personalizada. A expressão deve conter IDs que façam referência a condições de filtro de substituição específicas por seu `formulaid`. Os IDs usados ​​na expressão devem corresponder exatamente aos definidos nas condições do filtro de substituição: nenhuma condição pode permanecer sem uso ou omitida.<br><br>Obrigatório para filtros de substituição de expressão personalizados.|

en-us	##### LLD rule override operation discover  LLD rule override operation discover status that is set to discovered object. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**discover**<br>(required)|integer|Override the discover status for selected object.<br><br>Possible values:<br>0 - Yes, continue discovering the objects;<br>1 - No, new objects will not be discovered and existing ones will be marked as lost.|
pt-br	##### Descoberta de operação de substituição de regra LLD  O status de descoberta da operação de substituição da regra LLD  é definido como objeto descoberto. Tem as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**discover**<br>(requerido)|integer|Substituir o status de descoberta do objeto selecionado.<br><br>Valores possíveis:<br>0 - Sim, continue descobrindo os objetos;<br>1 - Não, novos objetos não serão descobertos e os existentes serão marcados como perdidos.|

en-us	##### LLD rule override operation history  LLD rule override operation history value that is set to discovered item. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**history**<br>(required)|string|Override the history of item prototype which is a time unit of how long the history data should be stored. Also accepts user macro and LLD macro.|
pt-br	##### Histórico de operação de substituição de regra LLD  Valor do histórico da operação de substituição da regra LLD que está definido como item descoberto. Tem as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**histórico**<br>(required)|string|Substitua o histórico do protótipo do item, que é uma unidade de tempo de quanto tempo os dados do histórico devem ser armazenados. Também aceita macro de usuário e macro LLD.|

en-us	##### LLD rule override operation inventory  LLD rule override operation inventory mode value that is set to discovered host. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**inventory\_mode**<br>(required)|integer|Override the host prototype inventory mode.<br><br>Possible values are:<br>-1 - disabled;<br>0 - *(default)* manual;<br>1 - automatic.|
pt-br	##### Inventário de operação de substituição de regra LLD      A regra LLD substitui o valor do modo de inventário da operação definido como host descoberto. Possui as seguintes propriedades:      |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**inventory\_mode**<br>(required)|integer|Substitua o modo de inventário do protótipo do host.<br><br>Os valores possíveis são:<br>-1 - desativado;<br>0 - *(padrão)* manual;<br>1 - automático.|

en-us	##### LLD rule override operation period  LLD rule override operation period is an update interval value (supports custom intervals) that is set to discovered item. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**delay**<br>(required)|string|Override the update interval of the item prototype. Accepts seconds or a time unit with suffix (30s,1m,2h,1d) as well as flexible and scheduling intervals and user macros or LLD macros. Multiple intervals are separated by a semicolon.|
pt-br	##### Período de operação de substituição da regra LLD  O período de operação de substituição de regra LLD é um valor de intervalo de atualização (suporta intervalos personalizados) que está definido como item descoberto. Tem o seguinte propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**delay**<br>(obrigatório)|string|Substituir o intervalo de atualização do protótipo de item. Aceita segundos ou uma unidade de tempo com sufixo (30s,1m,2h,1d) bem como intervalos flexíveis e agendados e macros de usuário ou macros LLD. Vários intervalos são separados por um ponto e vírgula.|

en-us	##### LLD rule override operation severity  LLD rule override operation severity value that is set to discovered trigger. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**severity**<br>(required)|integer|Override the severity of trigger prototype.<br><br>Possible values are: 0 - *(default)* not classified;<br>1 - information;<br>2 - warning;<br>3 - average;<br>4 - high;<br>5 - disaster.|
pt-br	##### Severidade da operação de substituição da regra LLD  O valor de gravidade da operação de substituição da regra LLD que está definido para o gatilho descoberto. Tem as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**Severidade**<br>(obrigatório)|inteiro|Substituir a gravidade do protótipo do acionador.<br><br>Os valores possíveis são: 0 - *(padrão)* não classificado;<br>1 - informação;<br>2 - atenção;<br>3 - média;<br>4 - alta;<br>5 - desastre.|

en-us	##### LLD rule override operation status  LLD rule override operation status that is set to discovered object. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**status**<br>(required)|integer|Override the status for selected object.<br><br>Possible values:<br>0 - Create enabled;<br>1 - Create disabled.|
pt-br	##### Status da operação de substituição da regra LLD  A regra LLD substitui o status de operação definido como objeto descoberto.  Tem as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**status**<br>(requerido)|integer|Substituir o status do objeto selecionado.<br><br>Valores possíveis:<br>0 - Criar ativado;<br>1 - Criar desativado.|

en-us	##### LLD rule override operation tag  LLD rule override operation tag object contains tag name and value that are set to discovered object. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|New tag name.| |value|string|New tag value.|
pt-br	##### Etiqueta de operação de substituição de regra LLD  O objeto de etiqueta de operação de substituição de regra LLD contém o nome e o valor da etiqueta que são definidos como objeto descoberto. Tem as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**etiqueta**<br>(obrigatório)|string|Novo nome da etiqueta.| |valor|string|Novo valor da etiqueta.|

en-us	##### LLD rule override operation template  LLD rule override operation template object that is linked to discovered host. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**templateid**<br>(required)|string|Override the template of host prototype linked templates.|
pt-br	##### Modelo de operação de substituição de regra LLD  Objeto de modelo de operação de substituição de regra LLD que está vinculado ao host descoberto. Tem as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**Template ID**<br>(obrigatório)|string|Substitua o modelo de modelos vinculados de protótipo de host.|

en-us	#### LLD rule override operation  The LLD rule override operation is combination of conditions and actions to perform on the prototype object. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**operationobject**<br>(required)|integer|Type of discovered object to perform the action.<br><br>Possible values:<br>0 - Item prototype;<br>1 - Trigger prototype;<br>2 - Graph prototype;<br>3 - Host prototype.| |operator|integer|Override condition operator.<br><br>Possible values:<br>0 - *(default)* equals;<br>1 - does not equal;<br>2 - contains;<br>3 - does not contain;<br>8 - matches;<br>9 - does not match.| |value|string|Pattern to match item, trigger, graph or host prototype name depending on selected object.| |opstatus|object|Override operation status object for item, trigger and host prototype objects.| |opdiscover|object|Override operation discover status object (all object types).| |opperiod|object|Override operation period (update interval) object for item prototype object.| |ophistory|object|Override operation history object for item prototype object.| |optrends|object|Override operation trends object for item prototype object.| |opseverity|object|Override operation severity object for trigger prototype object.| |optag|array|Override operation tag object for trigger and host prototype objects.| |optemplate|array|Override operation template object for host prototype object.| |opinventory|object|Override operation inventory object for host prototype object.|
pt-br	#### Operação de substituição de regra LLD      A operação de substituição da regra LLD é uma combinação de condições e ações a serem executadas no objeto protótipo. Possui as seguintes propriedades:      |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**operationobject**<br>(requerido)|integer|Tipo de objeto descoberto para realizar a ação.<br><br>Valores possíveis:<br>0 - Protótipo do item;<br>1 - Protótipo do trigger;<br>2 - Protótipo do gráfico;<br>3 - Protótipo do host.| |operator|integer|Operador de condição de substituição.<br><br>Valores possíveis:<br>0 - *(padrão)* é igual;<br>1 - não é igual;<br>2 - contém;<br>3 - não contém; <br>8 - corresponde;<br>9 - não corresponde.| |value|string|Padrão para corresponder ao nome do item, trigger, gráfico ou protótipo do host, dependendo do objeto selecionado.| |opstatus|object|Substituir objeto de status de operação para objetos de protótipo de item, trigger e host.| |opdiscover|object|Operação de substituição descobrir objeto de status (todos os tipos de objeto).| |opperiod|object|Substituir objeto de período de operação (intervalo de atualização) para objeto de protótipo de item.| |ohistory|object|Substituir objeto de histórico de operação para objeto de protótipo de item.|   |optrends|object|Substituir objeto de tendências de operação para objeto protótipo de item.|   |opseverity|object|Substituir objeto de gravidade de operação para objeto protótipo de trigger.| |optag|array|Substituir objeto de etiqueta de operação para objetos de protótipo de trigger e host.|   |optemplate|array|Substituir objeto de modelo de operação para objeto de protótipo de host.|   |opinventory|object|Substituir objeto de inventário de operação para objeto de protótipo do host.|

en-us	##### LLD rule override operation trends  LLD rule override operation trends value that is set to discovered item. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**trends**<br>(required)|string|Override the trends of item prototype which is a time unit of how long the trends data should be stored. Also accepts user macro and LLD macro.|
pt-br	##### Tendências de operação de substituição de regra LLD  Valor de tendências de operação de substituição de regra LLD que é definido como item descoberto. Tem as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**Tendências**<br>(obrigatório)|string|Substitua as tendências do protótipo do item, que é uma unidade de tempo de quanto tempo os dados de tendências devem ser armazenados. Também aceita macro de usuário e macro LLD.|

en-us	### LLD rule overrides  The LLD rule overrides object defines a set of rules (filters, conditions and operations) that are used to override properties of different prototype objects. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Unique override name.| |**step**<br>(required)|integer|Unique order number of the override.| |stop|integer|Stop processing next overrides if matches.<br><br>Possible values:<br>0 - *(default)* don't stop processing overrides;<br>1 - stop processing overrides if filter matches.| |filter|object|Override filter.| |operations|array|Override operations.|
pt-br	### Substituições de regras LLD  O objeto de substituição de regra LLD define um conjunto de regras (filtros, condições e operações) que são usadas para substituir propriedades de diferentes objetos de protótipo. Possui as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**name**<br>(requerido)|string|Nome de substituição exclusivo.| |**step**<br>(requerido)|integer|Número de pedido exclusivo da substituição.| |stop|integer|Parar de processar as próximas substituições se corresponder.<br><br>Valores possíveis:<br>0 - *(padrão)* não pare de processar substituições;<br>1 - pare de processar substituições se o filtro corresponder.| |filter|object|Substituir filtro.| |operations|array|Substituir operações.|

en-us	# LLD rule  This class is designed to work with low level discovery rules.  Object references:\  -   [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule)  Available methods:\  -   [discoveryrule.copy](/manual/api/reference/discoveryrule/copy) -     copying LLD rules -   [discoveryrule.create](/manual/api/reference/discoveryrule/create) -     creating new LLD rules -   [discoveryrule.delete](/manual/api/reference/discoveryrule/delete) -     deleting LLD rules -   [discoveryrule.get](/manual/api/reference/discoveryrule/get) -     retrieving LLD rules -   [discoveryrule.update](/manual/api/reference/discoveryrule/update) -     updating LLD rules
pt-br	# Regra LLD  Esta classe foi projetada para trabalhar com regras de descoberta de baixo nível.  Referências de objetos:\  -   [Regra LLD](/manual/api/reference/discoveryrule/object#lld_rule)  Métodos disponíveis:\  -   [discoveryrule.copy](/manual/api/reference/discoveryrule/copy) -     copiando regras LLD -   [discoveryrule.create](/manual/api/reference/discoveryrule/create) -     criando novas regras LLD -   [discoveryrule.delete](/manual/api/reference/discoveryrule/delete) -     excluindo regras LLD -   [discoveryrule.get](/manual/api/reference/discoveryrule/get) -     recuperando regras LLD -   [discoveryrule.update](/manual/api/reference/discoveryrule/update) -     atualizando as regras LLD

en-us	 ### Loadable MongoDB plugin  MongoDB [plugin](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md) is no longer part of Zabbix agent 2 and is now available as a loadable plugin instead. List of supported MongoDB versions has been extended to *2.6-5.3*.   Plugin functionality and set of supported [items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb) haven't change. 
pt-br	### Plugin carregável MongoDB   O MongoDB [plugin](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md) não faz mais parte do Zabbix agent 2 e agora está disponível como um plugin carregável. A lista de versões suportadas do MongoDB foram estendidas para *2.6-5.3*.   A funcionalidade e o conjunto de itens [items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb) suportados não foram alterados.

en-us	 ### Loadable MongoDB plugin  MongoDB [plugin](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md) is no longer part of Zabbix agent 2 and is now available as  a loadable plugin instead. List of supported MongoDB versions has been extended to *2.6-5.3*.   Plugin functionality and set of supported [items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb) haven't change.   The MongoDB plugin, along with other loadable plugins which may potentially be added in the future, is stored in the new repository  [zabbix-agent2-plugins](http://repo.zabbix.com/zabbix-agent2-plugins/). The package *zabbix-release* now adds this repository to the user's system.   To continue monitoring MongoDB on the installations from official Zabbix packages, update *zabbix-release* package and install *zabbix-agent2-plugin-mongodb* package.   Sources are available on [CDN](https://cdn.zabbix.com/zabbix-agent2-plugins/sources/mongodb/).
pt-br	### Plugin MongoDB carregável  O plugin MongoDB [plugin](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md) não faz mais parte do Zabbix agente 2 e agora está disponível como um plugin carregável. A lista de versões suportadas do MongoDB foi estendida para *2.6-5.3*.   A funcionalidade do plugin  e o conjunto de itens suportados [items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb)  não mudaram.  O plugin MongoDB, junto com outros plugins carregáveis que podem ser adicionados no futuro, está armazenado em um novo repositório [zabbix-agent2-plugins](http://repo.zabbix.com/zabbix-agent2-plugins/). Agora o pacote *zabbix-release* adiciona esse repositório ao sistema do usuário.   Para continuar monitorando Mongo DB nas instalações a partir dos pacotes Zabbix oficial, atualizar o pacote *zabbix-release* e instalar o pacote *zabbix-agent2-plugin-mongodb*.  Fontes estão disponíveis em [CDN](https://cdn.zabbix.com/zabbix-agent2-plugins/sources/mongodb/).