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	 ### 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	#### 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	#### 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	##### Limitations  There are some limitations associated with the algorithm of creating LLD macro names from MBean property names:  -   attribute names are changed to uppercase -   attribute names are ignored (no LLD macros are generated) if they     consist of unsupported characters for LLD macro names. Supported     characters can be described by the following regular expression:     `A-Z0-9_\.` -   if an attribute is called "obj" or "domain" they will be ignored     because of the overlap with the values of the reserved Zabbix     properties {\#JMXOBJ} and {\#JMXDOMAIN} (supported since Zabbix     3.4.3.)  Please consider this jmx.discovery (with "beans" mode) example. MBean has the following properties defined:      name=test     тип=Type     attributes []=1,2,3     Name=NameOfTheTest     domAin=some  As a result of JMX discovery, the following LLD macros will be generated:  -   {\#JMXDOMAIN} - Zabbix internal, describing the domain of MBean -   {\#JMXOBJ} - Zabbix internal, describing MBean object -   {\#JMXNAME} - created from "name" property  Ignored properties are:  -   тип : its name contains unsupported characters (non-ASCII) -   attributes\[\] : its name contains unsupported characters (square     brackets are not supported) -   Name : it's already defined (name=test) -   domAin : it's a Zabbix reserved name
pt-br	##### Limitações  Existem algumas limitações associadas ao algoritmo de criação de LLD nomes de macro de nomes de propriedade MBean:  - os nomes dos atributos são alterados para maiúsculas - nomes de atributos são ignorados (nenhuma macro LLD é gerada) se eles     consistem em caracteres não suportados para nomes de macro LLD. Compatível     caracteres podem ser descritos pela seguinte expressão regular:     `A-Z0-9_\.` - se um atributo for chamado de "obj" ou "domínio" ele será ignorado     por causa da sobreposição com os valores do Zabbix reservado     propriedades {\#JMXOBJ} e {\#JMXDOMAIN} (suportado desde o Zabbix     3.4.3.)  Por favor, considere este exemplo jmx.discovery (com modo "beans"). MBean tem as seguintes propriedades definidas:      nome=teste     тип=Tipo     atributos []=1,2,3     Nome=NomeDoTeste     domínio=algum  Como resultado da descoberta JMX, as seguintes macros LLD serão gerado:  - {\#JMXDOMAIN} - Zabbix interno, descrevendo o domínio do MBean - {\#JMXOBJ} - Zabbix interno, descrevendo o objeto MBean - {\#JMXNAME} - criado a partir da propriedade "name"  As propriedades ignoradas são:  - тип : seu nome contém caracteres não suportados (não ASCII) - attribute\[\] : seu nome contém caracteres não suportados (quadrado     colchetes não são suportados) - Nome: já está definido (nome=teste) - domAin : é um nome reservado do Zabbix

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/).

en-us	 #### Loadable  ::: notetip Loadable plugins, when launched with:<br> -   *-V --version* - print plugin version and license information;<br> -   *-h --help* - print help information. :::  Click on the plugin name to go to the plugin repository with additional information.  |Plugin name|Description|Supported item keys|Comments| |--|--|--|----| |[Ember+](https://git.zabbix.com/projects/AP/repos/ember-plus/browse?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of Ember+.|ember.get|This plugin is supported since Zabbix 6.0.30. Currently only available to be built from the source (for both Unix and Windows).<br><br>See also [Ember+ plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/ember_plus_plugin#parameters).| |[MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of MongoDB servers and clusters (document-based, distributed database).|mongodb.collection.stats, mongodb.collections.discovery, mongodb.collections.usage, mongodb.connpool.stats,<br>mongodb.db.stats, mongodb.db.discovery, mongodb.jumbo\_chunks.count, mongodb.oplog.stats,<br>mongodb.ping, mongodb.rs.config, mongodb.rs.status, mongodb.server.status,<br>mongodb.sh.discovery, mongodb.version|This plugin is loadable since Zabbix 6.0.6 (built-in previously). Pre-compiled plugin binaries for Windows are available since [Zabbix 6.0.19](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.19/) and are compatible with previous 6.0 versions.<br><br>To configure encrypted connections to the database, specify the TLS parameters in the agent configuration file as [named session](#named_sessions) parameters.<br>Supported in plugin versions 1.2.0, 6.0.13 and newer^[1](#footnotes)^.<br>Currently, TLS parameters cannot be passed as item key parameters.<br><br>See also [MongoDB plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin#parameters).| |[MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of MSSQL database.|mssql.availability.group.get, mssql.custom.query, mssql.db.get, mssql.job.status.get, mssql.last.backup.get, mssql.local.db.get, mssql.mirroring.get, mssql.nonlocal.db.get, mssql.perfcounter.get, mssql.ping, mssql.quorum.get, mssql.quorum.member.get, mssql.replica.get, mssql.version|This plugin is supported since Zabbix 6.0.27. Pre-compiled plugin binaries for Windows are available since [Zabbix 6.0.28](https://cdn.zabbix.com/zabbix/binaries/stable/6.4/6.4.13/) and are compatible with 6.0.27 version.<br><br>To configure encrypted connection to the database, specify the TLS parameters in the agent configuration file as [named session](#named_sessions) or [default](#default-values) parameters. Currently, TLS parameters cannot be passed as item key parameters.<br><br>See also [MSSQL plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin#parameters).| |[PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of PostgreSQL and its forks.|pgsql.autovacuum.count, pgsql.archive, pgsql.bgwriter, pgsql.cache.hit, pgsql.connections,<br> pgsql.custom.query, pgsql.dbstat, pgsql.dbstat.sum, pgsql.db.age, pgsql.db.bloating\_tables, <br> pgsql.db.discovery, pgsql.db.size, pgsql.locks, pgsql.oldest.xid, pgsql.ping, pgsql.queries, <br> pgsql.replication.count, pgsql.replication.process, pgsql.replication.process.discovery, pgsql.replication.recovery\_role, pgsql.replication.status, <br> pgsql.replication\_lag.b, pgsql.replication\_lag.sec, pgsql.uptime, pgsql.version, pgsql.wal.stat |This plugin is loadable since Zabbix 6.0.10 (built-in previously). Pre-compiled plugin binaries for Windows are available since [Zabbix 6.0.19](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.19/) and are compatible with previous 6.0 versions.<br><br>To configure encrypted connections to the database, specify the TLS parameters in the agent configuration file as [named session](#named_sessions) or [default](#default-values) parameters.<br>Currently, TLS parameters cannot be passed as item key parameters.<br><br>See also [PostgreSQL plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/postgresql_plugin#parameters).|  See also: [Building loadable plugins](/manual/config/items/plugins/build).
pt-br	#### Carregável  ::: notetip Plugins carregáveis, quando iniciados com:<br> -   *-V --version* -exibe a versão do plugin e informações de licença;<br> -   *-h --help* - exibe informações de ajuda. :::  Clique no nome do plugin para acessar o repositório do plugin com informações adicionais.  |Nome do Plugin|Descrição|Chaves de item suportadas|Comentários| |--|--|--|----| |[MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitoramento de servidores e clusters MongoDB (banco de dados distribuído baseado em documentos).|mongodb.collection.stats, mongodb.collections.discovery, mongodb.collections.usage, mongodb.connpool.stats,<br>mongodb.db.stats, mongodb.db.discovery, mongodb.jumbo\_chunks.count, mongodb.oplog.stats,<br>mongodb.ping, mongodb.rs.config, mongodb.rs.status, mongodb.server.status,<br>mongodb.sh.discovery, mongodb.version|Este plugin é carregável desde o Zabbix 6.0.6 (built-in previously). (integrado anteriormente). Binários pré-compilados do plugin para Windows estão disponíveis desde o [Zabbix 6.0.19](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.19/) e são compatíveis com versões anteriores do 6.0.<br><br>Para configurar conexões criptografadas com o banco de dados, especifique os parâmetros TLS no arquivo de configuração do agente como parâmetros de [named session](#named_sessions).<br>Suportado nas versões do plugin 1.2.0, 6.0.13 e mais recentes ^[1](#footnotes)^.<br>Atualmente, os parâmetros TLS não podem ser passados como parâmetros de chave de item.<br><br>Consulte também [MongoDB plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin#parameters).| |[MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse?at=refs%2Fheads%2Frelease%2F6.0)|Monitoramento do banco de dados MSSQL.|mssql.availability.group.get, mssql.custom.query, mssql.db.get, mssql.job.status.get, mssql.last.backup.get, mssql.local.db.get, mssql.mirroring.get, mssql.nonlocal.db.get, mssql.perfcounter.get, mssql.ping, mssql.quorum.get, mssql.quorum.member.get, mssql.replica.get, mssql.version|Este plugin é suportado desde o Zabbix 6.0.27. Binários pré-compilados do plugin para Windows estão disponíveis desde o [Zabbix 6.0.28](https://cdn.zabbix.com/zabbix/binaries/stable/6.4/6.4.13/) e são compatíveis com a versão 6.0.27.<br><br>Para configurar uma conexão criptografada com o banco de dados, especifique os parâmetros TLS no arquivo de configuração do agente como parâmetros de [named session](#named_sessions) ou [default](#default-values). Atualmente, os parâmetros TLS não podem ser passados como parâmetros de chave de item.<br><br>Consulte também [MSSQL plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin#parameters).| |[PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitoramento de PostgreSQL e forks.|pgsql.autovacuum.count, pgsql.archive, pgsql.bgwriter, pgsql.cache.hit, pgsql.connections,<br> pgsql.custom.query, pgsql.dbstat, pgsql.dbstat.sum, pgsql.db.age, pgsql.db.bloating\_tables, <br> pgsql.db.discovery, pgsql.db.size, pgsql.locks, pgsql.oldest.xid, pgsql.ping, pgsql.queries, <br> pgsql.replication.count, pgsql.replication.process, pgsql.replication.process.discovery, pgsql.replication.recovery\_role, pgsql.replication.status, <br> pgsql.replication\_lag.b, pgsql.replication\_lag.sec, pgsql.uptime, pgsql.version, pgsql.wal.stat |Este plugin está disponível desde o Zabbix 6.0.10 (integrado anteriormente). Binários pré-compilados do plugin para Windows estão disponíveis desde [Zabbix 6.0.19](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.19/) e são compatíveis com versões anteriores do 6.0.<br><br>Para configurar conexões criptografadas com o banco de dados, especifique os parâmetros TLS no arquivo de configuração do agente como parâmetros de [named session](#named_sessions) ou [default](#default-values).<br>Atualmente, os parâmetros TLS não podem ser passados como parâmetros de chave de item.<br><br>Consulte também [PostgreSQL plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/postgresql_plugin#parameters).|  Consulte também: [Building loadable plugins](/manual/config/items/plugins/build).

en-us	### Loadable plugins  ##### Encrypted MongoDB plugin connection  MongoDB plugin now supports TLS encryption when connecting to MongoDB using named sessions.   Updated plugin (MongoDB plugin 1.2.1) is included into Zabbix official packages starting from Zabbix 6.0.14. Note that MongoDB is a loadable plugin and can be installed separately either from packages or from sources. The plugin will work with any minor version of Zabbix 6.0. For more details see [MongoDB plugin](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin).
pt-br	### Plugins carregáveis   ##### Conexão plugin Encrypted MongoDB  O plugin MongoDB agora oferece suporte à  criptografia TLS ao se conectar ao MongoDB utilizando sessões nomeadas.  O plugin atualizado (Plugin MongoDB 1.2.1) está incluído nos pacotes oficiais do Zabbix a partir da versão Zabbix 6.0.14. Observe que o MongoDB é um plugin carregável e pode ser instalado separadamente a partir dos pacotes ou de fontes. O plugin funcionará com qualquer versão inferior do Zabbix 6.0. Para mais detalhes, ver  [MongoDB plugin](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin).

en-us	### Log entry  The log entry object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |level|integer|Log level.| |ms|string|The time elapsed in milliseconds since the script was run before log entry was added.| |message|string|Log message.|
pt-br	### Entrada de log    O objeto de entrada de log tem as seguintes propriedades.      |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |level|integer|Nível de Log.| |ms|string|O tempo decorrido em milissegundos desde que o script foi executado antes que a entrada de log fosse adicionada.| |message|string|Mensagem de log.|

en-us	 #### Log file monitoring  For `log[]`, `logrt[]`, `log.count[]`, `logrt.count[]` items, regular expression runtime errors are now logged in the Zabbix agent log file.  See [more details](/manual/config/items/itemtypes/log_items#handling-of-regular-expression-compilation-and-runtime-errors).
pt-br	 #### Log file monitoring  #### Monitoramento Log file  Para os itens `log[]`, `logrt[]`, `log.count[]`, `logrt.count[]`,  erros de tempo de execução de expressões regulares agora são registrados no arquivo de log do agente Zabbix. Para mais detalhes, consulte [more details](/manual/config/items/itemtypes/log_items#handling-of-regular-expression-compilation-and-runtime-errors).

en-us	#### Log file monitoring  `log[]` and `logrt[]` items repeatedly reread log file from the beginning if file system is 100% full and the log file is being appended (see [ZBX-10884](https://support.zabbix.com/browse/ZBX-10884) for more information).
pt-br	#### Monitoramento de arquivo de log  Os itens `log[]` e `logrt[]` releem repetidamente o arquivo de log desde o início se o sistema de arquivos estiver 100% ocupado e o arquivo de log  estiver sendo anexado (Para mais informações, consulte [ZBX-10884](https://support.zabbix.com/browse/ZBX-10884).)

en-us	##### Logging  Add the "Log test" entry to the Zabbix server log and receive the item value "1" in return:  -   Create an item with type "Script". -   In the *Script* field, enter:  ```javascript Zabbix.log(3, 'Log test'); return 1; ```
pt-br	 ##### Fazendo logging  Adiconar a entrada "Log test" no servidor Zabbix and   Adicione a entrada "Log test" ao registro do servidor Zabbix e receba o valor do item "1" como retorno:  -   Crie um item com o tipo "Script". -   No campo *Script* field, digite:  ```javascript Zabbix.log(3, 'Log test'); return 1; ```

en-us	#### Logging out  Log out from the API.  Request:  ```json {     "jsonrpc": "2.0",     "method": "user.logout",     "params": [],     "id": 1,     "auth": "16a46baf181ef9602e1687f3110abf8a" } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": true,     "id": 1 } ```
pt-br	#### Log out    Log out da API.  Request:  ```json {     "jsonrpc": "2.0",     "method": "user.logout",     "params": [],     "id": 1,     "auth": "16a46baf181ef9602e1687f3110abf8a" } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": true,     "id": 1 } ```

en-us	### Log history  The log history object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |id|string|ID of the history entry.| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |logeventid|integer|Windows event log entry ID.| |ns|integer|Nanoseconds when the value was received.| |severity|integer|Windows event log entry level.| |source|string|Windows event log entry source.| |timestamp|timestamp|Windows event log entry time.| |value|text|Received value.|
pt-br	### Histórico de registros  O objeto de histórico de log tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |id|string|ID da entrada do histórico.| |clock|timestamp|Horário em que esse valor foi recebido.| |itemid|string|ID do item relacionado.| |logeventid|integer|ID da entrada do log de eventos do Windows.| |ns|inteiro|Nanosegundos quando o valor foi recebido.| |severity|inteiro|Nível de entrada do log de eventos do Windows.| |source|string|Fonte de entrada do log de eventos do Windows.| |timestamp|timestamp|Hora de entrada do log de eventos do Windows.| |valor|texto|Valor recebido.|

en-us	#### Login and systemd  We recommend [creating](/manual/installation/install#create_user_account) a *zabbix* user as system user, that is, without ability to log in. Some users ignore this recommendation and use the same account to log in (e. g. using SSH) to host running Zabbix. This might crash Zabbix daemon on log out. In this case you will get something like the following in Zabbix server log:      zabbix_server [27730]: [file:'selfmon.c',line:375] lock failed: [22] Invalid argument     zabbix_server [27716]: [file:'dbconfig.c',line:5266] lock failed: [22] Invalid argument     zabbix_server [27706]: [file:'log.c',line:238] lock failed: [22] Invalid argument  and in Zabbix agent log:      zabbix_agentd [27796]: [file:'log.c',line:238] lock failed: [22] Invalid argument  This happens because of default systemd setting `RemoveIPC=yes` configured in `/etc/systemd/logind.conf`. When you log out of the system the semaphores created by Zabbix previously are removed which causes the crash.  A quote from systemd documentation:      RemoveIPC=      Controls whether System V and POSIX IPC objects belonging to the user shall be removed when the     user fully logs out. Takes a boolean argument. If enabled, the user may not consume IPC resources     after the last of the user's sessions terminated. This covers System V semaphores, shared memory     and message queues, as well as POSIX shared memory and message queues. Note that IPC objects of the     root user and other system users are excluded from the effect of this setting. Defaults to "yes".  There are 2 solutions to this problem:  1.  (recommended) Stop using *zabbix* account for anything else than     Zabbix processes, create a dedicated account for other things. 2.  (not recommended) Set `RemoveIPC=no` in `/etc/systemd/logind.conf`     and reboot the system. Note that `RemoveIPC` is a system-wide     parameter, changing it will affect the whole system.
pt-br	 #### Login e systemd  Recomendamos [criando](/manual/installation/install#create_user_account) um usuário *zabbix* usuário como usuário do sistema, ou seja, sem capacidade de efetuar login. Alguns usuários ignore esta recomendação e use a mesma conta para fazer login (e. g.usando SSH) para hospedar o Zabbix em execução. Isso pode travar o daemon do Zabbix no log externo. Neste caso, você obterá algo como o seguinte no Zabbix registro do servidor:      zabbix_server [27730]: [file:'selfmon.c',line:375] lock failed: [22] Invalid argument     zabbix_server [27716]: [file:'dbconfig.c',line:5266] lock failed: [22] Invalid argument     zabbix_server [27706]: [file:'log.c',line:238] lock failed: [22] Invalid argument  e no log do agente Zabbix:     zabbix_agentd [27796]: [file:'log.c',line:238] lock failed: [22] Invalid argument  Isso acontece por causa da configuração padrão do systemd `RemoveIPC=yes` configurado em `/etc/systemd/logind.conf`. Ao sair do sistema os semáforos criados pelo Zabbix anteriormente são removidos o que faz com colidam.  Uma citação da documentação do systemd:      RemoveIPC=      Controls whether System V and POSIX IPC objects belonging to the user shall be removed when the     user fully logs out. Takes a boolean argument. If enabled, the user may not consume IPC resources     after the last of the user's sessions terminated. This covers System V semaphores, shared memory     and message queues, as well as POSIX shared memory and message queues. Note that IPC objects of the     root user and other system users are excluded from the effect of this setting. Defaults to "yes".  Existem 2 soluções para este problema: 1.  (recommended) Stop using *zabbix* account for anything else than     Zabbix processes, create a dedicated account for other things. 2.  (não recomendado) definir `RemoveIPC=no` em`/etc/systemd/logind.conf`   e reinicialize o sistema. Observe que `RemoveIPC` é um sistema      parâmetro, alterá-lo afetará todo o sistema.

en-us	#### Login  ![](../../../assets/en/manual/quickstart/login.png){width="350"}  This is the Zabbix welcome screen. Enter the user name **Admin** with password **zabbix** to log in as a [Zabbix superuser](/manual/config/users_and_usergroups/permissions). Access to *Configuration* and *Administration* menus will be granted.
pt-br	#### Autenticação  ![](../../../assets/en/manual/quickstart/login.png){width="350"}  Esta é a tela de boas-vindas do Zabbix. Informe o nome de usuário **Admin** com a senha **zabbix** para se autenticar como um [super usuário do Zabbix](/manual/config/users_and_usergroups/permissions). O acesso aos menus *Configuração* e *Administração* estarão garantidos.

en-us	###      Log level control targets     *process-type*   All processes of specified type (active checks, collector, listener)     *process-type,N*   Process type and number (e.g., listener,3)     *pid*   Process identifier, up to 65535. For larger values specify target as "process-type,N"  ```{=html} <!-- --> ``` **-p**, **--print**   Print known items and exit. For each item either generic defaults are used, or specific defaults for testing are supplied. These defaults are listed in square brackets as item key parameters. Returned values are enclosed in square brackets and prefixed with the type of the returned value, separated by a pipe character. For user parameters type is always **t**, as the agent can not determine all possible return values. Items, displayed as working, are not guaranteed to work from the Zabbix server or zabbix\_get when querying a running agent daemon as permissions or environment may be different. Returned value types are:     d   Number with a decimal part.     m   Not supported. This could be caused by querying an item that only works in the active mode like a log monitoring item or an item that requires multiple collected values. Permission issues or incorrect user parameters could also result in the not supported state.     s   Text. Maximum length not limited.     t   Text. Same as **s**.     u   Unsigned integer.  **-t**, **--test** *item-key*   Test single item and exit. See **--print** for output description.  **-h**, **--help**   Display this help and exit.  **-V**, **--version**   Output version information and exit.  [ ]{#lbAH}
pt-br	###  Metas de controle de nível de log  *process-type* Todos os processos especificados por tipo (Checagens ativas, Coletor, ouvinte)   *process-type,N* Tipo de processo e número(e.g., ouvinte,3)   *pid* Identificador do processo, até 65535. Para valores maiores especifique o destino como "process-type,N"   ```{=html} <!-- --> ``` **-p**,**--print**   Mostra os itens conhecidos e sai. Para cada item, os padrões genéricos são usados, ou padrões específicos para teste são fornecidos. Esses padrões são listados entre colchetes como parâmetros de chave de item. Os valores retornados inseridos entre colchetes e prefixados com o tipo do valor retornado, separados pelo caractere pipe (|) . Para parâmetros do usuário o tipo é sempre **t**, pois o agente não pode determinar todos os valores de retorno possíveis. Os itens, exibidos como funcionando, não são garantidos para funcionar no servidor Zabbix ou Zabbix\_get ao consultar um daemon de  agente em execução. pois as permissões ou o ambiente podem ser diferentes. Os tipos de valores retornados são:   d    Número com uma parte decimal.   m Não suportado. Isso pode ser causado pela consulta de um item que funciona apenas no modo ativo, como um item de monitoramento de log ou um item que requer vários valores coletados. Problemas de permissão ou parâmetros de usuário incorretos também podem resultar no estado de não-suportado.   s Texto, Comprimento máximo não limitado.   t Texto, Igual a **s**.   u Inteiro sem sinal.   **-t**, **--test** *item-key*   Teste um único item e saia. Consulte **--print** para descrição de saída.   **-h**, **--help**  Mostra este manual de ajuda e sai.   **-V**, **--version** Mostra as informações da versão e sai.   [ ]{#lbAH}

en-us	###      Log level control targets     *process-type*   All processes of specified type (alerter, alert manager, configuration syncer, discoverer, escalator, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, lld manager, lld worker, poller, preprocessing manager, preprocessing worker, proxy poller, self-monitoring, snmp trapper, task manager, timer, trapper, unreachable poller, vmware collector)     *process-type,N*   Process type and number (e.g., poller,3)     *pid*   Process identifier, up to 65535. For larger values specify target as "process-type,N"  ```{=html} <!-- --> ```   [ ]{#lbAH}
pt-br	###      Metas de controle de nível de registro     *process-type*   Todos os processos do tipo especificado (alerter, alert manager, configuration syncer, discoverer, escalator, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, lld manager, lld worker, poller, preprocessing manager, preprocessing worker, proxy poller, self-monitoring, snmp trapper, task manager, timer, trapper, unreachable poller, vmware collector)     *process-type,N*   Tipo e número do processo (e.g., poller,3)     *pid*   Identificador de processo, até 65535. Para valores maiores, especifique o destino como  "tipo de processo, N"  ```{=html} <!-- --> ```   [ ]{#lbAH}

en-us	###      Log level control targets     *process-type*   All processes of specified type (configuration syncer, data sender, discoverer, heartbeat sender, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, poller, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector)     *process-type,N*   Process type and number (e.g., poller,3)     *pid*   Process identifier, up to 65535. For larger values specify target as "process-type,N"  ```{=html} <!-- --> ``` **-h**, **--help**   Display this help and exit.  **-V**, **--version**   Output version information and exit.  [ ]{#lbAH}
pt-br	###      Metas de controle de nível de registro     *process-type*   Todos os processos do tipo especificado (configuration syncer, data sender, discoverer, heartbeat sender, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, poller, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector)     *process-type,N*   Tipo e número do processo (por exemplo, poller,3)     *pid*   Identificador de processo, até 65535. Para valores maiores, especifique o destino como "tipo de processo,N"  ```{=html} <!-- --> ``` **-h**, **--help**   Exiba esta ajuda e saia.  **-V**, **--version**   Saída de informações de versão e saída.  [ ]{#lbAH}

en-us	 ###### Log request  A request sent by a plugin to write a log message into the agent log file.  |   |   | |---|---| |direction|plugin → agent| |response|no|  Parameters specific to log requests:  |Name|Type|Comments| |---------|--------|----------| |severity|uint32|The message severity (log level).| |message|string|The message to log.|  *Example:*      {"id":0,"type":1,"severity":3,"message":"message"}
pt-br	###### Request Log   A request enviada por um plugin para escrever a mensagem de log no arquivo de log do agente. |   |   | |---|---| |direction|plugin → agent| |response|no|  Parâmetros específicos para requests log:  |Nome|Tipo|Comentários| |---------|--------|----------| |severity|uint32|A gravidade da mensagem (nível log).| |message|string|A mensagem para o log.|  *Exemplo:*      {"id":0,"type":1,"severity":3,"message":"message"}

en-us	#### Logrotate for Zabbix server and proxy  The logrotate utility is only included into packages for zabbix-agent, zabbix-agent2 and zabbix-web-service, but needs to be installed separately for Zabbix server and proxy. The logrotate dependency has been added to the server and proxy packages for RHEL and SUSE starting from Zabbix 6.4.4rc1.
pt-br	#### Logrotate para servidor e proxy do  Zabbix  O utilitário logrotate está incluído apenas nos pacotes para zabbix-agent, zabbix-agent2 e zabbix-web-service, mas precisa ser instalado separadamente para o servidor e o proxy do Zabbix.  A dependência do logrotate foi adicionada aos pacotes do servidor e do proxy para RHEL e SUSE a partir do Zabbix 6.4.4rc1.

en-us	#### Low-level discovery  Configure low-level discovery rules as well as item, trigger and graph prototypes to monitor dynamic entities.  [LLD rule API](/manual/api/reference/discoveryrule) | [Item prototype API](/manual/api/reference/itemprototype) | [Trigger prototype API](/manual/api/reference/triggerprototype) | [Graph prototype API](/manual/api/reference/graphprototype) | [Host prototype API](/manual/api/reference/hostprototype)
pt-br	#### Descoberta de baixo nível (Low-level discovery)  Configure regras de descoberta de baixo nível, bem como item, gatilho e protótipos de gráfico para monitorar entidades dinâmicas.  [regra LLD API](/manual/api/reference/discoveryrule) | [Protótipo de item API](/manual/api/reference/itemprototype) | [Protótipo de gatilho API](/manual/api/reference/triggerprototype) | [Protótipo de gráfico API](/manual/api/reference/graphprototype) | [Protótipo do host API](/manual/api/reference/hostprototype)

en-us	#### Low-level discovery macros  Even though no low-level discovery macros are created in the returned JSON, these macros can be defined by the user as an additional step, using the [custom LLD macro](/manual/discovery/low_level_discovery#custom_macros) functionality with JSONPath pointing to the discovered values in the returned JSON.  The macros then can be used to create item, trigger, etc prototypes.
pt-br	#### Macros de descoberta de baixo nível  Mesmo que nenhuma macro de descoberta de baixo nível seja criada no retorno JSON, essas macros podem ser definidas pelo usuário como uma etapa adicional, usando o [LDL personalizado macro](/manual/discovery/low_level_discovery#custom_macros) funcionalidade com JSONPath apontando para os valores descobertos no retornou JSON.  As macros podem ser usadas para criar protótipos de itens, gatilhos, etc.

en-us	 #### Macro functions  The range of the `fmtnum` [macro function](/manual/config/macros/macro_functions#supported-macro-functions) is now limited to 0-20.
pt-br	#### Funções macro  O intervalo do `fmtnum` [macro function](/manual/config/macros/macro_functions#supported-macro-functions) agora está limitada a 0-20.

en-us	 ## Macros
pt-br	 ## Macros

en-us	 #### Macros
pt-br	#### Macros

en-us	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).
pt-br	As macros para ações internas contêm o motivo pelo qual um item, uma regra LLD ou um trigger deixou de ser suportado:   - {ITEM.STATE.ERROR} - para notificações internas baseadas em itens;  - {LLDRULE.STATE.ERROR} - para notificações internas baseadas em regras LLD;  - {TRIGGER.STATE.ERROR} - para notificações internas baseadas em triggeres.  Para obter mais detalhes, consulte [Macros Suportadas](/manual/appendix/macros/supported_by_location).

en-us	#### Macro support  The following macros may be used in trigger tags:  -   {ITEM.VALUE}, {ITEM.LASTVALUE}, {HOST.HOST}, {HOST.NAME},     {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} and {HOST.ID} macros     can be used to populate the tag name or tag value -   {INVENTORY.\*}     [macros](/manual/appendix/macros/supported_by_location) can be used     to reference host inventory values from one or several hosts in a     trigger expression -   [User macros](/manual/config/macros/user_macros) and user macro     context is supported for the tag name/value. User macro context may     include low-level discovery macros -   Low-level discovery macros can be used for the tag name/value in     trigger prototypes  The following macros may be used in trigger-based notifications:  -   {EVENT.TAGS} and {EVENT.RECOVERY.TAGS} macros will resolve to a     comma separated list of event tags or recovery event tags -   {EVENT.TAGSJSON} and {EVENT.RECOVERY.TAGSJSON} macros will resolve     to a JSON array containing event tag     [objects](/manual/api/reference/event/object#event_tag) or recovery     event tag objects  The following macros may be used in template, host, item and web scenario tags:  -   {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP},     {HOST.PORT} and {HOST.ID} macros -   {INVENTORY.\*}     [macros](/manual/appendix/macros/supported_by_location) -   [User macros](/manual/config/macros/user_macros) -   Low-level discovery macros can be used in item prototype tags  The following macros may be used in host prototype tags:  -   {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP},     {HOST.PORT} and {HOST.ID} macros -   {INVENTORY.\*}     [macros](/manual/appendix/macros/supported_by_location) -   [User macros](/manual/config/macros/user_macros) -   [Low-level discovery macros](/manual/config/macros/lld_macros) will     be resolved during discovery process and then added to the     discovered host
pt-br	#### Suporte a macros  As seguintes macros podem ser usadas em tags de acionador:  - {ITEM.VALUE}, {ITEM.LASTVALUE}, {HOST.HOST}, {HOST.NAME},     Macros {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} e {HOST.ID}     pode ser usado para preencher o nome da tag ou o valor da tag -   {INVENTÁRIO.\*}     [macros](/manual/appendix/macros/supported_by_location) podem ser usados     para referenciar valores de inventário de host de um ou vários hosts em um     expressão de gatilho - [Macros do usuário](/manual/config/macros/user_macros) e macro do usuário     context é compatível com o nome/valor da tag. O contexto da macro do usuário pode     incluir macros de descoberta de baixo nível - Macros de descoberta de baixo nível podem ser usadas para o nome/valor da tag em     acionar protótipos  As seguintes macros podem ser usadas em notificações baseadas em gatilho:  - As macros {EVENT.TAGS} e {EVENT.RECOVERY.TAGS} serão resolvidas para um     lista separada por vírgulas de tags de evento ou tags de evento de recuperação - As macros {EVENT.TAGSJSON} e {EVENT.RECOVERY.TAGSJSON} serão resolvidas     para uma matriz JSON contendo tag de evento     [objects](/manual/api/reference/event/object#event_tag) ou recuperação     objetos de tag de evento  As seguintes macros podem ser usadas em template, host, item e web tags de cenário:  - {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP},     Macros {HOST.PORT} e {HOST.ID} -   {INVENTÁRIO.\*}     [macros](/manual/appendix/macros/supported_by_location) - [Macros do usuário](/manual/config/macros/user_macros) - Macros de descoberta de baixo nível podem ser usadas em tags de protótipo de item  As seguintes macros podem ser usadas em tags de protótipo de host:  - {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP},     Macros {HOST.PORT} e {HOST.ID} -   {INVENTÁRIO.\*}     [macros](/manual/appendix/macros/supported_by_location) - [Macros do usuário](/manual/config/macros/user_macros) - [Macros de descoberta de baixo nível](/manual/config/macros/lld_macros)     ser resolvido durante o processo de descoberta e, em seguida, adicionado ao     host descoberto

en-us	#### maintenance  Changes:\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`,`maintenance.delete`: added strict validation of the methods parameters.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.get`,`maintenance.update`: dropped support for parameter `timeperiodid` of the timeperiod object.\
pt-br	#### manutenção  Mudanças:\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`,`maintenance.delete`: adicionada validação estrita dos parâmetros dos métodos.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.get`,`maintenance.update`: suporte descartado para parâmetro `timeperiodid` do objeto de período de tempo.\

en-us	#### maintenance  Changes:\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: the parameter `groupids` is now deprecated. Use `groups` instead.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: the parameter `hostids` is now deprecated. Use `hosts` instead.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: changed the type of parameters `groups`, `hosts`, `timeperiods` and `tags` from `array` to `object/array`.\
pt-br	#### manutenção  Mudanças:\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: o parâmetro `groupids` está obsoleto. Em vez disso, use `groups`.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: o parâmetro `hostids` está obsoleto. Em vez disso, use `hosts`.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: mudou o tipo de parâmetros `groups`, `hosts`, `timeperiods` e `tags` de `array` para `object/array`.\

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

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

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

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

en-us	##### Maintenance periods  The maintenance period window is for scheduling time for a recurring or a one-time maintenance. The form is dynamic with available fields changing based on the *Period type* selected.  ![](../../assets/en/manual/maintenance/maintenance_period.png)  |Period type|Description| |-----------|-----------| |*One time only*|Define the date and time, and the length of the maintenance period.| |*Daily*|*Every day(s)* - maintenance frequency: 1 (default) - every day, 2 - every two days, etc.<br>*At (hour:minute)* - time of the day when maintenance starts<br>*Maintenance period length* - for how long the maintenance will be active.| |*Weekly*|*Every week(s)* - maintenance frequency: 1 (default) - every day, 2 - every two days, etc.<br>*Day of week* - on which day the maintenance should take place.<br>*At (hour:minute)* - time of the day when maintenance starts<br>*Maintenance period length* - for how long the maintenance will be active.| |*Monthly*|*Month* - select all months during which the regular maintenance is carried out.<br>*Date*: **Day of month** - Select this option if the maintenance takes place on the same date each month (for example, every 1st day of the month). Then, select the required day in the new field that appears.<br>*Date*: **Day of week** - Select this option if the maintenance takes place only on certain days (for example, every first Monday of the month). Then, in the drop-down select the required week of the month (first, second, third, fourth, or last) and mark the checkboxes for maintenance day(s).<br>*At (hour:minute)* - time of the day when maintenance starts<br>*Maintenance period length* - for how long the maintenance will be active.|  When done, press *Add* to add the maintenance period to the *Periods* block.  Notes:  -   When *Every day/Every week* parameter is greater than 1, the     starting day or week is the day/week that the *Active since* time     falls on. For example:     -   with *Active since* set to January 1st at 12:00 and a one-hour         maintenance set for every two days at 11pm will result in the         first maintenance period starting on January 1st at 11pm, while         the second maintenance period will start on January 3rd at 11pm;     -   with the same *Active since* time and a one-hour maintenance set         for every two days at 1am, the first maintenance period will         start on January 3rd at 1am, while the second maintenance period         will start on January 5th at 1am. -   Daylight Saving Time (**DST**) changes do not affect how long the     maintenance will be. Let's say we have a two-hour maintenance that     usually starts at 1am and finishes at 3am:     -   If after one hour of maintenance (at 2am) a DST change happens         and current time changes from 2:00 to 3:00, the maintenance will         continue for one more hour till 4:00;     -   If after two hours of maintenance (at 3am) a DST change happens         and current time changes from 3:00 to 2:00, the maintenance will         stop because two hours have passed.
pt-br	##### Períodos de manutenção  A janela de período de manutenção serve para planejamento de horário para uma manutenção  recorrente ou pontual. O formulário é dinâmico com os campos disponíveis mudando com base  no *Tipo de período* selecionado.  ![](../../assets/en/manual/maintenance/maintenance_period.png)  |Tipo de período|Descrição| |-----------|-----------| |*Apenas uma vez*|Defina a data e hora, e a duração do período de manutenção.| |*Diário*|*Todo(s os) dia(s)* - frequência de manutenção: 1 (padrão) - todo dia, 2 - a cada dois dias, etc.<br>*Às (hora:minuto)* - momento do dia no qual a manutenção inicia<br>*Duração do período de manutenção* - por quanto tempo a manutenção ficará ativa.| |*Semanal*|*Toda(s as) semana(s)* - frequência de manutenção: 1 (padrão) - todo dia, 2 - a cada dois dias, etc.<br>*Dia da semana* - dia no qual a manutenção deve ocorrer.<br>*Às (hora:minuto)* - momento do dia no qual a manutenção inicia<br>*Duração do período de manutenção* - por quanto tempo a manutenção ficará ativa.| |*Mensal*|*Mês* - selecione todos os meses durante os quais a manutenção regular é executada.<br>*Data*: **Dia do mês** - Selecione esta opção se a manutenção ocorre na mesma data a cada mês (por exemplo, todo 1° dia do mês). Então, selecione o dia requerido no novo campo que aparece.<br>*Data*: **Dia da semana** - Selecione esta opção se a manutenção ocorre apenas em certos dias (por exemplo, toda primeira segunda-feira do mês). Então, na lista suspensa selecione a semana requerida do mês (primeira, segunda, terceira, quarta, ou última) e marque a caixas de seleção para o(s) dia(s) de manutenção.<br>*Às (hora:minuto)* - momento do dia no qual a manutenção inicia<br>*Duração do período de manutenção* - por quanto tempo a manutenção ficará ativa.|  Quando pronto, pressione *Adicionar* para adicionar o período de manutenção  ao bloco de *Períodos*.  Notas:  -   Quando o parâmetro *Todo dia/Toda semana* é maior que 1, o dia ou      semana de início é o dia/semana no qual o horário de *Ativo a partir de*      se encontra. Por exemplo:     -   com *Ativo a partir de* definido para 1 de Janeiro às 12h e uma          manutenção de uma hora para cada dois dias às 23h resultará no         primeiro período de manutenção iniciando em 1 de Janeiro às 23h,          enquanto o segundo período de manutenção iniciará em 3 de Janeiro          às 23h;     -   com a mesma data de *Ativo a partir de* e uma manutenção de uma          hora definida para cada dois dias à 1h, o primeiro período de          manutenção iniciará em 3 de Janeiro à 1h, enquanto o segundo período          de manutenção iniciará em 5 de Janeiro à 1h. -   Mudanças de Horário de Verão (Daylight Saving Time - **DST**) não afetam      quão longa será a manutenção. Digamos que tenhamos uma manutenção de      duas horas que usualmente inicia à 1h e finaliza às 3h:     -   Se após uma hora de manutenção (às 2h) uma alteração de Horário de          Verão ocorrer e o horário atual mudar de 2h para 3h, a manutenção          continuará por mais uma hora até às 4h;     -   Se após duas horas de manutenção (às 3h) uma alteração de Horário de          Verão ocorrer e o horário atual mudar de 3h para 2h, a manutenção          parará porque duas horas se passaram.

en-us	### Maintenance  The maintenance object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |maintenanceid|string|*(readonly)* ID of the maintenance.| |**name**<br>(required)|string|Name of the maintenance.| |**active\_since**<br>(required)|timestamp|Time when the maintenance becomes active.<br><br>The given value will be rounded down to minutes.| |**active\_till**<br>(required)|timestamp|Time when the maintenance stops being active.<br><br>The given value will be rounded down to minutes.| |description|string|Description of the maintenance.| |maintenance\_type|integer|Type of maintenance.<br><br>Possible values:<br>0 - *(default)* with data collection;<br>1 - without data collection.| |tags\_evaltype|integer|Problem tag evaluation method.<br><br>Possible values:<br>0 - *(default)* And/Or;<br>2 - Or.|
pt-br	### Manutenção  O objeto de manutenção tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |maintenanceid|string|*(somente leitura)* ID da manutenção.| |**name**<br>(required)|string|Nome da manutenção.| |**active\_since**<br>(requerido)|timestamp|Hora em que a manutenção se torna ativa.<br><br>O valor fornecido será arredondado para minutos.| |**active\_till**<br>(requerido)|timestamp|Hora em que a manutenção deixa de estar ativa.<br><br>O valor fornecido será arredondado para minutos.| |description|string|Descrição da manutenção.| |maintenance\_type|integer|Tipo de manutenção.<br><br>Valores possíveis:<br>0 - *(padrão)* com coleta de dados;<br>1 - sem coleta de dados.| |tags\_evaltype|integer|Método de avaliação da tag do problema.<br><br>Valores possíveis:<br>0 - *(padrão)* And/Or;<br>2 - Or.|

en-us	# Maintenance  This class is designed to work with maintenances.  Object references:\  -   [Maintenance](/manual/api/reference/maintenance/object#maintenance) -   [Time period](/manual/api/reference/maintenance/object#time_period)  Available methods:\  -   [maintenance.create](/manual/api/reference/maintenance/create) -     creating new maintenances -   [maintenance.delete](/manual/api/reference/maintenance/delete) -     deleting maintenances -   [maintenance.get](/manual/api/reference/maintenance/get) -     retrieving maintenances -   [maintenance.update](/manual/api/reference/maintenance/update) -     updating maintenances
pt-br	# Manutenção  Esta classe é projetada para trabalhar com manutenções.  Referências de objetos:\  -   [Maintenance](/manual/api/reference/maintenance/object#maintenance) -   [Time period](/manual/api/reference/maintenance/object#time_period)  Métodos disponíveis:\  -   [maintenance.create](/manual/api/reference/maintenance/create) -     criando novas manutenções -   [maintenance.delete](/manual/api/reference/maintenance/delete) -     excluindo manutenção -   [maintenance.get](/manual/api/reference/maintenance/get) -     recuperando manutenção -   [maintenance.update](/manual/api/reference/maintenance/update) -     atualização de manutenção

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

en-us	 ### Makefile targets  Loadable plugins provided by Zabbix have simple makefiles with the following targets:  |Target|Description| |--|--------| |make|Build plugin.| |make clean|Delete all files that are normally created by building the plugin.| |make check|Perform self-tests. A real PostgreSQL database is required.| |make style|Check Go code style with 'golangci-lint'.| |make format|Format Go code with 'go fmt'.| |make dist|Create an archive containing the plugin sources and sources of all packages needed to build the plugin and its self-tests.|
pt-br	### Alvos do Makefile   Os plugins carregáveis fornecidos pelo Zabbix possuem 'makefiles' simples com os seguintes alvos:   |Target|Descrição| |--|--------| |make|Construir plugin.| |make limpar|Deletar todos os aquivos que são geralmente criados pela construção de plugin.| |make verificar|Performar testes próprios. É necessário um banco de dados PostgreSQL real.| |make estilo|Verificar código Go style com 'golangci-lint'.| |make formatar|Formatar código Go  com 'go fmt'.| |make distribuição|Criar um arquivo contendo as fontes de plugin e as fontes de todos os pacotes necessários para construir o plugin e seus testes próprios.|

en-us	##### - Mandatory interface  The only mandatory function is **zbx\_module\_api\_version()**:  ``` {.c} int zbx_module_api_version(void); ```  This function should return the API version implemented by this module and in order for the module to be loaded this version must match module API version supported by Zabbix. Version of module API supported by Zabbix is ZBX\_MODULE\_API\_VERSION. So this function should return this constant. Old constant ZBX\_MODULE\_API\_VERSION\_ONE used for this purpose is now defined to equal ZBX\_MODULE\_API\_VERSION to preserve source compatibility, but it's usage is not recommended.
pt-br	##### - Interface obrigatória  A única função obrigatória é **zbx\_module\_api\_version()**:  ``` {.c} int zbx_module_api_version(void); ```  Esta função deve retornar a versão da API implementada por este módulo e para que o módulo seja carregado esta versão deve corresponder ao módulo Versão da API suportada pelo Zabbix. Versão da API do módulo suportada por Zabbix é ZBX\_MODULE\_API\_VERSION. Então esta função deve retornar isso constante. Constante antiga ZBX\_MODULE\_API\_VERSION\_ONE usada para isso O objetivo agora está definido para igualar ZBX\_MODULE\_API\_VERSION para preservar compatibilidade de fonte, mas seu uso não é recomendado.

en-us	##### Manifest preparation  Each module is expected to have a manifest.json file with the following fields in JSON format:  |Parameter|Required|Type|Default|Description| |---------|--------|----|-------|-----------| |manifest\_version|Yes|Double|\-|Manifest version of the module. Currently supported version is **1**.| |id|Yes|String|\-|Module ID. Only one module with given ID can be enabled at the same time.| |name|Yes|String|\-|Module name as displayed in the Administration section.| |version|Yes|String|\-|Module version as displayed in the Administration section.| |namespace|Yes|String|\-|PHP namespace for Module.php and action classes.| |author|No|String|""|Module author as displayed in the Administration section.| |url|No|String|""|Module URL as displayed in the Administration section.| |description|No|String|""|Module description as displayed in the Administration section.| |actions|No|Object|{}|Actions to register with this module. See Actions.| |config|No|Object|{}|Module configuration.|  For reference, please see an example of manifest.json in the [Reference](#reference) section.
pt-br	##### Preparação do manifesto  Espera-se que cada módulo tenha um arquivo manifest.json com o seguinte campos no formato JSON:  |Parâmetro|Requerido|Tipo|Padrão|Descrição| |---------|--------|----|-------|-----------| |manifest\_version|Yes|Double|\-|Versão de manifesto do módulo. A versão atualmente suportada é **1**.| |id|Sim|String|\-|ID do módulo. Apenas um módulo com determinado ID pode ser habilitado ao mesmo tempo.| |name|Yes|String|\-|Nome do módulo conforme exibido na seção Administração.| |versão|Sim|String|\-|Versão do módulo conforme exibido na seção Administração.| |namespace|Yes|String|\-|PHP namespace para Module.php e classes de ação.| |autor|Não|String|""|Autor do módulo conforme exibido na seção Administração.| |url|No|String|""|URL do módulo conforme exibido na seção Administração.| |description|No|String|""|Descrição do módulo conforme exibido na seção Administração.| |actions|No|Object|{}|Ações para registrar com este módulo. Consulte Ações.| |config|No|Object|{}|Configuração do módulo.|  Para referência, veja um exemplo de manifest.json no seção [Reference](#reference).

en-us	##### Manual mode  When [configuring a host](host), in the *Host inventory* tab you can enter such details as the type of device, serial number, location, responsible person, etc - data that will populate inventory information.  If a URL is included in host inventory information and it starts with 'http' or 'https', it will result in a clickable link in the *Inventory* section.  
pt-br	##### Modo manual  Ao [configuring a host](host), na aba *Inventário*, você pode inserir detalhes como o tipo de dispositivo, número de série, localização, pessoa responsável, etc - dados que irão preencher as informações do inventário.  Se uma URL for incluída nas informações de inventário do host e iniciar com 'http' ou 'https', resultará em um link clicável na sessão *Inventário*.

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

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

en-us	#### Map element Host group  The map element Host group object defines one host group element.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupid|string|Host group ID|
pt-br	#### Elemento do mapa - Grupo de Hosts  O objeto do grupo de hosts do elemento do mapa define um elemento do grupo de hosts.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |ID de grupo|string|ID do grupo de hosts|

en-us	#### Map element Host  The map element Host object defines one host element.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|string|Host ID|
pt-br	#### Elemento do mapa - Host  O objeto Host do elemento do mapa define um elemento host.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |hostid|string|ID do Host|

en-us	#### Map element Map  The map element Map object defines one map element.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapid|string|Map ID|
pt-br	#### Elemento do mapa - Mapa  Define um elemento de mapa.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |sysmapid|string|ID do Mapa|

en-us	### Map element  The map element object defines an object displayed on a map. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |selementid|string|*(readonly)* ID of the map element.| |**elements**<br>(required)|array|Element data object. Required for host, host group, trigger and map type elements.| |**elementtype**<br>(required)|integer|Type of map element.<br><br>Possible values:<br>0 - host;<br>1 - map;<br>2 - trigger;<br>3 - host group;<br>4 - image.| |**iconid\_off**<br>(required)|string|ID of the image used to display the element in default state.| |areatype|integer|How separate host group hosts should be displayed.<br><br>Possible values:<br>0 - *(default)* the host group element will take up the whole map;<br>1 - the host group element will have a fixed size.| |elementsubtype|integer|How a host group element should be displayed on a map.<br><br>Possible values:<br>0 - *(default)* display the host group as a single element;<br>1 - display each host in the group separately.| |evaltype|integer|Map element tag filtering condition evaluation method.<br><br>Possible values:<br>0 - *(default)* AND / OR;<br>2 - OR.| |height|integer|Height of the fixed size host group element in pixels.<br><br>Default: 200.| |iconid\_disabled|string|ID of the image used to display disabled map elements. Unused for image elements.| |iconid\_maintenance|string|ID of the image used to display map elements in maintenance. Unused for image elements.| |iconid\_on|string|ID of the image used to display map elements with problems. Unused for image elements.| |label|string|Label of the element.| |label\_location|integer|Location of the map element label.<br><br>Possible values:<br>-1 - *(default)* default location;<br>0 - bottom;<br>1 - left;<br>2 - right;<br>3 - top.| |permission|integer|Type of permission level.<br><br>Possible values:<br>-1 - none;<br>2 - read only;<br>3 - read-write.| |sysmapid|string|*(readonly)* ID of the map that the element belongs to.| |urls|array|Map element URLs.<br><br>The map element URL object is [described in detail below](object#map_element_url).| |use\_iconmap|integer|Whether icon mapping must be used for host elements.<br><br>Possible values:<br>0 - do not use icon mapping;<br>1 - *(default)* use icon mapping.| |viewtype|integer|Host group element placing algorithm.<br><br>Possible values:<br>0 - *(default)* grid.| |width|integer|Width of the fixed size host group element in pixels.<br><br>Default: 200.| |x|integer|X-coordinates of the element in pixels.<br><br>Default: 0.| |y|integer|Y-coordinates of the element in pixels.<br><br>Default: 0.|
pt-br	### Elemento do mapa  O objeto de elemento de mapa define um objeto exibido em um mapa. Tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |selementid|string|*(somente leitura)* (somente leitura) ID do elemento do mapa.| |**elementos**<br>(obrigatório)|array|Objeto de dados do elemento. Necessário para elementos de host, grupo de hosts, acionador e tipo de mapa.| |**tipo de elemento**<br>(obrigatório)|inteiro|Tipo de elemento do mapa.<br><br>Valores possíveis:<br>0 - host;<br>1 - mapa;<br>2 - trigger;<br>3 - grupo de host;<br>4 - imagem.| |**iconid\_off**<br>(obrigatório)|string|ID da imagem usada para exibir o elemento no estado padrão.| |tipo de área|inteiro|Como os hosts do grupo de hosts separados devem ser exibidos.<br><br>Valores possíveis:<br>0 - *(padrão)* o elemento de grupo de host ocupará todo o mapa;<br>1 - o elemento do grupo de hosts terá um tamanho fixo.| |subtipo de elemento|inteiro|Como um elemento de grupo de hosts deve ser exibido em um mapa.<br><br>Valores possíveis:<br>0 - *(padrão)* exibe o grupo de hosts como um único elemento;<br>1 - exibe cada host no grupo separadamente.| |tipo de avaliação|inteiro|Método de avaliação da condição de filtragem da tag do elemento no mapa.<br><br>Valores possíveis:<br>0 - *(padrão)* E / OU;<br>2 - OU.| |altura|inteiro|Altura do elemento do grupo de hosts de tamanho fixo em pixels.<br><br>Padrão: 200.| |iconid\_disabled|string|ID da imagem usada para exibir elementos de mapa desativados. Não utilizado para elementos de imagem.| |iconid\_maintenance|string|ID da imagem usada para exibir os elementos do mapa em manutenção. Não utilizado para elementos de imagem.| |iconid\_on|string|ID da imagem usada para exibir os elementos do mapa com problemas. Não utilizado para elementos de imagem.| |rótulo|string|Rótulo do elemento.| |rótulo\_local|inteiro|Localização do rótulo do elemento do mapa.<br><br>Valores possíveis:<br>-1 - *(padrão)* localização padrão;<br>0 - fundo;<br>1 - esquerda;<br>2 - direita;<br>3 - topo.| |permissão|inteiro|Tipo de nível de permissão.<br><br>Valores possíveis:<br>-1 - nenhum;<br>2 - somente leitura;<br>3 - leitura-escrita.| |sysmapid|string|*(somente leitura)* ID do mapa ao qual o elemento pertence.| |URLs|array|URLs do elemento do mapa.<br><br>O objeto URL do elemento do mapa está [descrito em detalhes abaixo](object#map_element_url).| |use\_iconmap|inteiro|Se o mapeamento de ícones deve ser usado para elementos hospedeiros.<br><br>Valores possíveis:<br>0 - não use mapeamento de ícones;<br>1 - *(padrão)* usa o mapeamento de ícones.| |tipo de visão|inteiro|Algoritmo de posicionamento do elemento do grupo de hosts.<br><br>Valores possíveis:<br>0 - *(padrão)* grade.| |largura|inteiro|Largura do elemento do grupo de hosts de tamanho fixo em pixels.<br><br>Padrão: 200.| |x|inteiro|Coordenadas X do elemento em pixels.<br><br>Padrão: 0.| |y|inteiro|Coordenadas Y do elemento em pixels.<br><br>Padrão: 0.|

en-us	#### Map element Trigger  The map element Trigger object defines one or more trigger elements.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |triggerid|string|Trigger ID|
pt-br	#### Elemento do Mapa - Trigger  Define um ou mais elementos acionadores.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |Trigger ID|string|Trigger ID|

en-us	#### Map element URL  The map element URL object defines a clickable link that will be available for a specific map element. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapelementurlid|string|*(readonly)* ID of the map element URL.| |**name**<br>(required)|string|Link caption.| |**url**<br>(required)|string|Link URL.| |selementid|string|ID of the map element that the URL belongs to.|
pt-br	#### Elemento do Mapa - URL  O objeto de URL do elemento de mapa define um link clicável que estará disponível para um elemento de mapa específico. Tem as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |sysmapelementurlid|string|*(somente leitura)* ID da URL do elemento do mapa.| |**nome**<br>(obrigatório)|string|Legenda do link.| |**url**<br>(obrigatório)|string|URL do Link.| |selementid|string|ID do elemento do mapa ao qual o URL pertence.|

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

en-us	#### Map lines  Create a map line.  Request:  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Map API lines",         "width": 500,         "height": 500,         "lines": [             {                 "x1": 30,                 "y1": 10,                 "x2": 100,                 "y2": 50,                 "line_type": 1,                 "line_width": 10,                 "line_color": "009900"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "11"         ]     },     "id": 1 } ```
pt-br	#### Linhas do mapa      Crie uma linha de mapa..  Request:  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Map API lines",         "width": 500,         "height": 500,         "lines": [             {                 "x1": 30,                 "y1": 10,                 "x2": 100,                 "y2": 50,                 "line_type": 1,                 "line_width": 10,                 "line_color": "009900"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "11"         ]     },     "id": 1 } ```

en-us	### Map lines  The map line object defines a line displayed on a map. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmap\_shapeid|string|*(readonly)* ID of the map shape element.| |x1|integer|X-coordinates of the line point 1 in pixels.<br><br>Default: 0.| |y1|integer|Y-coordinates of the line point 1 in pixels.<br><br>Default: 0.| |x2|integer|X-coordinates of the line point 2 in pixels.<br><br>Default: 200.| |y2|integer|Y-coordinates of the line point 2 in pixels.<br><br>Default: 200.| |line\_type|integer|Type of the lines.<br><br>Possible values:<br>0 - none;<br>1 - `—————`;<br>2 - `·····`;<br>3 - `- - -`.<br><br>Default: 0.| |line\_width|integer|Width of the lines in pixels.<br><br>Default: 0.| |line\_color|string|Line color.<br><br>Default: '000000'.| |zindex|integer|Value used to order all shapes and lines (z-index).<br><br>Default: 0.|
pt-br	### Linhas do mapa  O objeto de linha do mapa define uma linha exibida em um mapa. Tem as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |sysmap\_shapeid|string|*(somente leitura)* ID do elemento de forma do mapa.| |x1|inteiro|Coordenadas X do ponto de linha 1 em pixels.<br><br>Padrão: 0.| |y1|inteiro|Coordenadas Y do ponto de linha 1 em pixels.<br><br>Padrão: 0.| |x2|inteiro|Coordenadas X do ponto de linha 2 em pixels.<br><br>Padrão: 200.| |y2|inteiro|Coordenadas Y do ponto de linha 2 em pixels.<br><br>Padrão: 200.| |tipo de linha|inteiro|Tipo das linhas.<br><br>Valores possíveis:<br>0 - nenhum;<br>1 - `—————`;<br>2 - `·····`;<br>3 - `- - -`.<br><br>Padrão: 0.| |espessura da linha|inteiro|Largura das linhas em pixels.<br><br>Padrão: 0.| |cor da linha|string|Cor da linha.<br><br>Padrão: '000000'.| |zindex|inteiro|Valor usado para ordenar todas as formas e linhas (z-index).<br><br>Padrão: 0.|

en-us	### Map link  The map link object defines a link between two map elements. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |linkid|string|*(readonly)* ID of the map link.| |**selementid1**<br>(required)|string|ID of the first map element linked on one end.| |**selementid2**<br>(required)|string|ID of the first map element linked on the other end.| |color|string|Line color as a hexadecimal color code.<br><br>Default: `000000`.| |drawtype|integer|Link line draw style.<br><br>Possible values:<br>0 - *(default)* line;<br>2 - bold line;<br>3 - dotted line;<br>4 - dashed line.| |label|string|Link label.| |linktriggers|array|Map link triggers to use as link status indicators.<br><br>The map link trigger object is [described in detail below](object#map_link_trigger).| |permission|integer|Type of permission level.<br><br>Possible values:<br>-1 - none;<br>2 - read only;<br>3 - read-write.| |sysmapid|string|ID of the map the link belongs to.|
pt-br	### Link do mapa  O objeto de link de mapa define um link entre dois elementos de mapa. Tem as  seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |Link ID|string|*(somente leitura)* ID do link do mapa.| |**selementid1**<br>(obrigatório)|string|ID do primeiro elemento do mapa vinculado em uma extremidade.| |**selementid2**<br>(obrigatório)|string|ID do primeiro elemento do mapa vinculado na outra extremidade.| |cor|string|Cor da linha como um código de cor hexadecimal.<br><br>Padrão: `000000`.| |tipo de desenho|inteiro|Estilo de desenho de linha de link.<br><br>Valores possíveis:<br>0 - *(padrão)* linha;<br>2 - linha em negrito;<br>3 - linha pontilhada;<br>4 - linha tracejada.| |rótulo|string|Rótulo de link.| |acionadores de triggers|array|Mapeia acionadores de link para usar como indicadores de status de link.<br><br>O objeto acionador do link do mapa é [descrito em detalhes abaixo](object#map_link_trigger).| |permissão|inteiro|Tipo de nível de permissão.<br><br>Valores possíveis:<br>-1 - nenhum;<br>2 - somente leitura;<br>3 - leitura-escrita.| |sysmapid|string|ID do mapa ao qual o link pertence.|

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

en-us	##### Mapping LLD macros  Next you have to go to the LLD macros tab and make the following mappings:      {#VOLUME}=$.labels['volume']     {#METRIC}=$['name']     {#HELP}=$['help']
pt-br	##### Mapeamento de macros LLD  Em seguida, você deve ir para a guia de macros LLD e fazer o seguinte mapeamentos:      {#VOLUME}=$.labels['volume']     {#METRIC}=$['name']     {#HELP}=$['help']

en-us	#### Maps  Configure maps to create detailed dynamic representations of your IT infrastructure.  [Map API](/manual/api/reference/map)
pt-br	#### Mapas  Configure mapas para criar representações dinâmicas detalhadas de sua infraestrutura de TI.  [Mapa API](/manual/api/reference/map)

en-us	#### Map shapes  Create a map with map name title.  Request:  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Host map",         "width": 600,         "height": 600,         "shapes": [             {                 "type": 0,                 "x": 0,                 "y": 0,                 "width": 600,                 "height": 11,                 "text": "{MAP.NAME}"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "10"         ]     },     "id": 1 } ```
pt-br	#### Formas do mapa  Criar um mapa com o título do nome do mapa.  Request:  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Host map",         "width": 600,         "height": 600,         "shapes": [             {                 "type": 0,                 "x": 0,                 "y": 0,                 "width": 600,                 "height": 11,                 "text": "{MAP.NAME}"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "10"         ]     },     "id": 1 } ```

en-us	### Map shapes  The map shape object defines a geometric shape (with or without text) displayed on a map. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmap\_shapeid|string|*(readonly)* ID of the map shape element.| |**type** (required)|integer|Type of map shape element.<br><br>Possible values:<br>0 - rectangle;<br>1 - ellipse.<br><br>Property is required when new shapes are created.| |x|integer|X-coordinates of the shape in pixels.<br><br>Default: 0.| |y|integer|Y-coordinates of the shape in pixels.<br><br>Default: 0.| |width|integer|Width of the shape in pixels.<br><br>Default: 200.| |height|integer|Height of the shape in pixels.<br><br>Default: 200.| |text|string|Text of the shape.| |font|integer|Font of the text within shape.<br><br>Possible values:<br>0 - Georgia, serif<br>1 - “Palatino Linotype”, “Book Antiqua”, Palatino, serif<br>2 - “Times New Roman”, Times, serif<br>3 - Arial, Helvetica, sans-serif<br>4 - “Arial Black”, Gadget, sans-serif<br>5 - “Comic Sans MS”, cursive, sans-serif<br>6 - Impact, Charcoal, sans-serif<br>7 - “Lucida Sans Unicode”, “Lucida Grande”, sans-serif<br>8 - Tahoma, Geneva, sans-serif<br>9 - “Trebuchet MS”, Helvetica, sans-serif<br>10 - Verdana, Geneva, sans-serif<br>11 - “Courier New”, Courier, monospace<br>12 - “Lucida Console”, Monaco, monospace<br><br>Default: 9.| |font\_size|integer|Font size in pixels.<br><br>Default: 11.| |font\_color|string|Font color.<br><br>Default: '000000'.| |text\_halign|integer|Horizontal alignment of text.<br><br>Possible values:<br>0 - center;<br>1 - left;<br>2 - right.<br><br>Default: 0.| |text\_valign|integer|Vertical alignment of text.<br><br>Possible values:<br>0 - middle;<br>1 - top;<br>2 - bottom.<br><br>Default: 0.| |border\_type|integer|Type of the border.<br><br>Possible values:<br>0 - none;<br>1 - `—————`;<br>2 - `·····`;<br>3 - `- - -`.<br><br>Default: 0.| |border\_width|integer|Width of the border in pixels.<br><br>Default: 0.| |border\_color|string|Border color.<br><br>Default: '000000'.| |background\_color|string|Background color (fill color).<br><br>Default: `(empty)`.| |zindex|integer|Value used to order all shapes and lines (z-index).<br><br>Default: 0.|
pt-br	### Formas de mapa  O objeto de forma de mapa define uma forma geométrica (com ou sem texto) exibida em um mapa. Tem as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |sysmap\_shapeid|string|*(somente leitura)* ID do elemento de forma do mapa.| |**tipo** (obrigatório)|inteiro|Tipo de elemento de forma de mapa.<br><br>Valores possíveis:<br>0 - retângulo;<br>1 - elipse.<br><br>A propriedade é necessária quando novas formas são criadas.| |x|inteiro|X-Coordenadas X da forma em pixels.<br><br>Padrão: 0.| |y|inteiro|Y-Coordenadas Y da forma em pixels.<br><br>Padrão: 0.| |largura|inteiro|Largura da forma em pixels.<br><br>Padrão: 200.| |altura|inteiro|Altura da forma em pixels.<br><br>Padrão: 200.| |texto|string|Text da forma.| |fonte|inteiro|Fonte do texto dentro da forma.<br><br>Valores possíveis:<br>0 - Georgia, serif<br>1 - “Palatino Linotype”, “Book Antiqua”, Palatino, serif<br>2 - “Times New Roman”, Times, serif<br>3 - Arial, Helvetica, sans-serif<br>4 - “Arial Black”, Gadget, sans-serif<br>5 - “Comic Sans MS”, cursive, sans-serif<br>6 - Impact, Charcoal, sans-serif<br>7 - “Lucida Sans Unicode”, “Lucida Grande”, sans-serif<br>8 - Tahoma, Geneva, sans-serif<br>9 - “Trebuchet MS”, Helvetica, sans-serif<br>10 - Verdana, Geneva, sans-serif<br>11 - “Courier New”, Courier, monospace<br>12 - “Lucida Console”, Monaco, monospace<br><br>Padrão: 9.| |tamanho da fonte|inteiro|Tamanho da fonte em pixels.<br><br>Padrão: 11.| |cor da fonte|string|Cor da fonte.<br><br>Padrão: '000000'.| |alinhamento horizontal do texto|inteiro|Alinhamento horizontal do texto.<br><br>Valores possíveis:<br>0 - centro;<br>1 - esquerda;<br>2 - direita.<br><br>Padrão: 0.| |alinhamento vertical do texto|inteiro|Alinhamento vertical do texto.<br><br>Valores possíveis:<br>0 - meio;<br>1 - topo;<br>2 - inferior.<br><br>Padrão: 0.| |tipo de borda|inteiro|Tipo de borda.<br><br>Valores possíveis:<br>0 - nenhum;<br>1 - `—————`;<br>2 - `·····`;<br>3 - `- - -`.<br><br>Padrão: 0.| |largura da borda|inteiro|Largura da borda em pixels.<br><br>Padrão: 0.| |cor da borda|string|Cor da borda.<br><br>Padrão: '000000'.| |cor de fundo|string|Cor de fundo (cor de preenchimento).<br><br>Padrão: `(vazio)`.| |zindex|inteiro|Valor usado para ordenar todas as formas e linhas (z-index).<br><br>Padrão: 0.|

en-us	#### Map sharing  Create a map with two types of sharing (user and user group).  Request:  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Map sharing",         "width": 600,         "height": 600,         "users": [             {                 "userid": "4",                 "permission": "3"             }         ],         "userGroups": [             {                 "usrgrpid": "7",                 "permission": "2"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "9"         ]     },     "id": 1 } ```
pt-br	#### Compartilhamento de mapa  Crie um mapa com dois tipos de compartilhamento (usuário e grupo de usuários).  Request:  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Map sharing",         "width": 600,         "height": 600,         "users": [             {                 "userid": "4",                 "permission": "3"             }         ],         "userGroups": [             {                 "usrgrpid": "7",                 "permission": "2"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "9"         ]     },     "id": 1 } ```

en-us	### Map  The map object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapid|string|*(readonly)* ID of the map.| |**height**<br>(required)|integer|Height of the map in pixels.| |**name**<br>(required)|string|Name of the map.| |**width**<br>(required)|integer|Width of the map in pixels.| |backgroundid|string|ID of the image used as the background for the map.| |expand\_macros|integer|Whether to expand macros in labels when configuring the map.<br><br>Possible values:<br>0 - *(default)* do not expand macros;<br>1 - expand macros.| |expandproblem|integer|Whether the problem trigger will be displayed for elements with a single problem.<br><br>Possible values:<br>0 - always display the number of problems;<br>1 - *(default)* display the problem trigger if there's only one problem.| |grid\_align|integer|Whether to enable grid aligning.<br><br>Possible values:<br>0 - disable grid aligning;<br>1 - *(default)* enable grid aligning.| |grid\_show|integer|Whether to show the grid on the map.<br><br>Possible values:<br>0 - do not show the grid;<br>1 - *(default)* show the grid.| |grid\_size|integer|Size of the map grid in pixels.<br><br>Supported values: 20, 40, 50, 75 and 100.<br><br>Default: 50.| |highlight|integer|Whether icon highlighting is enabled.<br><br>Possible values:<br>0 - highlighting disabled;<br>1 - *(default)* highlighting enabled.| |iconmapid|string|ID of the icon map used on the map.| |label\_format|integer|Whether to enable advanced labels.<br><br>Possible values:<br>0 - *(default)* disable advanced labels;<br>1 - enable advanced labels.| |label\_location|integer|Location of the map element label.<br><br>Possible values:<br>0 - *(default)* bottom;<br>1 - left;<br>2 - right;<br>3 - top.| |label\_string\_host|string|Custom label for host elements.<br><br>Required for maps with custom host label type.| |label\_string\_hostgroup|string|Custom label for host group elements.<br><br>Required for maps with custom host group label type.| |label\_string\_image|string|Custom label for image elements.<br><br>Required for maps with custom image label type.| |label\_string\_map|string|Custom label for map elements.<br><br>Required for maps with custom map label type.| |label\_string\_trigger|string|Custom label for trigger elements.<br><br>Required for maps with custom trigger label type.| |label\_type|integer|Map element label type.<br><br>Possible values:<br>0 - label;<br>1 - IP address;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing.| |label\_type\_host|integer|Label type for host elements.<br><br>Possible values:<br>0 - label;<br>1 - IP address;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing;<br>5 - custom.| |label\_type\_hostgroup|integer|Label type for host group elements.<br><br>Possible values:<br>0 - label;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing;<br>5 - custom.| |label\_type\_image|integer|Label type for host group elements.<br><br>Possible values:<br>0 - label;<br>2 - *(default)* element name;<br>4 - nothing;<br>5 - custom.| |label\_type\_map|integer|Label type for map elements.<br><br>Possible values:<br>0 - label;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing;<br>5 - custom.| |label\_type\_trigger|integer|Label type for trigger elements.<br><br>Possible values:<br>0 - label;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing;<br>5 - custom.| |markelements|integer|Whether to highlight map elements that have recently changed their status.<br><br>Possible values:<br>0 - *(default)* do not highlight elements;<br>1 - highlight elements.| |severity\_min|integer|Minimum severity of the triggers that will be displayed on the map.<br><br>Refer to the [trigger "severity" property](/manual/api/reference/trigger/object#trigger) for a list of supported trigger severities.| |show\_unack|integer|How problems should be displayed.<br><br>Possible values:<br>0 - *(default)* display the count of all problems;<br>1 - display only the count of unacknowledged problems;<br>2 - display the count of acknowledged and unacknowledged problems separately.| |userid|string|Map owner user ID.| |private|integer|Type of map sharing.<br><br>Possible values:<br>0 - public map;<br>1 - *(default)* private map.| |show\_suppressed|integer|Whether suppressed problems are shown.<br><br>Possible values:<br>0 - *(default)* hide suppressed problems;<br>1 - show suppressed problems.|
pt-br	### Mapa      O objeto de mapa tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |sysmapid|string|*(somente leitura)* ID of the map.| |**height**<br>(requerido)|integer|Altura do mapa em pixels.| |**name**<br>(requerido)|string|Nome do mapa.| |**width**<br>(requerido)|integer|Largura do mapa em pixels.| |backgroundid|string|ID da imagem usada como plano de fundo para o mapa.| |expand\_macros|integer|Se as macros devem ser expandidas em rótulos ao configurar o mapa.<br><br>Valores possíveis:<br>0 - *(padrão)* não expande macros;<br>1 - expande macros.| |expandproblem|integer|Se o acionador do problema será exibido para elementos com um único problema.<br><br>Valores possíveis:<br>0 - sempre exibe o número de problemas;<br>1 - *(padrão)* exibe o acionador do problema se Há apenas um problema.| |grid\_align|integer|Se deve ativar o alinhamento da grade.<br><br>Valores possíveis:<br>0 - desabilita o alinhamento da grade;<br>1 - *(padrão)* habilita o alinhamento da grade.| |grid\_show|integer|Se deve mostrar a grade no mapa.<br><br>Valores possíveis:<br>0 - não mostrar a grade;<br>1 - *(padrão)* mostrar a grade.| |grid\_size|integer|Tamanho da grade do mapa em pixels.<br><br>Valores compatíveis: 20, 40, 50, 75 e 100.<br><br>Padrão: 50.| |highlight|integer|Se o realce do ícone está ativado.<br><br>Valores possíveis:<br>0 - realce desativado;<br>1 - *(padrão)* realce ativado.| |iconmapid|string|ID do mapa de ícones usado no mapa.| |label\_format|integer|Se deve ativar marcadores avançados.<br><br>Valores possíveis:<br>0 - *(padrão)* desativar marcadores avançados;<br>1 - ativar marcadores avançados.| |label\_location|integer|Localização do rótulo do elemento do mapa.<br><br>Valores possíveis:<br>0 - *(padrão)* inferior;<br>1 - esquerda;<br>2 - direita;<br>3 - superior.| |label\_string\_host|string|Rótulo personalizado para elementos do host.<br><br>Obrigatório para mapas com tipo de rótulo do host personalizado.| |label\_string\_hostgroup|string|Rótulo personalizado para elementos do grupo de hosts.<br><br>Obrigatório para mapas com tipo de rótulo de grupo de hosts personalizado.| |label\_string\_image|string|Rótulo personalizado para elementos de imagem.<br><br>Obrigatório para mapas com tipo de rótulo de imagem personalizado.| |label\_string\_map|string|Rótulo personalizado para elementos de mapa.<br><br>Obrigatório para mapas com tipo de rótulo de mapa personalizado.| |label\_string\_trigger|string|Rótulo personalizado para elementos de gatilho.<br><br>Obrigatório para mapas com tipo de rótulo de gatilho personalizado.| |label\_type|integer|Tipo de rótulo do elemento do mapa.<br><br>Valores possíveis:<br>0 - rótulo;<br>1 - endereço IP;<br>2 - *(padrão)* nome do elemento;<br>3 - somente status; <br>4 - nada.| |label\_type\_host|integer|Tipo de rótulo para elementos de host.<br><br>Valores possíveis:<br>0 - rótulo;<br>1 - endereço IP;<br>2 - *(padrão)* nome do elemento;<br>3 - somente status ;<br>4 - nada;<br>5 - personalizado.| |label\_type\_image|integer|Tipo de rótulo para elementos do grupo de hosts.<br><br>Valores possíveis:<br>0 - rótulo;<br>2 - *(padrão)* nome do elemento;<br>4 - nada;<br>5 - personalizado.| |label\_type\_map|integer|Tipo de rótulo para elementos do mapa.<br><br>Valores possíveis:<br>0 - rótulo;<br>2 - *(padrão)* nome do elemento;<br>3 - somente status;<br>4 - nada; <br>5 - personalizado.| |label\_type\_trigger|integer|Tipo de rótulo para elementos de gatilho.<br><br>Valores possíveis:<br>0 - rótulo;<br>2 - *(padrão)* nome do elemento;<br>3 - somente status;<br>4 - nada; <br>5 - personalizado.| |markelements|integer|Se deve destacar elementos do mapa que mudaram recentemente de status.<br><br>Valores possíveis:<br>0 - *(padrão)* não destacar elementos;<br>1 - destacar elementos.| |severity\_min|integer|Gravidade mínima dos acionadores que serão exibidos no mapa.<br><br>Consulte a [propriedade "severity" do acionador](/manual/api/reference/trigger/object#trigger) para obter uma lista de gravidades de acionadores compatíveis.| |show\_unack|integer|Como os problemas devem ser exibidos.<br><br>Valores possíveis:<br>0 - *(padrão)* exibe a contagem de todos os problemas;<br>1 - exibe apenas a contagem de problemas não confirmados;<br>2 - exibir a contagem de problemas reconhecidos e não reconhecidos separadamente.| |userid|string|ID de usuário do proprietário do mapa.| |private|integer|Tipo de compartilhamento de mapa.<br><br>Valores possíveis:<br>0 - mapa público;<br>1 - *(padrão)* mapa privado.| |show\_suppressed|integer|Se os problemas suprimidos são mostrados.<br><br>Valores possíveis:<br>0 - *(padrão)* ocultar problemas suprimidos;<br>1 - mostrar problemas suprimidos.|

en-us	# Map  This class is designed to work with maps.  Object references:\  -   [Map](/manual/api/reference/map/object#map) -   [Map element](/manual/api/reference/map/object#map_element) -   [Map link](/manual/api/reference/map/object#map_link) -   [Map URL](/manual/api/reference/map/object#map_url) -   [Map user](/manual/api/reference/map/object#map_user) -   [Map user group](/manual/api/reference/map/object#map_user_group) -   [Map shape](/manual/api/reference/map/object#map_shapes) -   [Map line](/manual/api/reference/map/object#map_lines)  Available methods:\  -   [map.create](/manual/api/reference/map/create) - create new maps -   [map.delete](/manual/api/reference/map/delete) - delete maps -   [map.get](/manual/api/reference/map/get) - retrieve maps -   [map.update](/manual/api/reference/map/update) - update maps
pt-br	# Mapa  Esta classe foi projetada para trabalhar com mapas.  Referências de objetos:\  -   [Map](/manual/api/reference/map/object#map) -   [Map element](/manual/api/reference/map/object#map_element) -   [Map link](/manual/api/reference/map/object#map_link) -   [Map URL](/manual/api/reference/map/object#map_url) -   [Map user](/manual/api/reference/map/object#map_user) -   [Map user group](/manual/api/reference/map/object#map_user_group) -   [Map shape](/manual/api/reference/map/object#map_shapes) -   [Map line](/manual/api/reference/map/object#map_lines)  Métodos disponíveis:\  -   [map.create](/manual/api/reference/map/create) - criar novos mapas -   [map.delete](/manual/api/reference/map/delete) - excluir mapas -   [map.get](/manual/api/reference/map/get) - recuperar mapas -   [map.update](/manual/api/reference/map/update) - atualizar mapas

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

en-us	### Map URL  The map URL object defines a clickable link that will be available for all elements of a specific type on the map. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapurlid|string|*(readonly)* ID of the map URL.| |**name**<br>(required)|string|Link caption.| |**url**<br>(required)|string|Link URL.| |elementtype|integer|Type of map element for which the URL will be available.<br><br>Refer to the [map element "type" property](object#map_element) for a list of supported types.<br><br>Default: 0.| |sysmapid|string|ID of the map that the URL belongs to.|
pt-br	### URL do mapa  O objeto de URL do mapa define um link clicável que estará disponível para todos os elementos de um tipo específico no mapa. Tem as seguintes propriedades:  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |sysmapurlid|string|*(somente leitura* ID da URL do mapa.| |**nome**<br>(obrigatório)|string|Legenda do link.| |**URL**<br>(obrigatório)|string|URL do Link.| |tipo de elemento|inteiro|Tipo de elemento do mapa para o qual a URL estará disponível.<br><br>Consulte a [propriedade "tipo" do elemento do mapa](object#map_element) para obter uma lista de tipos suportados.<br><br>Padrão: 0.| |sysmapid|string|ID do mapa ao qual a URL pertence.|