en-us	 #### Go libraries  |Requirement|Mandatory status|Minimum version|Description| |--|-|-|-------| |[git.zabbix.com/ap/plugin-support](https://git.zabbix.com/projects/AP/repos/plugin-support/browse?at=refs%2Fheads%2Frelease%2F6.0)|Yes|1.X.X|Zabbix own support library. Mostly for plugins. | |[go.mongodb.org/mongo-driver](https://go.mongodb.org/mongo-driver)|^|1.7.6|Named read/write locks, access sync. | |[github.com/go-stack/stack](https://github.com/go-stack/stack)|Indirect^**1**^|1.8.0|Required package for MongoDB plugin mongo-driver lib. | |[github.com/golang/snappy](https://github.com/golang/snappy)|^|0.0.1|Required package for MongoDB plugin mongo-driver lib. | |[github.com/klauspost/compress](https://github.com/klauspost/compress)|^|1.13.6|Required package for MongoDB plugin mongo-driver lib. | |[github.com/Microsoft/go-winio](https://github.com/microsoft/go-winio)|^|0.6.0|Required package for MongoDB plugin mongo-driver lib. | |[github.com/pkg/errors](https://github.com/pkg/errors)|^|0.9.1|Required package for MongoDB plugin mongo-driver lib. | |[github.com/xdg-go/pbkdf2](https://github.com/xdg-go/pbkdf2)|^|1.0.0|Required package for MongoDB plugin mongo-driver lib. | |[github.com/xdg-go/scram](https://github.com/xdg-go/scram)|^|1.0.2|Required package for MongoDB plugin mongo-driver lib. | |[github.com/xdg-go/stringprep](https://github.com/xdg-go/stringprep)|^|1.0.2|Required package for MongoDB plugin mongo-driver lib. | |[github.com/youmark/pkcs8](https://github.com/youmark/pkcs8)|^|0.0.0|Required package for MongoDB plugin mongo-driver lib. | |[golang.org/x/crypto](https://pkg.go.dev/golang.org/x/crypto)|^|0.0.0|Required package for MongoDB plugin mongo-driver lib. | |[golang.org/x/sync](https://pkg.go.dev/golang.org/x/sync)|^|0.0.0|Required package for MongoDB plugin mongo-driver lib. | |[golang.org/x/sys](https://pkg.go.dev/golang.org/x/sys)|^|0.0.0|Required package for MongoDB plugin mongo-driver lib. | |[golang.org/x/text](https://pkg.go.dev/golang.org/x/text)|^|0.3.7|Required package for MongoDB plugin mongo-driver lib. |  ^**1**^ "Indirect" means that it is used in one of the libraries that the agent uses. It's required since Zabbix uses the library that uses the package.
pt-br	#### Bibliotecas Go  |Requerimento|Status obrigatório|Versão mínima|Descrição| |--|-|-|-------| |[git.zabbix.com/ap/plugin-support](https://git.zabbix.com/projects/AP/repos/plugin-support/browse?at=refs%2Fheads%2Frelease%2F6.0)|Sim|1.X.X|Biblioteca de suporte própria do Zabbix. Principalmente para plugins. | |[go.mongodb.org/mongo-driver](https://go.mongodb.org/mongo-driver)|^|1.7.6|Bloqueios nomeados read/write, sincronização de acesso. | |[github.com/go-stack/stack](https://github.com/go-stack/stack)|Indirect^**1**^|1.8.0|Pacote necessário para o plugin MongoDB é mongo-driver lib. | |[github.com/golang/snappy](https://github.com/golang/snappy)|^|0.0.1|Pacote necessário para o plugin MongoDB é mongo-driver lib. | |[github.com/klauspost/compress](https://github.com/klauspost/compress)|^|1.13.6|Pacote necessário para o plugin MongoDB é mongo-driver lib. | |[github.com/Microsoft/go-winio](https://github.com/microsoft/go-winio)|^|0.6.0|Pacote necessário para o plugin MongoDB é mongo-driver lib. | |[github.com/pkg/errors](https://github.com/pkg/errors)|^|0.9.1|Pacote necessário para o plugin MongoDB é mongo-driver lib. | |[github.com/xdg-go/pbkdf2](https://github.com/xdg-go/pbkdf2)|^|1.0.0|Pacote necessário para o plugin MongoDB é mongo-driver lib. | |[github.com/xdg-go/scram](https://github.com/xdg-go/scram)|^|1.0.2|Pacote necessário para o plugin MongoDB é mongo-driver lib. | |[github.com/xdg-go/stringprep](https://github.com/xdg-go/stringprep)|^|1.0.2|Pacote necessário para o plugin MongoDB é mongo-driver lib. | |[github.com/youmark/pkcs8](https://github.com/youmark/pkcs8)|^|0.0.0|Pacote necessário para o plugin MongoDB é mongo-driver lib. | |[golang.org/x/crypto](https://golang.org/x/crypto)|^|0.0.0|Pacote necessário para o plugin MongoDB é mongo-driver lib. | |[golang.org/x/sync](https://golang.org/x/sync)|^|0.0.0|Pacote necessário para o plugin MongoDB é mongo-driver lib. | |[golang.org/x/sys](https://golang.org/x/sys)|^|0.0.0|Pacote necessário para o plugin MongoDB é mongo-driver lib. | |[golang.org/x/text](https://golang.org/x/text)|^|0.3.7|Pacote necessário para o plugin MongoDB é mongo-driver lib. |  ^**1**^ "Indirect" significa que é usado em uma das bibliotecas que o agente utiliza.  É necessário, pois o Zabbix utiliza a biblioteca que utiliza os pacotes.

en-us	 ### Google Cloud Platform Monitoring  A new [template](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/gcp) *Google Cloud Platform by HTTP (GCP by HTTP)* is available.  See setup instructions for [HTTP templates](/manual/config/templates_out_of_the_box/http).  You can get this template:  - In *Configuration → Templates* in new installations. - If you are upgrading from previous versions, you can download this template from Zabbix [Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates) or find it in the *zabbix/templates* directory of the downloaded latest Zabbix version. Then, while in *Configuration → Templates* you can import it manually into Zabbix.
pt-br	### Monitoramento da plataforma Google Cloud  Um novo [template](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/gcp) para *Google Cloud Platform por HTTP (GCP por HTTP)* está disponível.  Veja instruções de configuração para [HTTP templates](/manual/config/templates_out_of_the_box/http).  Você pode acessar esse template:  - Em *Configuração → Templates* em novas instalações. -  Se você estiver atualizando de versões anteriores, você pode baixar esse template do repositório de Zabbix  [Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates) ou encontrá-lo no diretório *zabbix/templates* da versão mais recente do Zabbix. Em seguida, enquanto em *Configuração→ Templates*, você pode importá-lo manualmente no Zabbix.

en-us	#### graph  Changes:\ [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graph.get`: Graph availability doesn't depend on permissions to items specified in graph "ymin_itemid" and "ymax_itemid" fields.\ Graph having MIN or MAX Y axis linked to inaccessible items will still be accessible but MIN/MAX Y axis works the same way as if specified calculation method is "Calculated".\
pt-br	#### gráfico  Mudanças:\ [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graph.get`: A disponibilidade do gráfico não depende de permissões para itens especificados nos campos "ymin_itemid" e "ymax_itemid".\ O gráfico com o eixo MIN ou MAX Y vinculado a itens inacessíveis ainda estará acessível, mas o eixo MIN/MAX Y funciona da mesma maneira como se o método de cálculo especificado fosse "Calculated".\

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

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

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

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

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

en-us	### Graph item  ::: noteclassic Graph items can only be modified via the `graph` API. :::  The graph item object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |gitemid|string|*(readonly)* ID of the graph item.| |**color**<br>(required)|string|Graph item's draw color as a hexadecimal color code.| |**itemid**<br>(required)|string|ID of the item.| |calc\_fnc|integer|Value of the item that will be displayed.<br><br>Possible values:<br>1 - minimum value;<br>2 - *(default)* average value;<br>4 - maximum value;<br>7 - all values;<br>9 - last value, used only by pie and exploded graphs.| |drawtype|integer|Draw style of the graph item.<br><br>Possible values:<br>0 - *(default)* line;<br>1 - filled region;<br>2 - bold line;<br>3 - dot;<br>4 - dashed line;<br>5 - gradient line.| |graphid|string|ID of the graph that the graph item belongs to.| |sortorder|integer|Position of the item in the graph.<br><br>Default: starts with 0 and increases by one with each entry.| |type|integer|Type of graph item.<br><br>Possible values:<br>0 - *(default)* simple;<br>2 - graph sum, used only by pie and exploded graphs.| |yaxisside|integer|Side of the graph where the graph item's Y scale will be drawn.<br><br>Possible values:<br>0 - *(default)* left side;<br>1 - right side.|
pt-br	### Item de gráfico  ::: noteclassic Os itens do gráfico só podem ser modificados por meio do `graph` API. :::  O objeto de item de gráfico tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |gitemid|string|*(readonly)* ID do item do gráfico.| |**cor**<br>(obrigatório)|string|A cor de desenho do item do gráfico como um código de cor hexadecimal.| |**itemid**<br>(obrigatório)|string|ID do item.| |calc\_fnc|inteiro|Valor do item que será exibido.<br><br>Valores possíveis:<br>1 - valor mínimo;<br>2 - *(padrão)* valor médio;<br>4 - valor máximo;<br>7 - todos os valores;<br>9 - último valor, usado apenas por gráficos de pizza e explodidos.| |drawtype|inteiro|Desenhe o estilo do item do gráfico.<br><br>Valores possíveis:<br>0 - *(padrão)* linha;<br>1 - região preenchida;<br>2 - linha em negrito;< br>3 - ponto;<br>4 - linha tracejada;<br>5 - linha gradiente.| |graphid|string|ID do gráfico ao qual o item de gráfico pertence.| |sortorder|integer|Posição do item no gráfico.<br><br>Padrão: começa com 0 e aumenta em um a cada entrada.| |tipo|inteiro|Tipo de item do gráfico.<br><br>Valores possíveis:<br>0 - *(padrão)* simples;<br>2 - soma do gráfico, usado apenas por gráficos de pizza e explodidos.| |yaxisside|inteiro|Lado do gráfico onde a escala Y do item do gráfico será desenhada.<br><br>Valores possíveis:<br>0 - *(padrão)* lado esquerdo;<br>1 - lado direito.|

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

en-us	# Graph item  This class is designed to work with graph items.  Object references:\  -   [Graph item](/manual/api/reference/graphitem/object#graph_item)  Available methods:\  -   [graphitem.get](/manual/api/reference/graphitem/get) - retrieving     graph items
pt-br	# Item de gráfico  Esta classe foi projetada para trabalhar com itens de gráfico.  Referências de objeto:\  - [item do gráfico](/manual/api/reference/graphitem/object#graph_item)  Métodos disponíveis:\  - [graphitem.get](/manual/api/reference/graphitem/get) - recuperando itens do gráfico

en-us	# > Graph object  The following objects are directly related to the `graph` API.
pt-br	# > Objeto gráfico  Os objetos a seguir estão diretamente relacionados à API `graph`.

en-us	##### Graph preview  In the *Preview* tab, a preview of the graph is displayed so you can immediately see what you are creating.  ![](../../../../../assets/en/manual/config/visualization/graph_preview.png){width="600"}  Note that the preview will not show any data for template items.  ![](../../../../../assets/en/manual/config/visualization/graph_preview2.png){width="600"}  In this example, pay attention to the dashed bold line displaying the trigger level and the trigger information displayed in the legend.  ::: noteclassic No more than 3 trigger lines can be displayed. If there are more triggers then the triggers with lower severity are prioritized for display.\ \ If graph height is set as less than 120 pixels, no trigger will be displayed in the legend. :::
pt-br	##### Visualização do gráfico  Na guia *Visualizar*, uma visualização do gráfico é exibida para que você possa ver imediatamente o que você está criando.  ![](../../../../../assets/en/manual/config/visualization/graph_preview.png){width="600"}  Observe que a visualização não mostrará nenhum dado para itens de modelo.  ![](../../../../../assets/en/manual/config/visualization/graph_preview2.png){width="600"}  Neste exemplo, preste atenção à linha tracejada em negrito exibindo o nível de disparo e as informações de disparo exibidas na legenda.  ::: noteclassic Não podem ser exibidas mais de 3 linhas de disparo. Se houver mais gatilhos, então os gatilhos com menor gravidade são priorizados para tela.\ \ Se a altura do gráfico for inferior a 120 pixels, nenhum acionador será exibido na legenda. :::

en-us	#### graphprototype  Changes:\ [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graphprototype.get`: Graph prototype availability doesn't depend on permissions to items specified in graph prototype "ymin_itemid" and "ymax_itemid" fields.\
pt-br	#### gráficoprotótipo  Mudanças:\ [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graphprototype.get`: A disponibilidade do protótipo de gráfico não depende de permissões para itens especificados nos campos de protótipo de gráfico "ymin_itemid" e "ymax_itemid".\

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

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

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

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

en-us	# > Graph prototype object  The following objects are directly related to the `graphprototype` API.
pt-br	# > Objeto protótipo gráfico  Os objetos a seguir estão diretamente relacionados à API `graphprototype`.

en-us	#### Graph prototypes  The following screenshot illustrates how we can use these macros in graph prototypes:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/graph_prototype_snmp.png)  ![](../../../../../assets/en/manual/discovery/low_level_discovery/graph_prototypes_snmp.png)  A summary of our discovery rule:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_rules_snmp.png)
pt-br	#### Protótipos de gráficos  A captura de tela a seguir ilustra como podemos usar essas macros em protótipos de gráficos:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/graph_prototype_snmp.png)  ![](../../../../../assets/en/manual/discovery/low_level_discovery/graph_prototypes_snmp.png)  Um resumo da nossa regra de descoberta:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_rules_snmp.png)

en-us	### Graph prototype  The graph prototype object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |graphid|string|*(readonly)* ID of the graph prototype.| |**height**<br>(required)|integer|Height of the graph prototype in pixels.| |**name**<br>(required)|string|Name of the graph prototype.| |**width**<br>(required)|integer|Width of the graph prototype in pixels.| |graphtype|integer|Graph prototypes's layout type.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - stacked;<br>2 - pie;<br>3 - exploded.| |percent\_left|float|Left percentile.<br><br>Default: 0.| |percent\_right|float|Right percentile.<br><br>Default: 0.| |show\_3d|integer|Whether to show discovered pie and exploded graphs in 3D.<br><br>Possible values:<br>0 - *(default)* show in 2D;<br>1 - show in 3D.| |show\_legend|integer|Whether to show the legend on the discovered graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_work\_period|integer|Whether to show the working time on the discovered graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |templateid|string|*(readonly)* ID of the parent template graph prototype.| |yaxismax|float|The fixed maximum value for the Y axis.| |yaxismin|float|The fixed minimum value for the Y axis.| |ymax\_itemid|string|ID of the item that is used as the maximum value for the Y axis.| |ymax\_type|integer|Maximum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |ymin\_itemid|string|ID of the item that is used as the minimum value for the Y axis.| |ymin\_type|integer|Minimum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |discover|integer|Graph prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new graphs will be discovered;<br>1 - new graphs will not be discovered and existing graphs will be marked as lost.| |uuid|string|Universal unique identifier, used for linking imported graph prototypes to already existing ones. Used only for graph prototypes on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.|
pt-br	### Protótipo de gráfico  O objeto de protótipo de gráfico tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |graphid|string|*(readonly)* ID do protótipo do gráfico.| |**altura**<br>(obrigatório)|inteiro|Altura do protótipo do gráfico em pixels.| |**nome**<br>(obrigatório)|string|Nome do protótipo do gráfico.| |**largura**<br>(obrigatório)|inteiro|Largura do protótipo do gráfico em pixels.| |graphtype|inteiro|Tipo de layout dos protótipos de gráfico.<br><br>Valores possíveis:<br>0 - *(padrão)* normal;<br>1 - empilhado;<br>2 - pizza;<br>3 - explodiu.| |percent\_left|float|Percentil esquerdo.<br><br>Padrão: 0.| |percent\_right|float|Percentil direito.<br><br>Padrão: 0.| |show\_3d|inteiro|Se mostrar gráficos de pizza descobertos e explodidos em 3D.<br><br>Valores possíveis:<br>0 - *(padrão)* mostrar em 2D;<br>1 - mostrar em 3D. | |show\_legend|integer|Se mostrar a legenda no gráfico descoberto.<br><br>Valores possíveis:<br>0 - ocultar;<br>1 - *(padrão)* show.| |show\_work\_period|integer|Se mostrar o tempo de trabalho no gráfico descoberto.<br><br>Valores possíveis:<br>0 - ocultar;<br>1 - *(padrão)* mostrar.| |templateid|string|*(readonly)* ID do protótipo do gráfico do template pai.| |yaxismax|float|O valor máximo fixo para o eixo Y.| |yaxismin|float|O valor mínimo fixo para o eixo Y.| |ymax\_itemid|string|ID do item que é usado como o valor máximo para o eixo Y.| |ymax\_type|inteiro|Método de cálculo do valor máximo para o eixo Y.<br><br>Valores possíveis:<br>0 - *(padrão)* calculado;<br>1 - fixo;<br>2 - item .| |ymin\_itemid|string|ID do item que é usado como valor mínimo para o eixo Y.| |ymin\_type|inteiro|Método de cálculo do valor mínimo para o eixo Y.<br><br>Valores possíveis:<br>0 - *(padrão)* calculado;<br>1 - fixo;<br>2 - item .| |discover|inteiro|Status de descoberta do protótipo do gráfico.<br><br>Valores possíveis:<br>0 - *(padrão)* novos gráficos serão descobertos;<br>1 - novos gráficos não serão descobertos e os gráficos existentes serão ser marcado como perdido.| |uuid|string|Identificador único universal, usado para vincular protótipos de gráficos importados aos já existentes. Usado apenas para protótipos de gráficos em modelos. Gerado automaticamente, se não fornecido.<br><br>Para operações de atualização, este campo é *somente leitura*.|

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

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

en-us	#### Graphs  ##### Daylight Saving Time  Changes to Daylight Saving Time (DST) result in irregularities when displaying X axis labels (date duplication, date missing, etc.).  ##### Sum aggregation  When using [sum aggregation](/manual/config/visualization/graphs/aggregate#configuration)  in a graph for period that is less than one hour, graphs display  incorrect (multiplied) values when data come from trends.  ##### Text overlapping  For some frontend languages (e.g., Japanese), local fonts can cause text overlapping in graph legend. To avoid this, use version 2.3.0 (or later) of PHP GD extension.
pt-br	#### Gráficos  ##### Horário de verão  Alterações no Horário de Verão resultam em irregularidades ao exibir rótulos do eixo X (duplicação de datas, datas faltando, etc.).  ##### Agregação de Soma  Ao usar agregação de soma [sum aggregation](/manual/config/visualization/graphs/aggregate#configuration) em um gráfico para um período inferior a uma hora, os gráficos exibem valores incorretos (multiplicados) quando os dados vêm de tendências.  ##### Sobreposição de Texto  Para alguns idiomas do frontend (por exemplo, japonês), as fontes locais podem causar sobreposição de texto na legenda do gráfico. Para evitar este problema, use a versão 2.3.0 (ou posterior) da extensão PHP GD.

en-us	#### Graphs  Edit graphs or separate graph items for better presentation of the gathered data.  [Graph API](/manual/api/reference/graph) | [Graph item API](/manual/api/reference/graphitem)
pt-br	#### Gráficos  Edite gráficos ou itens de gráfico separados para melhor apresentação dos dados coletados.  [API de gráfico](/manual/api/reference/graph) | [Item do gráfico API](/manual/api/reference/graphitem)

en-us	##### Graphs  With the item working for a while, it might be time to see something visual. [Simple graphs](/manual/config/visualization/graphs/simple) are available for any monitored numeric item without any additional configuration. These graphs are generated on runtime.  To view the graph, go to *Monitoring → Latest data* and click on the 'Graph' link next to the item.  ![](../../../assets/en/manual/quickstart/simple_graph.png){width="600"}
pt-br	##### Gráficos  Com o item funcionando por um tempo, deve ser tempo de visualizar alguma coisa visual. [Gráficos simples](/manual/config/visualization/graphs/simple) estão disponíveis para qualquer item numérico monitorado sem qualquer configuração adicional. Estes gráficos são gerados em tempo de execução.  Para visualizar o gráfico, vá até *Monitoramento → Últimos dados* e clique no link 'Gráfico' próximo ao item.  ![](../../../assets/en/manual/quickstart/simple_graph.png){width="600"}

en-us	### Graph  The graph object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |graphid|string|*(readonly)* ID of the graph.| |**height**<br>(required)|integer|Height of the graph in pixels.| |**name**<br>(required)|string|Name of the graph| |**width**<br>(required)|integer|Width of the graph in pixels.| |flags|integer|*(readonly)* Origin of the graph.<br><br>Possible values are:<br>0 - *(default)* a plain graph;<br>4 - a discovered graph.| |graphtype|integer|Graph's layout type.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - stacked;<br>2 - pie;<br>3 - exploded.| |percent\_left|float|Left percentile.<br><br>Default: 0.| |percent\_right|float|Right percentile.<br><br>Default: 0.| |show\_3d|integer|Whether to show pie and exploded graphs in 3D.<br><br>Possible values:<br>0 - *(default)* show in 2D;<br>1 - show in 3D.| |show\_legend|integer|Whether to show the legend on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_work\_period|integer|Whether to show the working time on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_triggers|integer|Whether to show the trigger line on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |templateid|string|*(readonly)* ID of the parent template graph.| |yaxismax|float|The fixed maximum value for the Y axis.<br><br>Default: 100.| |yaxismin|float|The fixed minimum value for the Y axis.<br><br>Default: 0.| |ymax\_itemid|string|ID of the item that is used as the maximum value for the Y axis.| |ymax\_type|integer|Maximum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |ymin\_itemid|string|ID of the item that is used as the minimum value for the Y axis.| |ymin\_type|integer|Minimum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |uuid|string|Universal unique identifier, used for linking imported graphs to already existing ones. Used only for graphs on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.|
pt-br	### Gráfico  O objeto gráfico tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |graphid|string|*(readonly)* ID do gráfico.| |**altura**<br>(obrigatório)|inteiro|Altura do gráfico em pixels.| |**nome**<br>(obrigatório)|string|Nome do gráfico| |**largura**<br>(obrigatório)|inteiro|Largura do gráfico em pixels.| |flags|inteiro|*(somente leitura)* Origem do gráfico.<br><br>Os valores possíveis são:<br>0 - *(padrão)* um gráfico simples;<br>4 - um gráfico descoberto.| |graphtype|inteiro|Tipo de layout do gráfico.<br><br>Valores possíveis:<br>0 - *(padrão)* normal;<br>1 - empilhado;<br>2 - pizza;<br>3 - explodido .| |percent\_left|float|Percentil esquerdo.<br><br>Padrão: 0.| |percent\_right|float|Percentil direito.<br><br>Padrão: 0.| |show\_3d|inteiro|Mostrar gráficos de pizza e explodidos em 3D.<br><br>Valores possíveis:<br>0 - *(padrão)* mostrar em 2D;<br>1 - mostrar em 3D.| |show\_legend|integer|Se mostrar a legenda no gráfico.<br><br>Valores possíveis:<br>0 - ocultar;<br>1 - *(padrão)* mostrar.| |show\_work\_period|integer|Se mostrar o tempo de trabalho no gráfico.<br><br>Valores possíveis:<br>0 - ocultar;<br>1 - *(padrão)* mostrar.| |show\_triggers|integer|Se mostrar a linha de disparo no gráfico.<br><br>Valores possíveis:<br>0 - ocultar;<br>1 - *(padrão)* mostrar.| |templateid|string|*(readonly)* ID do gráfico de modelo pai.| |yaxismax|float|O valor máximo fixo para o eixo Y.<br><br>Padrão: 100.| |yaxismin|float|O valor mínimo fixo para o eixo Y.<br><br>Padrão: 0.| |ymax\_itemid|string|ID do item que é usado como o valor máximo para o eixo Y.| |ymax\_type|inteiro|Método de cálculo do valor máximo para o eixo Y.<br><br>Valores possíveis:<br>0 - *(padrão)* calculado;<br>1 - fixo;<br>2 - item .| |ymin\_itemid|string|ID do item que é usado como valor mínimo para o eixo Y.| |ymin\_type|inteiro|Método de cálculo do valor mínimo para o eixo Y.<br><br>Valores possíveis:<br>0 - *(padrão)* calculado;<br>1 - fixo;<br>2 - item .| |uuid|string|Identificador único universal, usado para vincular gráficos importados a gráficos já existentes. Usado apenas para gráficos em modelos. Gerado automaticamente, se não fornecido.<br><br>Para operações de atualização, este campo é *somente leitura*.|

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

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

en-us	### Group link  The group link object links a host prototype with a host group and has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |group\_prototypeid|string|*(readonly)* ID of the group link.| |**groupid**<br>(required)|string|ID of the host group.| |hostid|string|*(readonly)* ID of the host prototype| |templateid|string|*(readonly)* ID of the parent template group link.|
pt-br	### Link do grupo  O objeto de link de grupo vincula um protótipo de host a um grupo de hosts e tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |group\_prototypeid|string|*(readonly)* ID do link do grupo.| |**groupid**<br>(obrigatório)|string|ID do grupo de hosts.| |hostid|string|*(readonly)* ID do protótipo do host| |templateid|string|*(readonly)* ID do link do grupo de template pai.|

en-us	### Group prototype  The group prototype object defines a group that will be created for a discovered host and has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |group\_prototypeid|string|*(readonly)* ID of the group prototype.| |**name**<br>(required)|string|Name of the group prototype.| |hostid|string|*(readonly)* ID of the host prototype| |templateid|string|*(readonly)* ID of the parent template group prototype.|
pt-br	### Protótipo de grupo  O objeto protótipo de grupo define um grupo que será criado para um host descoberto e tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |group\_prototypeid|string|*(readonly)* ID do protótipo do grupo.| |**nome**<br>(obrigatório)|string|Nome do protótipo do grupo.| |hostid|string|*(readonly)* ID do protótipo do host| |templateid|string|*(readonly)* ID do protótipo do grupo de template pai.|

en-us	#### groups/group  |Parameter|Type|Description|Details| |---------|----|-----------|-------| |name|*string*|Group name.|<|
pt-br	#### grupos/grupo  |Parâmetro|Tipo|Descrição|Detalhes| |---------|----|-----------|-------| |name|*string*|Nome do grupo.|<|

en-us	#### Guest user authorization  Automatic login for the guest user has been removed. After this change, the guest user will need to log in like any other user. Previously, a guest could immediately get to almost any monitoring or reporting page without going through authorization.
pt-br	#### Autorização de usuário convidado  O login automático para o usuário convidado foi removido. Após essa alteração, o usuário convidado precisará fazer login como qualquer outro usuário. Anteriormente, um convidado poderia acessar quase qualquer página de monitoramento ou relatório sem passar pela autorização.

en-us	#### GUI debugging  Problems related to the frontend performance may be diagnosed using the frontend [debug mode](/manual/web_interface/debug_mode).
pt-br	#### Depuração de GUI  Problemas relacionados ao desempenho do frontend podem ser diagnosticados usando o frontend [modo de depuração](/manual/web_interface/debug_mode).

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

en-us	#### Hardware
pt-br	#### Hardware

en-us	#### Hardware  General advice on hardware:  -   Use fastest processor available -   SCSI or SAS is better than IDE (performance of IDE disks may be     significantly improved by using utility hdparm) and SATA -   15K RPM is better than 10K RPM which is better than 7200 RPM -   Use fast RAID storage -   Use fast Ethernet adapter -   Having more memory is always better
pt-br	#### Hardware  Definições gerais de hardware:  -   Utilize o processador mais rápido que tiver disponível -   SCSI ou SAS é melhor que IDE (a performance de discos IDE podem ser     melhoradas significativamente pelo utilitário hdparm) e SATA -   15K RPM é melhor que 10K RPM que é melhor que 7200 RPM... -   Utilize armazenamento de RAID rápido -   Utilize adaptadores fast Ethernet -   Quanto mais memória, melhor

en-us	 **ha\_remove\_node**\[=*target*\]   Remove the high availability (HA) node specified by its name or ID. Note that active/standby nodes cannot be removed.  **ha\_set\_failover\_delay**\[=*delay*\]   Set high availability (HA) failover delay. Time suffixes are supported, e.g. 10s, 1m.  **secrets\_reload**   Reload secrets from Vault.  **service\_cache\_reload**   Reload the service manager cache.  **prof\_enable**\[=*target*\]   Enable profiling. Affects all processes if target is not specified. Enabled profiling provides details of all rwlocks/mutexes by function name. Supported since Zabbix 6.0.13.  **prof\_disable**\[=*target*\]   Disable profiling. Affects all processes if target is not specified. Supported since Zabbix 6.0.13.  **log\_level\_increase**\[=*target*\]   Increase log level, affects all processes if target is not specified     **log\_level\_decrease**\[=*target*\]   Decrease log level, affects all processes if target is not specified  [ ]{#lbAG}
pt-br	**ha\_remove\_node**\[=*target*\]   Remove o nó de alta disponibilidade (HA) especificado pelo seu nome ou ID. Note que os nós ativos/standby não podem ser removidos.  **ha\_set\_failover\_delay**\[=*delay*\]   Define o atraso de failover de alta disponibilidade (HA). Sufixos de tempo são suportados, por exemplo, 10s, 1m.  **secrets\_reload**   Recarregar segredos do Vault.  **service\_cache\_reload**   Recarregar o cache do gerenciador de serviços.  **prof\_enable**\[=*target*\]   Habilitar perfilamento. Afeta todos os processos se o alvo não for especificado. O perfilamento habilitado fornece detalhes de todos os rwlocks/mutexes pelo nome da função. Suportado desde Zabbix 6.0.13.  **prof\_disable**\[=*target*\]   Desabilitar perfilamento. Afeta todos os processos se o alvo não for especificado. Suportado desde Zabbix 6.0.13.  **log\_level\_increase**\[=*target*\]   Aumentar o nível de log, afeta todos os processos se o alvo não for especificado.     **log\_level\_decrease**\[=*target*\]   Diminuir o nível de log, afeta todos os processos se o alvo não for especificado.  [ ]{#lbAG}

en-us	##### - HDD/flash image (raw)      dd if=./zabbix_appliance_5.2.0.raw of=/dev/sdc bs=4k conv=fdatasync  Replace */dev/sdc* with your Flash/HDD disk device.
pt-br	##### - HDD/flash image (raw)      dd if=./zabbix_appliance_5.2.0.raw of=/dev/sdc bs=4k conv=fdatasync  Substitua */dev/sdc* por seu dispositivo de disco Flash/HDD.

en-us	#### Header processing  The CSV file header line can be processed in two different ways:  -   If the *With header row* checkbox is marked - header line values are     interpreted as column names. In this case the column names must be     unique and the data row should not contain more columns than the     header row; -   If the *With header row* checkbox is not marked - the header line is     interpreted as data. Column names are generated automatically     (1,2,3,4...)  CSV file example:      Nr,Item name,Key,Qty     1,active agent item,agent.hostname,33     "2","passive agent item","agent.version","44"     3,"active,passive agent items",agent.ping,55  ::: noteclassic A quotation character within a quoted field in the input must be escaped by preceding it with another quotation character. :::  **Processing header line**  JSON output when a header line is expected:  ``` {.json} [    {       "Nr":"1",       "Item name":"active agent item",       "Key":"agent.hostname",       "Qty":"33"    },    {       "Nr":"2",       "Item name":"passive agent item",       "Key":"agent.version",       "Qty":"44"    },    {       "Nr":"3",       "Item name":"active,passive agent items",       "Key":"agent.ping",       "Qty":"55"    } ] ```  **No header line processing**  JSON output when a header line is not expected:  ``` {.json} [    {       "1":"Nr",       "2":"Item name",       "3":"Key"       "4":"Qty"    },    {       "1":"1",       "2":"active agent item",       "3":"agent.hostname"       "4":"33"    },    {       "1":"2",       "2":"passive agent item",       "3":"agent.version"       "4":"44"    },    {       "1":"3",       "2":"active,passive agent items",       "3":"agent.ping"       "4":"55"    } ] ```  
pt-br	#### Processamento de cabeçalho  A linha de cabeçalho do arquivo CSV pode ser processada em duas formas diferentes:  -   Se a caixa *Com linha de cabeçalho* estiver marcada - os valores da linha     são interpretados como nomes de coluna. Neste caso os nomes de coluna devem     ser únicos e a linha de dado não deve conter mais colunas do que a linha de     cabeçalho; -   Se a caixa *Com linha de cabeçalho* não estiver marcada - a linha de cabeçalho     é interpretada como dado. Os nomes de coluna são gerados automaticamente     (1,2,3,4...)  Exemplo de arquivo CSV:      Nr,Item name,Key,Qty     1,active agent item,agent.hostname,33     "2","passive agent item","agent.version","44"     3,"active,passive agent items",agent.ping,55  ::: noteclassic Um caracter de quotação dentro de um campo quotado na entrada deve ser escapado precedendo-o com outro caracter de quotação. :::  **Processando linha de cabeçalho**  Saída JSON quando uma linha de cabeçalho é esperada:  ``` {.json} [    {       "Nr":"1",       "Item name":"active agent item",       "Key":"agent.hostname",       "Qty":"33"    },    {       "Nr":"2",       "Item name":"passive agent item",       "Key":"agent.version",       "Qty":"44"    },    {       "Nr":"3",       "Item name":"active,passive agent items",       "Key":"agent.ping",       "Qty":"55"    } ] ```  **Sem processamento de linha de cabeçalho**  Saída JSON quando uma linha de cabeçalho não é esperada:  ``` {.json} [    {       "1":"Nr",       "2":"Item name",       "3":"Key"       "4":"Qty"    },    {       "1":"1",       "2":"active agent item",       "3":"agent.hostname"       "4":"33"    },    {       "1":"2",       "2":"passive agent item",       "3":"agent.version"       "4":"44"    },    {       "1":"3",       "2":"active,passive agent items",       "3":"agent.ping"       "4":"55"    } ] ``` 

en-us	##### Hidden menu  Even when the menu is hidden completely, a full menu is just one mouse click away, by clicking on the burger icon. Note that it reappears over page content; to move page content to the right you have to unhide the menu by clicking on the show sidebar button.
pt-br	##### Menu oculto  Mesmo quando o menu está completamente oculto, um menu completo é apenas um mouse clique de distância, clicando no ícone do hambúrguer. Observe que ele reaparece Conteúdo da página; para mover o conteúdo da página para a direita, você precisa exibir o menu clicando no botão Mostrar barra lateral.

en-us	#### Hiding the file with list of common passwords  To increase the complexity of password brute force attacks, it is suggested to limit access to the file `ui/data/top_passwords.txt` by modifying web server configuration. This file contains a list of the most common and context-specific passwords, and is used to prevent users from setting such passwords if *Avoid easy-to-guess passwords* parameter is enabled in the [password policy](/manual/web_interface/frontend_sections/administration/authentication#internal_authentication).  For example, on NGINX file access can be limited by using the `location` directive:  ```ini location = /data/top_passwords.txt {     deny all;     return 404; } ```  On Apache - by using `.htaccess` file:  ```ini <Files "top_passwords.txt">     Order Allow,Deny     Deny from all </Files> ```
pt-br	#### Escondendo o arquivo com lista de senhas comuns  Para aumentar a complexidade dos ataques de força bruta a senhas, sugere-se limitar o acesso ao arquivo  `ui/data/top_passwords.txt` , modificando a configuração do servidor web. Este arquivo contém uma lista de senhas mais comuns e senhas específicas ao contexto, sendo utilizado para evitar que usuários definam tais senhas caso o parâmetro *Avoid easy-to-guess passwords* esteja habilitado na [password policy](/manual/web_interface/frontend_sections/administration/authentication#internal_authentication).  Por exemplo, o acesso ao arquivo NGINX pode ser limitado usando a diretiva `location`:  ```ini location = /data/top_passwords.txt {     deny all;     return 404; } ```  No Apache - usando o arquivo `.htaccess`:  ```ini <Files "top_passwords.txt">     Order Allow,Deny     Deny from all </Files> ```

en-us	#### Hiding the file with list of common passwords  To increase the complexity of password brute force attacks, it is suggested to limit access to the file `ui/data/top_passwords.txt` by modifying web server configuration. This file contains a list of the most common and context-specific passwords, and is used to prevent users from setting such passwords if *Avoid easy-to-guess passwords* parameter is enabled in the [password policy](/manual/web_interface/frontend_sections/administration/authentication#internal_authentication).  For example, on NGINX file access can be limited by using the `location` directive:      location = /data/top_passwords.txt {​​​​​​​         deny all;         return 404;     }​​​​​​​  On Apache - by using `.htacess` file:      <Files "top_passwords.txt">         Order Allow,Deny       Deny from all     </Files>  ​  
pt-br	 #### Escondendo o arquivo com lista de senhas mais comuns  Para aumentar a complexidade de ataques de força bruta sobre senha,  é sugerido limitar o acesso ao arquivo `ui/data/top_passwords.txt` modificando a configuração do Web Server. Este arquivo contém uma lista das senhas mais comuns e com contexto específico, e é usado para prevenir os usuários de criar senhas semelhantes se o parâmetro  *Avoid easy-to-guess passwords* estiver habilitado na [política de senha](/manual/web_interface/frontend_sections/administration/authentication#internal_authentication).  Por exemplo, no NGINX o acesso ao arquivo pode ser limitado usando a  diretiva `location`:      location = /data/top_passwords.txt {​​​​​​​         deny all;         return 404;     }​​​​​​​  No Apache, usando o arquivo `.htacess`:      <Files "top_passwords.txt">         Order Allow,Deny       Deny from all     </Files>  ​  

en-us	#### High availability cluster for Zabbix server  The new version comes with a native high availability solution for Zabbix server.  The solution consists of multiple zabbix\_server instances or nodes, where only one node can be active (working) at a time, while other nodes are on standby, ready to take over in case the current node is stopped or fails.  See also: [High availability cluster](/manual/concepts/server/ha).
pt-br	#### Cluster de alta disponibilidade para o servidor Zabbix  A nova versão vem com uma solução nativa de alta disponibilidade para o Servidor Zabbix.  A solução consiste em várias instâncias ou nós do zabbix\_server, onde apenas um nó pode estar ativo (funcionando) por vez, enquanto outros nós estão em standby, prontos para assumir o controle caso o nó atual seja interrompido ou falhe ou falhar.  Veja também: [Cluster de alta disponibilidade](/manual/concepts/server/ha).

en-us	#### High availability cluster  Retrieve a list of server nodes and their status.  [High availability cluster API](/manual/api/reference/hanode)
pt-br	#### Cluster de alta disponibilidade  Recupere uma lista de nós do servidor e seus status.  [API de cluster de alta disponibilidade](/manual/api/reference/hanode)

en-us	### High availability node  ::: noteclassic Nodes are created by the Zabbix server and cannot be modified via the API. :::  The High availability node object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |ha\_nodeid|string|ID of the node.| |name|string|Name assigned to the node, using the HANodeName configuration entry of zabbix\_server.conf. Empty for a server running in standalone mode.| |address|string|IP or DNS name where the node connects from.| |port|integer|Port on which the node is running.| |lastaccess|integer|Heartbeat time, t.i. time of last update from the node. UTC timestamp.| |status|integer|State of the node.<br><br>Possible values:<br>0 - standby;<br>1 - stopped manually;<br>2 - unavailable;<br>3 - active.|
pt-br	### Nó de alta disponibilidade  ::: noteclassic Os nós são criados pelo servidor Zabbix e não podem ser modificado por meio da API. :::  O objeto de nó de alta disponibilidade tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |ha\_nodeid|string|ID do nó.| |name|string|Nome atribuído ao nó, usando a entrada de configuração HANodeName de zabbix\_server.conf. Vazio para um servidor em execução no modo autônomo.| |address|string|IP ou nome DNS de onde o nó se conecta.| |port|integer|Porta na qual o nó está sendo executado.| |lastaccess|integer|Heartbeat time, t.i. hora da última atualização do nó. Carimbo de hora UTC.| |status|inteiro|Estado do nó.<br><br>Valores possíveis:<br>0 - espera;<br>1 - parado manualmente;<br>2 - indisponível;<br>3 - ativo.|

en-us	# > High availability node object  The following object is related to operating a High availability cluster of Zabbix servers.
pt-br	# > Objeto de nó de alta disponibilidade  O objeto a seguir está relacionado à operação de um cluster de alta disponibilidade dos servidores Zabbix.

en-us	#### High availability nodes  If [high availability cluster](/manual/concepts/server/ha) is enabled, then another block of data is displayed with the status of each high availability node.  ![](../../../../../assets/en/manual/web_interface/ha_nodes.png){width="600"}  Displayed data:  |Column|Description| |------|-----------| |*Name*|Node name, as defined in server configuration.| |*Address*|Node IP address and port.| |*Last access*|Time of node last access.<br>Hovering over the cell shows the timestamp of last access in long format.| |*Status*|Node status:<br>**Active** - node is up and working<br>**Unavailable** - node hasn't been seen for more than failover delay (you may want to find out why)<br>**Stopped** - node has been stopped or couldn't start (you may want to start it or delete it)<br>**Standby** - node is up and waiting|
pt-br	#### Nós de alta disponibilidade  Se [cluster de alta disponibilidade](/manual/concepts/server/ha) estiver ativado, então outro bloco de dados é exibido com o status de cada alta nó de disponibilidade.  ![](../../../../../assets/en/manual/web_interface/ha_nodes.png){width="600"}  Dados exibidos:  |Coluna|Descrição| |------|-----------| |*Nome*|Nome do nó, conforme definido na configuração do servidor.| |*Endereço*|Endereço IP e porta do nó.| |*Último acesso*|Hora do último acesso do nó.<br>Passar o mouse sobre a célula mostra o carimbo de data/hora do último acesso em formato longo.| |*Status*|Status do nó:<br>**Ativo** - o nó está ativo e funcionando<br>**Indisponível** - o nó não foi visto por mais de um atraso de failover (você pode querer descobrir por que )<br>**Parado** - o nó foi interrompido ou não pôde ser iniciado (você pode iniciá-lo ou excluí-lo)<br>**Em espera** - o nó está ativo e aguardando|

en-us	# High availability node  This class is designed to work with server nodes that are part of a High availability cluster, or a standalone server instance.  Object references:\  -   [High availability node](/manual/api/reference/hanode/object#hanode)  Available methods:\  -   [hanode.get](/manual/api/reference/hanode/get) - retrieving nodes
pt-br	# Nó de alta disponibilidade  Esta classe foi projetada para trabalhar com nós de servidor que fazem parte de um High cluster de disponibilidade ou uma instância de servidor independente.  Referências de objetos:\  - [Nodo de alta disponibilidade](/manual/api/reference/hanode/object#hanode)  Métodos disponíveis:\  - [hanode.get](/manual/api/reference/hanode/get) - recuperando nós

en-us	#### history  Changes:\ [ZBXNEXT-6714](https://support.zabbix.com/browse/ZBXNEXT-6714) added new API method `history.clear`.\
pt-br	#### histórico  Mudanças:\ [ZBXNEXT-6714](https://support.zabbix.com/browse/ZBXNEXT-6714) adicionado novo método de API `history.clear`.\

en-us	# history.clear
pt-br	# histórico.limpar

en-us	#### History functions  |FUNCTION|<|<|<| |--------|-|-|-| |<|**Description**|**Function-specific parameters**|**Comments**| |**change** (/host/key)|<|<|<| |<|The amount of difference between the previous and latest value.|<|Supported value types: float, int, str, text, log<br><br>For strings returns:<br>0 - values are equal<br>1 - values differ<br><br>Example:<br>=> **change**(/host/key)>10<br><br>Numeric difference will be calculated, as seen with these incoming example values ('previous' and 'latest' value = difference):<br>'1' and '5' = `+4`<br>'3' and '1' = `-2`<br>'0' and '-2.5' = `-2.5`<br><br>See also: [abs](/manual/appendix/functions/math) for comparison| |**changecount** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<|<| |<|Number of changes between adjacent values within the defined evaluation period.|See [common parameters](#common-parameters).<br><br>**mode** (optional; must be double-quoted)<br><br>Supported `modes`:<br>*all* - count all changes (default)<br>*dec* - count decreases<br>*inc* - count increases|Supported value types: float, int, str, text, log<br><br>For non-numeric value types, *mode* parameter is ignored.<br><br>Examples:<br>=> **changecount**(/host/key, 1w) → number of value changes for the last week until [now](/manual/config/triggers#evaluation_period)<br>=> **changecount**(/host/key,\#10,"inc") → number of value increases (relative to the adjacent value) among the last 10 values<br>=> **changecount**(/host/key,24h,"dec") → number of value decreases (relative to the adjacent value) for the last 24 hours until [now](/manual/config/triggers#evaluation_period)| |**count** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<|<| |<|Number of values within the defined evaluation period.|See [common parameters](#common-parameters).<br><br>**operator** (optional; must be double-quoted)<br><br>Supported `operators`:<br>*eq* - equal (default)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br><br>**pattern** (optional) - required pattern (string arguments must be double-quoted)|Supported value types: float, integer, string, text, log<br><br>Float items match with the precision of 2.22e-16; if database is [not upgraded](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) the precision is 0.000001.<br><br>With *bitand* as the third parameter, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number\_to\_compare\_with/mask**. count() calculates "bitwise AND" from the value and the *mask* and compares the result to *number\_to\_compare\_with*. If the result of "bitwise AND" is equal to *number\_to\_compare\_with*, the value is counted.<br>If *number\_to\_compare\_with* and *mask* are equal, only the *mask* need be specified (without '/').<br><br>With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit.<br><br>Examples:<br>=> **count**(/host/key,**10m**) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period)<br>=> **count**(/host/key,**10m**,"like","error") → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that contain 'error'<br>=> **count**(/host/key,**10m**,,12) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that equal '12'<br>=> **count**(/host/key,**10m**,"gt",12) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **count**(/host/key,**\#10**,"gt",12) → number of values within the last 10 values until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **count**(/host/key,**10m:now-1d**,"gt",12) → number of values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period) that were over '12'<br>=> **count**(/host/key,**10m**,"bitand","6/7") → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) having '110' (in binary) in the 3 least significant bits.<br>=> **count**(/host/key,**10m:now-1d**) → number of values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period)| |**countunique** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<|<| |<|Number of unique values within the defined evaluation period.|See [common parameters](#common-parameters).<br><br>**operator** (optional; must be double-quoted)<br><br>Supported `operators`:<br>*eq* - equal (default)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br><br>**pattern** (optional) - required pattern (string arguments must be double-quoted)|Supported value types: float, integer, string, text, log<br><br>Float items match with the precision of 2.22e-16; if database is [not upgraded](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) the precision is 0.000001.<br><br>With *bitand* as the third parameter, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number\_to\_compare\_with/mask**. count() calculates "bitwise AND" from the value and the *mask* and compares the result to *number\_to\_compare\_with*. If the result of "bitwise AND" is equal to *number\_to\_compare\_with*, the value is counted.<br>If *number\_to\_compare\_with* and *mask* are equal, only the *mask* need be specified (without '/').<br><br>With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit.<br><br>Examples:<br>=> **countunique**(/host/key,**10m**) → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period)<br>=> **countunique**(/host/key,**10m**,"like","error") → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that contain 'error'<br>=> **countunique**(/host/key,**10m**,"gt",12) → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **countunique**(/host/key,**\#10**,"gt",12) → number of unique values within the last 10 values until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **countunique**(/host/key,**10m:now-1d**,"gt",12) → number of unique values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period) that were over '12'<br>=> **countunique**(/host/key,**10m**,"bitand","6/7") → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) having '110' (in binary) in the 3 least significant bits.<br>=> **countunique**(/host/key,**10m:now-1d**) → number of unique values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period)| |**find** (/host/key,<(sec\|\#num)<:time shift>>,<operator>,<pattern>)|<|<|<| |<|Find a value match.|See [common parameters](#common-parameters).<br><br>**sec** or **\#num** (optional) - defaults to the latest value if not specified<br><br>**operator** (optional; must be double-quoted)<br><br>Supported `operators`:<br>*eq* - equal (default)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* - value contains the string given in `pattern` (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br><br>**pattern** - required pattern (string arguments must be double-quoted); [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) regular expression if `operator` is *regexp*, *iregexp*.|Supported value types: float, int, str, text, log<br><br>Returns:<br>1 - found<br>0 - otherwise<br><br>If more than one value is processed, '1' is returned if there is at least one matching value.<br><br>With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings.<br><br>Example:<br>=> **find**(/host/key,**10m**,"like","error") → find a value that contains 'error' within the last 10 minutes until [now](/manual/config/triggers#evaluation_period)| |**first** (/host/key,sec<:time shift>)|<|<|<| |<|The first (the oldest) value within the defined evaluation period.|See [common parameters](#common-parameters).|Supported value types: float, int, str, text, log<br><br>Example:<br>=> **first**(/host/key,**1h**) → retrieve the oldest value within the last hour until [now](/manual/config/triggers#evaluation_period)<br><br>See also last().| |**fuzzytime** (/host/key,sec)|<|<|<| |<|Checking how much the passive agent time differs from the Zabbix server/proxy time.|See [common-parameters](#common parameters).|Supported value types: float, int<br><br>Returns:<br>1 - difference between the passive item value (as timestamp) and Zabbix server/proxy timestamp is less than or equal to T seconds<br>0 - otherwise<br><br>Usually used with the 'system.localtime' item to check that local time is in sync with the local time of Zabbix server. *Note* that 'system.localtime' must be configured as a [passive check](/manual/appendix/items/activepassive#passive_checks).<br>Can be used also with vfs.file.time\[/path/file,modify\] key to check that file didn't get updates for long time.<br><br>Example:<br>=> **fuzzytime**(/host/key,**60s**)=0 → detect a problem if the time difference is over 60 seconds<br><br>This function is not recommended for use in complex trigger expressions (with multiple items involved), because it may cause unexpected results (time difference will be measured with the most recent metric), e.g. in `fuzzytime(/Host/system.localtime,60s)=0 or last(/Host/trap)<>0`| |**last** (/host/key,<\#num<:time shift>>)|<|<|<| |<|The most recent value.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value|Supported value types: float, int, str, text, log<br><br>Take note that a hash-tagged time period (\#N) works differently here than with many other functions.<br>For example:<br>last() is always equal to last(\#1)<br>last(\#3) - third most recent value (*not* three latest values)<br><br>Zabbix does not guarantee the exact order of values if more than two values exist within one second in history.<br><br>Example:<br>=> **last**(/host/key) → retrieve the last value<br>=> **last**(/host/key,**\#2**) → retrieve the previous value<br>=> **last**(/host/key,**\#1**) <> **last**(/host/key,**\#2**) → the last and previous values differ<br><br>See also first().| |**logeventid** (/host/key,<\#num<:time shift>>,<pattern>)|<|<|<| |<|Checking if event ID of the last log entry matches a regular expression.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value<br><br>**pattern** (optional) - regular expression describing the required pattern, [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) style (string arguments must be double-quoted).|Supported value types: log<br><br>Returns:<br>0 - does not match<br>1 - matches| |**logseverity** (/host/key,<\#num<:time shift>>)|<|<|<| |<|Log severity of the last log entry.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value|Supported value types: log<br><br>Returns:<br>0 - default severity<br>N - severity (integer, useful for Windows event logs: 1 - Information, 2 - Warning, 4 - Error, 7 - Failure Audit, 8 - Success Audit, 9 - Critical, 10 - Verbose).<br>Zabbix takes log severity from **Information** field of Windows event log.| |**logsource** (/host/key,<\#num<:time shift>>,<pattern>)|<|<|<| |<|Checking if log source of the last log entry matches a regular expression.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value<br><br>**pattern** (optional) - regular expression describing the required pattern, [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) style (string arguments must be double-quoted).|Supported value types: log<br><br>Returns:<br>0 - does not match<br>1 - matches<br><br>Normally used for Windows event logs. For example, logsource("VMware Server").| |**monodec** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<|<| |<|Check if there has been a monotonous decrease in values.|See [common parameters](#common-parameters).<br><br>**mode** (must be double-quoted) - *weak* (every value is smaller or the same as the previous one; default) or *strict* (every value has decreased)|Supported value types: int<br><br>Returns 1 if all elements in the time period continuously decrease, 0 otherwise.<br><br>Example:<br>=> **monodec**(/Host1/system.swap.size\[all,free\],**60s**) + **monodec**(/Host2/system.swap.size\[all,free\],**60s**) + **monodec**(/Host3/system.swap.size\[all,free\],**60s**) - calculate in how many hosts there has been a decrease in free swap size| |**monoinc** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<|<| |<|Check if there has been a monotonous increase in values.|See [common parameters](#common-parameters).<br><br>**mode** (must be double-quoted) - *weak* (every value is bigger or the same as the previous one; default) or *strict* (every value has increased)|Supported value types: int<br><br>Returns 1 if all elements in the time period continuously increase, 0 otherwise.<br><br>Example:<br>=> **monoinc**(/Host1/system.localtime,**\#3**,"strict")=0 - check if system local time has been increasing consistently| |**nodata** (/host/key,sec,<mode>)|<|<|<| |<|Checking for no data received.|See [common parameters](#common-parameters).<br><br>**sec** period should not be less than 30 seconds because the history syncer process calculates this function only every 30 seconds.<br><br>nodata(/host/key,0) is disallowed.<br><br>**mode** - if set to *strict* (double-quoted), this function will be insensitive to proxy availability (see comments for details).|All value types are supported.<br><br>Returns:<br>1 - if no data received during the defined period of time<br>0 - otherwise<br><br>Since Zabbix 5.0, the 'nodata' triggers monitored by proxy are, by default, sensitive to proxy availability - if proxy becomes unavailable, the 'nodata' triggers will not fire immediately after a restored connection, but will skip the data for the delayed period. Note that for passive proxies suppression is activated if connection is restored more than 15 seconds and no less than 2 & ProxyUpdateFrequency seconds later. For active proxies suppression is activated if connection is restored more than 15 seconds later.<br><br>To turn off sensitiveness to proxy availability, use the third parameter, e.g.: **nodata**(/host/key,**5m**,**"strict"**); in this case the function will work the same as before 5.0.0 and fire as soon as the evaluation period (five minutes) without data has past.<br><br>Note that this function will display an error if, within the period of the 1st parameter:<br>- there's no data and Zabbix server was restarted<br>- there's no data and maintenance was completed<br>- there's no data and the item was added or re-enabled<br>Errors are displayed in the *Info* column in trigger [configuration](/manual/web_interface/frontend_sections/configuration/hosts/triggers).<br><br>This function may not work properly if there are time differences between Zabbix server, proxy and agent. See also: [Time synchronization requirement](/manual/installation/requirements#time_synchronization).| |**percentile** (/host/key,(sec\|\#num)<:time shift>,percentage)|<|<|<| |<|P-th percentile of a period, where P (percentage) is specified by the third parameter.|See [common parameters](#common-parameters).<br><br>**percentage** - a floating-point number between 0 and 100 (inclusive) with up to 4 digits after the decimal point|Supported value types: float, int| |**rate** (/host/key,sec<:time shift>)|<|<|<| |<|Per-second average rate of the increase in a monotonically increasing counter within the defined time period.|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Functionally corresponds to '[rate](https://prometheus.io/docs/prometheus/latest/querying/functions/#rate)' of PromQL.<br><br>Example:<br>=> **rate**(/host/key,**30s**) → If the monotonic increase over 30 seconds is 20, this function will return 0.67.|
pt-br	 #### Funções do histórico  |FUNÇÃO|<|<|<| |--------|-|-|-| |<|**Descrição**|**Parâmetro especifico - função**|**Comentários**| |**baselinedev** (/host/key,data period:time shift,season_unit,num_seasons)|<|<|<| |<|Retorna o número de desvios (pelo algoritmo stddevpop) entre o último período de dados e os mesmos períodos de dados nas temporadas anteriores |**data period** -o período de coleta de dados dentro de uma estação, definido como \<N>\<time unit> onde<br>`N` - número de unidades de tempo<br>`time unit` - h (hora ), d (dia), w (semana), M (mês) ou y (ano), deve ser igual ou menor que a estação <br><br>[Time shift](/manual/config/triggers/expression#function-specific_parameters) - o deslocamento do período de tempo (veja exemplos)<br><br> **season_unit** - duração de uma temporada (h, d, w, M, y), não pode ser menor que o período de dados <br><br>**num_seasons** - número de temporadas a avaliar| Exemplos:<br>=> **baselinedev**(/host/key,1d:now/d,"M",6) →  calcular os números de desvios padrão (população) entre o dia anterior e o mesmo dia nos 6 meses anteriores. Caso a data não exista em um mês anterior, será utilizado o último dia do mês (31/jul será analisado contra 31/jan, 28/fev,... 30/junho). <br> => **baselinedev**(/host/key,1h:now/h,"d",10)  →calculando o número de desvios padrão (população) entre a hora anterior e as mesmas horas no período de dez dias antes de ontem.   | |**baselinewma** (/host/key,data period:time shift,season_unit,num_seasons)|<|<|<| |<|Calcula a linha de base calculando a média dos dados do mesmo período de tempo em vários períodos iguais ('estações') usando o algoritmo de média móvel ponderada.|**data period** - o período de coleta de dados dentro de uma temporada, definido como \< N>\<unidade de tempo> onde<br>`N` - número de unidades de tempo<br>`unidade de tempo` - h (hora), d (dia), w (semana), M (mês) ou y (ano ), deve ser igual ou menor que a temporada<br><br>[Time shift](/manual/config/triggers/expression#function-specific_parameters) -o deslocamento do período de tempo, define o fim do período de coleta de dados em temporadas (veja exemplos)<br><br> **season_unit** - duração de uma temporada (h, d, w, M, y), não pode ser menor que o período de dados<br><br>**num_seasons** -número de temporadas a avaliar| Exemplos:<br>=> **baselinewma**(/host/key,1h:now/h,"d",3) →  cálculo da linha de base com base na última hora completa dentro de um período de 3 dias que terminou ontem. Se "agora" for 13:30 de segunda-feira, os dados de 12:00-12:59 de sexta, sábado e domingo serão analisados. <br>=> **baselinemwa**(/host/key,2h:now/h,"d",3) →  calcular a linha de base com base nas últimas duas horas em um período de 3 dias que terminou ontem. Se "agora" for segunda-feira 13h30, os dados para 10h-11h59 de sexta, sábado e domingo serão analisados.  <br>=> **baselinewma**(/host/key,1d:now/d,"M",4) → cálculo da linha de base com base nos últimos dias dos 4 meses anteriores, excluindo o último mês completo. Se hoje for 1º de setembro, serão analisados os dados de 31 de julho, 30 de junho, 31 de maio, 30 de abril.| |**change** (/host/key)|<|<|<| |<|A quantidade de diferença entre o valor anterior e o mais recente.|<|Tipos de valor suportados: float, int, str, text, log<br><br>Para strings retorna:<br>0 - os valores são iguais<br>1 - os valores diferem<br><br>Exemplo:<br>=> **alterar**(/host/key)>10<br><br>Numeric difference will be calculated, as seen with these incoming example values ('previous' and 'latest' value = difference):<br>'1' and '5' = `+4`<br>'3' and '1' = `-2`<br>'0' and '-2.5' = `-2.5`<br><br>See also: [abs](/manual/appendix/functions/math) for comparison| |**changecount** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<|<| |<|Número de alterações entre valores adjacentes dentro do período de avaliação definido.|Consulte [Parâmetros comuns](#common-parameters).<br><br>**mode** (opcional; deve estar entre aspas duplas)<br><br>Modos compatíveis:<br>*all* - conta todas as alterações (padrão)<br>*dec* - contagem diminui<br>*inc* - contagem aumenta|Tipos de valor suportados: float, int, str, text, log<br><br>Para tipos de valor não numéricos, o parâmetro *mode* é ignorado.<br><br>Exemplos:<br>=> ** changecount**(/host/key, 1w) → número de mudanças de valor para a última semana até [agora](/manual/config/triggers#evaluation_period)<br>=> **changecount**(/host/key,\#10,"inc") → número de aumentos de valor (em relação ao valor adjacente) entre os últimos 10 valores<br>=> **changecount**(/host/key,24h,"dec") →número de valores diminui (em relação ao valor adjacente) nas últimas 24 horas até [agora](/manual/config/triggers#evaluation_period)| |**count** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<|<| |<|Número de valores dentro do período de avaliação definido.|Veja[parâmetros comuns](#common-parameters).<br><br>**operator** (opcional; deve estar entre aspas duplas)<br><br>Operadores suportados:<br>*eq* - igual (padrão)<br>*ne* - diferente<br>*gt* - maior<br >*ge* - maior ou igual<br>*lt* - menor<br>*le* - menor ou igual<br>*como* - corresponde se contiver padrão (diferencia maiúsculas de minúsculas)<br>*bitand* - bit a bit AND<br>*regexp* - correspondência com distinção entre maiúsculas e minúsculas da expressão regular fornecida em `pattern`<br>*iregexp* - correspondência sem distinção entre maiúsculas e minúsculas de a expressão regular fornecida em `pattern`<br><br>**pattern** (opcional) - padrão obrigatório (argumentos de string devem estar entre aspas duplas)|Tipos de valor suportados: float, integer, string, text, log<br ><br>Os itens flutuantes correspondem com a precisão de 2.22e-16; se o banco de dados for [não atualizado](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) a precisão é de  0.000001.<br><br>Com *bitand* como terceiro parâmetro, o quarto parâmetro `pattern` pode ser especificado como dois números, separados por '/': **number\_to\_compare\_with/mask**. count() calcula "and bit a bit" a partir do valor e da *mask* e compara o resultado com *number\_to\_compare\_with*. Se o resultado de "bit a bit AND" for igual a *number\_to\_compare\_with*, o valor será contado.<br>Se *number\_to\_compare\_with* e *mask* forem iguais, somente a *mask * precisa ser especificado (sem '/').<br><br>Com *regexp* ou *iregexp* como o terceiro parâmetro, o quarto parâmetro `pattern` pode ser comum ou [global](/manual/regular_expressions#global_regular_expressions) (começando com '@') expressão regular. No caso de expressões regulares globais, a distinção entre maiúsculas e minúsculas é herdada das configurações de expressões regulares globais. Para fins de correspondência regexp, os valores float sempre serão representados com 4 dígitos decimais após '.'. Observe também que, para números grandes, a diferença na representação decimal (armazenada no banco de dados) e binária (usada pelo servidor Zabbix) pode afetar o 4º dígito decimal.<br><br>Exemplos:<br>=> **count**(/ host/key,**10m**) → número de valores nos últimos 10 minutos até [agora](/manual/config/triggers#evaluation_period)<br>=> **count**(/host/key,**10m**,"like","error") → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) que contém 'error'<br>=> **count**(/host/key,**10m**,,12) → número de valores nos últimos 10 minutos até[agora](/manual/config/triggers#evaluation_period) é igual a '12'<br>=> **count**(/host/key,**10m**,"gt",12) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) que acabaram '12'<br>=> **count**(/host/key,**\#10**,"gt",12) → número de valores dentro dos últimos 10 valores até [agora](/manual/config/triggers#evaluation_period) que acabaram '12'<br>=> **count**(/host/key,**10m:now-1d**,"gt",12) → número de valores entre 24 horas e 10 minutos e 24 horas atrás de[agora](/manual/config/triggers#evaluation_period) isso acabou'12'<br>=> **count**(/host/key,**10m**,"bitand","6/7") → número de valores nos últimos 10 minutos até [agora](/manual/config/triggers#evaluation_period)tendo '110' (em binário) nos 3 bits menos significativos.<br>=> **count**(/host/key,**10m:now-1d**) → número de valores entre 24 horas e 10 minutos e 24 horas atrás de [agora](/manual/config/triggers#evaluation_period)| |**countunique** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<|<| |<|Número de valores únicos dentro do período de avaliação definido.|Consulte [parâmetros comuns](#common-parameters).<br><br>**operator** (opcional; deve estar entre aspas duplas)<br><br>Operadores suportados:<br>*eq* - igual (padrão)<br>*ne* - diferente<br>*gt* - maior<br>*ge* - maior ou igual<br>*lt* - menor<br>*le* - menor ou igual<br>*like* - corresponde se contiver padrão ( diferencia maiúsculas de minúsculas)<br>*bitand* - bit a bit AND<br>*regexp* - correspondência com distinção entre maiúsculas e minúsculas da expressão regular fornecida em `pattern`<br>*iregexp* - correspondência sem distinção entre maiúsculas e minúsculas da expressão regular fornecida em `pattern`<br><br>**pattern** (opcional) - padrão obrigatório (os argumentos de string devem estar entre aspas duplas)|Tipos de valor suportados: float, integer, string, text, log<br><br>Float os itens correspondem com a precisão de 2,22e-16; se o banco de dados for [não atualizado](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) a precisão é 0,000001.<br><br>Com *bitand* como terceiro parâmetro, o quarto parâmetro `pattern` pode ser especificado como dois números, separados por '/': **number\_to\_compare\_with/mask **. count() calcula "and bit a bit" a partir do valor e da *mask* e compara o resultado com *number\_to\_compare\_with*. Se o resultado de "bit a bit AND" for igual a *number\_to\_compare\_with*, o valor será contado.<br>Se *number\_to\_compare\_with* e *mask* forem iguais, somente a *mask * precisa ser especificado (sem '/').<br><br>Com *regexp* ou *iregexp* como o terceiro parâmetro, o quarto parâmetro `pattern` pode ser comum ou [global](/manual/regular_expressions#global_regular_expressions) (começando com '@') expressão regular. No caso de expressões regulares globais, a distinção entre maiúsculas e minúsculas é herdada das configurações de expressões regulares globais. Para fins de correspondência regexp, os valores float sempre serão representados com 4 dígitos decimais após '.'. Observe também que, para números grandes, a diferença na representação decimal (armazenada no banco de dados) e binária (usada pelo servidor Zabbix) pode afetar o 4º dígito decimal.<br><br>Exemplos:<br>=> **countunique**(/ host/key,**10m**) → número de valores únicos nos últimos 10 minutos até [agora](/manual/config/triggers#evaluation_period)<br>=> **countunique**(/host/key, **10m**,"like","error") → número de valores únicos nos últimos 10 minutos até [agora](/manual/config/triggers#evaluation_period) que contêm 'error'<br>=> ** countunique**(/host/key,**10m**,"gt",12) → número de valores únicos dos últimos 10 minutos até [agora](/manual/config/triggers#evaluation_period) que estão acima de '12 '<br>=> **countunique**(/host/key,**\#10**,"gt",12) → número de valores únicos nos últimos 10 valores até [agora](/manual/config /triggers#evaluation_period) com mais de '12'<br>=> **countunique**(/host/key,**10m:now-1d**,"gt",12) → número de valores únicos entre 24 horas e 10 minutos e 24 horas atrás de [agora](/man ual/config/triggers#evaluation_period) com mais de '12'<br>=> **countunique**(/host/key,**10m**,"bitand","6/7") → número de valores dos últimos 10 minutos até [agora](/manual/config/triggers#evaluation_period) com '110' (em binário) nos 3 bits menos significativos.<br>=> **countunique**(/host/key ,**10m:agora-1d**) → número de valores únicos entre 24 horas e 10 minutos e 24 horas atrás de [agora](/manual/config/triggers#evaluation_period)| |**encontrar** (/host/key,<(sec\|\#num)<:time shift>>,<operator>,<pattern>)|<|<|<| |<|Encontre uma correspondência de valor.|Consulte [parâmetros comuns](#common-parameters).<br><br>**sec** ou **\#num** (opcional) - o padrão é o valor mais recente se não especificado<br><br>**operador** (opcional; deve estar entre aspas duplas)<br><br>"operadores" suportados:<br>*eq* - igual (padrão)<br>*ne* - diferente<br>*gt* - maior<br>*ge* - maior ou igual<br>*lt* - menor<br>*le* - menor ou igual<br>*like* - valor contém a string dado em `pattern` (diferencia maiúsculas de minúsculas)<br>*bitand* - bit a bit AND<br>*regexp* - correspondência com distinção entre maiúsculas e minúsculas da expressão regular fornecida em `pattern`<br>*iregexp* - correspondência sem distinção entre maiúsculas e minúsculas da expressão regular dada em `pattern`<br><br>**pattern** - padrão obrigatório (argumentos de string devem estar entre aspas); [Expressão regular compatível com Perl](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) expressão regular se `operator` for *regexp*, *iregexp*.|Tipos de valor suportados: float, int, str, text, log<br><br>Retorna:<br>1 - encontrado<br>0 - caso contrário<br><br>Se mais de um valor for processado, '1' será retornado se houver pelo menos um valor correspondente.<br><br>Com *regexp* ou *iregexp* como o terceiro parâmetro, o o quarto parâmetro `pattern` pode ser uma expressão regular comum ou [global](/manual/regular_expressions#global_regular_expressions) (começando com '@'). No caso de expressões regulares globais, a distinção entre maiúsculas e minúsculas é herdada das configurações de expressões regulares globais.<br><br>Exemplo:<br>=> **find**(/host/key,**10m**,"like", "erro") → encontre um valor que contenha 'erro' nos últimos 10 minutos até [agora](/manual/config/triggers#evaluation_period)| |**primeiro** (/host/key,sec<:time shift>)|<|<|<| |<|O primeiro (o mais antigo) valor dentro do período de avaliação definido.|Consulte [parâmetros comuns](#common-parameters).|Tipos de valor suportados: float, int, str, text, log<br><br>Exemplo :<br>=> **first**(/host/key,**1h**) → recuperar o valor mais antigo na última hora até [agora](/manual/config/triggers#evaluation_period)<br>< br>Veja também last().| |**fuzzytime** (/host/chave,seg)|<|<|<| |<|Verificando o quanto o tempo do agente passivo difere do tempo do servidor/proxy Zabbix.|Consulte [common-parameters](#common parameters).|Tipos de valor suportados: float, int<br><br>Retorna:<br>1 - diferença entre o valor do item passivo (como carimbo de data/hora) e o carimbo de data/hora do servidor/proxy Zabbix é menor ou igual a T segundos<br>0 - caso contrário<br><br>Geralmente usado com o item 'system.localtime' para verificar esse local a hora está sincronizada com a hora local do servidor Zabbix. *Observe* que 'system.localtime' deve ser configurado como uma [verificação passiva](/manual/appendix/items/activepassive#passive_checks).<br>Pode ser usado também com vfs.file.time\[/path/file ,modify\] para verificar se o arquivo não recebeu atualizações por muito tempo.<br><br>Exemplo:<br>=> **fuzzytime**(/host/key,**60s**)=0 → detectar um problema se a diferença de tempo for superior a 60 segundos<br><br>Esta função não é recomendada para uso em expressões de gatilho complexas (com vários itens envolvidos), pois pode causar resultados inesperados (a diferença de tempo será medida com o métrica mais recente), por exemplo em `fuzzytime(/Host/system.localtime,60s)=0 ou last(/Host/trap)<>0`| |**último** (/host/key,<\#num<:time shift>>)|<|<|<| |<|O valor mais recente.|Consulte [parâmetros comuns](#common-parameters).<br><br>**\#num** (opcional) - o enésimo valor mais recente|Tipos de valor suportados: float, int, str , text, log<br><br>Observe que um período de tempo com tag de hash (\#N) funciona de maneira diferente aqui do que com muitas outras funções.<br>Por exemplo:<br>last() é sempre igual a last (\#1)<br>last(\#3) - terceiro valor mais recente (*não* três valores mais recentes)<br><br>O Zabbix não garante a ordem exata dos valores se existirem mais de dois valores em um segundo na história.<br><br>Exemplo:<br>=> **last**(/host/key) → recuperar o último valor<br>=> **last**(/host/key,* *\#2**) → recuperar o valor anterior<br>=> **last**(/host/key,**\#1**) <> **last**(/host/key,* *\#2**) → o último e o anterior são diferentes<br><br>Veja também first().| |**logevenid** (/host/key,<\#num<:time shift>>,<pattern>)|<|<|<| |<|Verificando se o ID do evento da última entrada de log corresponde a uma expressão regular.|Consulte [parâmetros comuns](#common-parameters).<br><br>**\#num** (opcional) - o enésimo valor mais recente< br><br>**pattern** (opcional) - expressão regular que descreve o padrão requerido, estilo [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) (os argumentos de string devem ser aspas duplas).|Tipos de valor suportados: log<br><br>Retorna:<br>0 - não corresponde<br>1 - corresponde| |**logseverity** (/host/key,<\#num<:time shift>>)|<|<|<| |<|Gravidade do log da última entrada de log.|Consulte [parâmetros comuns](#common-parameters).<br><br>**\#num** (opcional) - o enésimo valor mais recente|Tipos de valor suportados : log<br><br>Retorna:<br>0 - gravidade padrão<br>N - gravidade (inteiro, útil para logs de eventos do Windows: 1 - Informações, 2 - Aviso, 4 - Erro, 7 - Auditoria de falhas, 8 - Auditoria de sucesso, 9 - Crítico, 10 - Detalhado).<br>O Zabbix obtém a gravidade do log do campo **Informações** do log de eventos do Windows.| |**logsource** (/host/key,<\#num<:time shift>>,<pattern>)|<|<|<| |<|Verificando se a origem do log da última entrada de log corresponde a uma expressão regular.|Consulte [parâmetros comuns](#common-parameters).<br><br>**\#num** (opcional) - o enésimo número mais valor recente<br><br>**padrão** (opcional) - expressão regular que descreve o padrão necessário, estilo [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) ( argumentos de string devem estar entre aspas duplas).|Tipos de valor suportados: log<br><br>Retorna:<br>0 - não corresponde<br>1 - corresponde<br><br>Normalmente usado para logs de eventos do Windows. Por exemplo, logsource("VMware Server").| |**monodec** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<|<| |<|Verifique se houve uma diminuição monótona nos valores.|Consulte [parâmetros comuns](#common-parameters).<br><br>**modo** (deve estar entre aspas duplas) - *fraco* (todo valor é menor ou igual ao anterior; padrão) ou *strict* (todos os valores diminuíram)|Tipos de valor suportados: int<br><br>Retorna 1 se todos os elementos no período de tempo diminuem continuamente, 0 caso contrário.<br ><br>Exemplo:<br>=> **monodec**(/Host1/system.swap.size\[all,free\],**60s**) + **monodec**(/Host2/system .swap.size\[all,free\],**60s**) + **monodec**(/Host3/system.swap.size\[all,free\],**60s**) - calcule em quantos hosts houve uma diminuição no tamanho do swap gratuito| |**monoinc** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<|<| |<|Verifique se houve um aumento monótono nos valores.|Consulte [parâmetros comuns](#common-parameters).<br><br>**modo** (deve ser entre aspas duplas) - *fraco* ( cada valor é maior ou igual ao anterior; padrão) ou *strict* (todo valor aumentou)|Tipos de valor suportados: int<br><br>Retorna 1 se todos os elementos no período de tempo aumentarem continuamente, 0 caso contrário .<br><br>Exemplo:<br>=> **monoinc**(/Host1/system.localtime,**\#3**,"strict")=0 - verifique se o horário local do sistema está aumentando consistentemente| |**nodata** (/host/chave,seg,<modo>)|<|<|<| |<|Verificando se não há dados recebidos.|Consulte [parâmetros comuns](#common-parameters).<br><br>O período de **s** não deve ser inferior a 30 segundos porque o processo de sincronização de histórico calcula apenas esta função a cada 30 segundos.<br><br>nodata(/host/key,0) não é permitido.<br><br>**mode** - se definido como *strict* (entre aspas duplas), esta função será insensível à disponibilidade do proxy (consulte os comentários para obter detalhes).|Todos os tipos de valor são suportados.<br><br>Retorna:<br>1 - se nenhum dado for recebido durante o período de tempo definido<br>0 - caso contrário<br> <br>Desde o Zabbix 5.0, os gatilhos 'nodata' monitorados pelo proxy são, por padrão, sensíveis à disponibilidade do proxy - se o proxy ficar indisponível, os gatilhos 'nodata' não serão acionados imediatamente após uma conexão restaurada, mas pularão os dados para o período atrasado. Observe que, para proxies passivos, a supressão é ativada se a conexão for restaurada mais de 15 segundos e não menos de 2 e ProxyUpdateFrequency segundos depois. Para proxies ativos, a supressão é ativada se a conexão for restaurada mais de 15 segundos depois.<br><br>Para desativar a sensibilidade à disponibilidade do proxy, use o terceiro parâmetro, por exemplo: **nodata**(/host/key,** 5m**,**"estrito"**); neste caso, a função funcionará da mesma forma que antes de 5.0.0 e disparará assim que o período de avaliação (cinco minutos) sem dados tiver passado.<br><br>Observe que esta função exibirá um erro se, dentro do período do 1º parâmetro:<br>- não há dados e o servidor Zabbix foi reiniciado<br>- não há dados e a manutenção foi concluída<br>- não há dados e o item foi adicionado ou reativado<br>Os erros são exibidos na coluna *Info* no gatilho [configuração](/manual/web_interface/frontend_sections/configuration/hosts/triggers).<br><br>Esta função pode não funcionar corretamente se houver diferenças de horário entre o servidor Zabbix, proxy e agente. Consulte também: [Requisito de sincronização de tempo](/manual/installation/requirements#time_synchronization).| |**percentil** (/host/key,(sec\|\#num)<:time shift>,percentage)|<|<|<| |<|P-ésimo percentil de um período, em que P (porcentagem) é especificado pelo terceiro parâmetro.|Consulte [parâmetros comuns](#common-parameters).<br><br>**porcentagem** - um valor flutuante -ponto número entre 0 e 100 (inclusive) com até 4 dígitos após o ponto decimal|Tipos de valor suportados: float, int| |**taxa** (/host/key,sec<:time shift>)|<|<|<| |<|Taxa média por segundo do aumento em um contador monotonicamente crescente dentro do período de tempo definido.|Consulte [parâmetros comuns](#common-parameters).|Tipos de valor suportados: float, int<br><br>Funcionalmente corresponde a '[rate](https://prometheus.io/docs/prometheus/latest/querying/functions/#rate)' do PromQL.<br><br>Exemplo:<br>=> **rate** (/host/key,**30s**) → Se o aumento monotônico em 30 segundos for 20, esta função retornará 0,67.| |**trendavg** (/host/key, time period:time shift)|<|<|<| |<|Média de valores de tendência dentro do período de tempo definido.|**período de tempo** - o período de tempo (mínimo '1h'), definido como \<N>\<unidade de tempo> onde<br>`N` - número de unidades de tempo<br>`unidade de tempo` - h (hora), d (dia), w (semana), M (mês) ou y (ano).<br><br>[Deslocamento de tempo](/manual /config/triggers/expression#function-specific_parameters) - o deslocamento do período de tempo (veja exemplos)|Exemplos:<br>=> **trendavg**(/host/key,**1h:now/h**) → média para a hora anterior (por exemplo, 12:00-13:00)<br>=> **trendavg**(/host/key,**1h:now/h-1h**) → média para duas horas atrás ( 11:00-12:00)<br>=> **trendavg**(/host/key,**1h:now/h-2h**) → média de três horas atrás (10:00-11:00 )<br>=> **trendavg**(/host/key,**1M:now/M-1y**) → média do mês anterior um ano atrás| |**trendcount** (/host/key, time period:time shift)|<|<|<| |<|Número de valores de tendência recuperados com sucesso dentro do período de tempo definido.|**período de tempo** - o período de tempo (mínimo '1h'), definido como \<N>\<unidade de tempo> onde<br>`N ` - número de unidades de tempo<br>`unidade de tempo` - h (hora), d (dia), w (semana), M (mês) ou y (ano).<br><br>[Time shift]( /manual/config/triggers/expression#function-specific_parameters) - o deslocamento do período de tempo (veja exemplos)|Exemplos:<br>=> **trendcount**(/host/key,**1h:now/h** ) → contar para a hora anterior (por exemplo, 12:00-13:00)<br>=> **trendcount**(/host/key,**1h:now/h-1h**) → contar para duas horas atrás (11:00-12:00)<br>=> **trendcount**(/host/key,**1h:now/h-2h**) → contar por três horas atrás (10:00-11 :00)<br>=> **trendcount**(/host/key,**1M:now/M-1y**) → contagem para o mês anterior um ano atrás| |**trendmax** (/host/key, time period:time shift)|<|<|<| |<|O máximo em valores de tendência dentro do período de tempo definido.|**período de tempo** - o período de tempo (mínimo '1h'), definido como \<N>\<unidade de tempo> onde<br>`N` - número de unidades de tempo<br>`unidade de tempo` - h (hora), d (dia), w (semana), M (mês) ou y (ano).<br><br>[Deslocamento de tempo](/ manual/config/triggers/expression#function-specific_parameters) - o deslocamento do período de tempo (veja exemplos)|Exemplos:<br>=> **trendmax**(/host/key,**1h:now/h**) → máximo para a hora anterior (por exemplo, 12:00-13:00)<br>=> **trendmax**(/host/key,**1h:now/h**) - **trendmin**(/ host/key,**1h:now/h**) → calcule a diferença entre os valores máximo e mínimo (delta de tendência) para a hora anterior (12:00-13:00)<br>=> **trendmax* *(/host/key,**1h:now/h-1h**) → máximo para duas horas atrás (11:00-12:00)<br>=> **trendmax**(/host/key, **1h:agora/h-2h**) → máximo para três horas atrás (10:00-11:00)<br>=> **trendmax**(/host/key,**1M:now/M -1y**) → máximo para o mês anterior há um ano| |**trendmin** (/host/key, time period:time shift)|<|<|<| |<|O mínimo em valores de tendência dentro do período de tempo definido.|**período de tempo** - o período de tempo (mínimo '1h'), definido como \<N>\<unidade de tempo> onde<br>`N` - número de unidades de tempo<br>`unidade de tempo` - h (hora), d (dia), w (semana), M (mês) ou y (ano).<br><br>[Time shift](/manual/config /triggers/expression#function-specific_parameters) - o deslocamento do período de tempo (veja exemplos)|Exemplos:<br>=> **trendmin**(/host/key,**1h:now/h**) → mínimo para a hora anterior (por exemplo, 12:00-13:00)<br>=> **trendmin**(/host/key,**1h:now/h**) - **trendmin**(/host/key ,**1h:agora/h**) → calcule a diferença entre os valores máximo e mínimo (delta de tendência) para a hora anterior (12:00-13:00)<br>=> **trendmin**(/ host/key,**1h:now/h-1h**) → mínimo para duas horas atrás (11:00-12:00)<br>=> **trendmin**(/host/key,**1h :now/h-2h**) → mínimo para três horas atrás (10:00-11:00)<br>=> **trendmin**(/host/key,**1M:now/M-1y* *) → mínimo do mês anterior há um ano| |**trendstl** (/host/key,eval period:time shift,detection period,season,<deviations>,<devalg>,<s_window>)|<|<|<| |<|Retorna uma taxa de anomalia - um valor decimal entre 0 e 1 que é ((o número de valores de anomalia no período de detecção) / (número total de valores no período de detecção).|**período de avaliação** - o período de tempo que deve ser decomposto (mínimo '1h'), definido como \<N>\<unidade de tempo> onde<br>`N` - número de unidades de tempo<br>`unidade de tempo` - h (hora), d (dia ), w (semana), M (mês) ou y (ano).<br><br>[Time shift](/manual/config/triggers/expression#function-specific_parameters) - o deslocamento do período de tempo (veja exemplos) <br><br>**período de detecção** - o período de tempo a partir do final do período de avaliação para o qual as anomalias são calculadas (mínimo '1h', não pode ser maior que o período de avaliação), definido como \<N>\< unidade de tempo> onde<br>`N` - número de unidades de tempo<br>`unidade de tempo` - h (hora), d (dia), w (semana).<br><br>**temporada** - o menor período de tempo em que a sazonalidade (padrões repetidos) é esperada (mínimo '2h', não pode ser maior que o período eval, número de entradas no período eval deve ser maior que os dois tempos do r frequência resultante (estação/h)), definida como \<N>\<unidade de tempo> onde<br>`N` - número de unidades de tempo<br>`unidade de tempo` - h (hora), d (dia), w (semana).<br><br>**desvios** - o número de desvios (calculado com devalg) para contar como anomalia (pode ser decimal), (deve ser maior ou igual a 1, o padrão é 3) <br><br>**devalg** (deve estar entre aspas duplas) - algoritmo de desvio, pode ser *stddevpop*, *stddevsamp* ou *mad* (padrão)<br><br>**s_window** - o intervalo (em atrasos) da janela loess para extração sazonal (o padrão é 10 * número de entradas no período de avaliação + 1)|Exemplos:<br>=> **trendstl**(/host/key,**100h: now/h**,10h,2h) → analisando as últimas 100 horas de dados de tendência,<br>encontre a taxa de anomalias para as 10 horas anteriores desse período,<br>esperando que a periodicidade seja 2h,<br>a os valores da série restante do período de avaliação são considerados anomalias se atingirem o valor de 3 desvios do MAD dessa série restante<br>=> **trendstl**(/host/key,**100h:now/h-10h **,100h,2h,2.1,"louco ") → analisando o período das 100 horas anteriores de dados de tendência, começando a contar 10 horas atrás<br>encontre a taxa de anomalias para todo esse período<br>esperando que a periodicidade seja 2h,<br>os valores da série restante da avaliação período são considerados anomalias se atingirem o valor de 2,1 desvios do MAD dessa série restante<br>=> **trendstl**(/host/key,**100d:now/d-1d**,10d ,1d,4,,10) → analisando os 100 dias anteriores de dados de tendência a partir de um dia atrás,<br>encontre a taxa de anomalias para o período dos últimos 10d desse período,<br>esperando que a periodicidade seja 1d,< br>os valores da série restante do período de avaliação são considerados anomalias se atingirem o valor de 4 desvios do MAD dessa série restante,<br>substituindo o intervalo padrão da janela loess para extração sazonal de "10 * número de entradas in eval period + 1" com intervalo de 10 atrasos<br>=> **trendstl**(/host/key,**1M:now/M-1y**,1d,2h,,"stddevsamp") → mínimo para o mês anterior um ano atrás<br >analisando os dados de tendência do mês anterior a partir de um ano atrás,<br>encontre a taxa de anomalias do último dia desse período<br>esperando que a periodicidade seja 2h,<br>os valores da série restante do período de avaliação são considerados anomalias se atingirem o valor de 3 desvios do desvio padrão da amostra dessa série restante| |**trendsum** (/host/key,time period:time shift)|<|<|<| |<|Soma dos valores de tendência dentro do período de tempo definido.|**período de tempo** - o período de tempo (mínimo '1h'), definido como \<N>\<unidade de tempo> onde<br>`N` - número de tempo unidades<br>`unidade de tempo` - h (hora), d (dia), w (semana), M (mês) ou y (ano).<br><br>[Time shift](/manual/config/ triggers/expression#function-specific_parameters) - o deslocamento do período de tempo (veja exemplos)|Exemplos:<br>=> **trendsum**(/host/key,**1h:now/h**) → soma para o hora anterior (por exemplo, 12:00-13:00)<br>=> **trendsum**(/host/key,**1h:now/h-1h**) → soma de duas horas atrás (11:00 -12:00)<br>=> **trendsum**(/host/key,**1h:now/h-2h**) → soma de três horas atrás (10:00-11:00)<br >=> **trendsum**(/host/key,**1M:now/M-1y**) → soma para o mês anterior um ano atrás|

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

en-us	# > History object  The following objects are directly related to the `history` API.  ::: noteclassic History objects differ depending on the item's type of information. They are created by the Zabbix server and cannot be modified via the API. :::
pt-br	# > Objeto histórico  Os objetos a seguir estão diretamente relacionados à API `history`.  ::: noteclassic Os objetos de histórico diferem dependendo do tipo de em formação. Eles são criados pelo servidor Zabbix e não podem ser modificado por meio da API. :::

en-us	#### History  Retrieve historical values gathered by Zabbix monitoring processes for presentation or further processing.  [History API](/manual/api/reference/history)
pt-br	#### História  Recupere valores históricos coletados pelos processos de monitoramento do Zabbix para apresentação ou processamento posterior.  [API de histórico](/manual/api/reference/history)

en-us	# History  This class is designed to work with history data.  Object references:\  -   [History](/manual/api/reference/history/object#history)  Available methods:\  -   [history.get](/manual/api/reference/history/get) - retrieving     history data.
pt-br	# História  Esta classe foi projetada para trabalhar com dados de histórico.  Referências de objetos:\  - [Histórico](/manual/api/reference/history/object#history)  Métodos disponíveis:\  - [history.get](/manual/api/reference/history/get) - recuperando     dados do histórico.

en-us	 ### HMAC function for JavaScript  A new function has been added to the JavaScript engine allowing to return HMAC hash:  -   `hmac('<hash type>',key,string)`  This is useful for cases when hash-based message authentication code (HMAC) is required for signing requests. MD5 and SHA256 hash types are supported, e. g.:     -   `hmac('md5',key,string)`    -   `hmac('sha256',key,string)`
pt-br	### Função HMAC para JavaScript  Uma nova função foi adicionada ao mecanismo JavaScript permitindo retornar um hash HMAC:  -   `hmac('<hash type>',key,string)`   Essa função é util em casos em que é necessário um código de autenticação de mensagem baseado em hash (HMAC) para assinar solicitações.  Os tipos de hash MD5 e SHA256 são suportados, e. g.:     -   `hmac('md5',key,string)`    -   `hmac('sha256',key,string)`

en-us	#### Host access from several user groups  A user may belong to any number of user groups. These groups may have different access permissions to hosts.  Therefore, it is important to know what hosts an unprivileged user will be able to access as a result. For example, let us consider how access to host **X** (in Hostgroup 1) will be affected in various situations for a user who is in user groups A and B.  -   If Group A has only *Read* access to Hostgroup 1, but Group B     *Read-write* access to Hostgroup 1, the user will get **Read-write**     access to 'X'.  ::: noteimportant “Read-write” permissions have precedence over “Read” permissions starting with Zabbix 2.2. :::  -   In the same scenario as above, if 'X' is simultaneously also in     Hostgroup 2 that is **denied** to Group A or B, access to 'X' will     be **unavailable**, despite a *Read-write* access to Hostgroup 1. -   If Group A has no permissions defined and Group B has a *Read-write*     access to Hostgroup 1, the user will get **Read-write** access to     'X'. -   If Group A has *Deny* access to Hostgroup 1 and Group B has a     *Read-write* access to Hostgroup 1, the user will get access to 'X'     **denied**.
pt-br	#### Acesso ao host de vários grupos de usuários  Um usuário pode pertencer a qualquer número de grupos de usuários. Esses grupos podem ter diferentes permissões de acesso aos hosts.  Portanto, é importante saber quais hosts um usuário sem privilégios poder acessar como resultado. Por exemplo, vamos considerar como o acesso para hospedar **X** (no Hostgroup 1) será afetado em várias situações para um usuário que está nos grupos de usuários A e B.  - Se o Grupo A tiver apenas acesso de *Leitura* ao Grupo de hosts 1, mas ao Grupo B     Acesso de *Leitura-gravação* ao Hostgroup 1, o usuário receberá **Leitura-gravação**     acesso a 'X'.  ::: não importante As permissões de “leitura-gravação” têm precedência sobre Permissões de “leitura” a partir do Zabbix 2.2. :::  - No mesmo cenário acima, se 'X' estiver simultaneamente também em     Hostgroup 2 que é **negado** ao Grupo A ou B, o acesso a 'X' será     ser **indisponível**, apesar de um acesso de *Leitura-gravação* ao Hostgroup 1. - Se o Grupo A não tiver permissões definidas e o Grupo B tiver um *Read-write*     acesso ao Hostgroup 1, o usuário terá acesso **Read-write**     'X'. - Se o Grupo A tiver *Negar* acesso ao Hostgroup 1 e o Grupo B tiver um     *Ler-escrever* acesso ao Hostgroup 1, o usuário terá acesso a 'X'     **negado**.

en-us	#### Host configuration  To use VMware simple checks the host must have the following user macros defined:  -   **{$VMWARE.URL}** - VMware service (vCenter or ESX hypervisor) SDK     URL (<https://servername/sdk>) -   **{$VMWARE.USERNAME}** - VMware service user name -   **{$VMWARE.PASSWORD}** - VMware service {$VMWARE.USERNAME} user     password
pt-br	#### Configuração do host  Para usar verificações simples do VMware, o host deve ter as seguintes macros de usuário definidas - **{$VMWARE.URL}** - SDK de serviço VMware (vCenter ou hipervisor ESX)      URL (<https://servername/sdk>) - **{$VMWARE.USERNAME}** - Nome de usuário do serviço VMware - **{$VMWARE.PASSWORD}** - Serviço VMware {$VMWARE.USERNAME} usuário  senha

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

en-us	##### Host creation  A host is added if the *Add host* operation is selected. A host is also added, even if the *Add host* operation is missing, if you select operations resulting in actions on a host. Such operations are:  -   enable host -   disable host -   add host to a host group -   link template to a host  Created hosts are added to the *Discovered hosts* group (by default, configurable in *Administration* → *General* → *[Other](/manual/web_interface/frontend_sections/administration/general#other_parameters)*). If you wish hosts to be added to another group, add a *Remove from host groups* operation (specifying "Discovered hosts") and also add an *Add to host groups* operation (specifying another host group), because a host must belong to a host group.
pt-br	##### Criação de host  Um host é adicionado se a operação *Add host* for selecionada. Um anfitrião também adicionado, mesmo se a operação *Add host* estiver ausente, se você selecionar operações que resultam em ações em um host. Tais operações são:  - habilitar host - desabilitar host - adicionar host a um grupo de hosts - modelo de link para um host  Os hosts criados são adicionados ao grupo *Anfitriões descobertos* (por padrão, configurável em *Administração* → *Geral* → *[Outro](/manual/web_interface/frontend_sections/administration/general#other_parameters)*). Se você deseja que os hosts sejam adicionados a outro grupo, adicione um *Remove from host groups* (especificando "Anfitriões descobertos") e também adicionar um *Add para hospedar grupos* operação (especificando outro grupo de hosts), porque um host deve pertencer a um grupo de hosts.

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

en-us	#### Host editing as popup  The form for host creation and editing is now opened in a modal (popup) window, in *Configuration* → *Hosts*, *Monitoring* → *Hosts* and in any page, where there is a host menu or other direct link to the host configuration.  Direct links to the host edit page still work and are opening the host edit page in full page.
pt-br	#### Edição de host como pop-up  O formulário para criação e edição de host agora é aberto em uma janela modal (pop-up) em *Configuration* → *Hosts*, *Monitoring* → *Hosts* e em qualquer página, onde houver um menu de host ou outro link direto para a configuração do host configuração.  Os links diretos para a página de edição do host ainda funcionam e estão abrindo a página de edição do host em página inteira página de edição do host em página inteira.

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

en-us	##### Host graph tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |graphs|<|\-|<|<|Root element for graphs.| |<|name|x|`string`|<|Graph name.| |<|width|\-|`integer`|20-65535 (default: 900)|Graph width, in pixels. Used for preview and for pie/exploded graphs.| |<|height|\-|`integer`|20-65535 (default: 200)|Graph height, in pixels. Used for preview and for pie/exploded graphs.| |<|yaxismin|\-|`double`|Default: 0|Value of Y axis minimum.<br><br>Used if 'ymin\_type\_1' is FIXED.| |<|yaxismax|\-|`double`|Default: 0|Value of Y axis maximum.<br><br>Used if 'ymax\_type\_1' is FIXED.| |<|show\_work\_period|\-|`string`|0 - NO<br>1 - YES (default)|Highlight non-working hours.<br><br>Used by normal and stacked graphs.| |<|show\_triggers|\-|`string`|0 - NO<br>1 - YES (default)|Display simple trigger values as a line.<br><br>Used by normal and stacked graphs.| |<|type|\-|`string`|0 - NORMAL (default)<br>1 - STACKED<br>2 - PIE<br>3 - EXPLODED|Graph type.| |<|show\_legend|\-|`string`|0 - NO<br>1 - YES (default)|Display graph legend.| |<|show\_3d|\-|`string`|0 - NO (default)<br>1 - YES|Enable 3D style.<br><br>Used by pie and exploded pie graphs.| |<|percent\_left|\-|`double`|Default:0|Show the percentile line for left axis.<br><br>Used only for normal graphs.| |<|percent\_right|\-|`double`|Default:0|Show the percentile line for right axis.<br><br>Used only for normal graphs.| |<|ymin\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Minimum value of Y axis.<br><br>Used by normal and stacked graphs.| |<|ymax\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Maximum value of Y axis.<br><br>Used by normal and stacked graphs.| |ymin\_item\_1|<|\-|<|<|Individual item details.<br><br>Required if 'ymin\_type\_1' is ITEM.| |<|host|x|`string`|<|Item host.| |<|key|x|`string`|<|Item key.| |ymax\_item\_1|<|\-|<|<|Individual item details.<br><br>Required if 'ymax\_type\_1' is ITEM.| |<|host|x|`string`|<|Item host.| |<|key|x|`string`|<|Item key.| |graph\_items|<|x|<|<|Root element for graph items.| |<|sortorder|\-|`integer`|<|Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.| |<|drawtype|\-|`string`|0 - SINGLE\_LINE (default)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Draw style of the graph item.<br><br>Used only by normal graphs.| |<|color|\-|`string`|<|Element color (6 symbols, hex).| |<|yaxisside|\-|`string`|0 - LEFT (default)<br>1 - RIGHT|Side of the graph where the graph item's Y scale will be drawn.<br><br>Used by normal and stacked graphs.| |<|calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (default)<br>4 - MAX<br>7 - ALL (minimum, average and maximum; used only by simple graphs)<br>9 - LAST (used only by pie and exploded pie graphs)|Data to draw if more than one value exists for an item.| |<|type|\-|`string`|0 - SIMPLE (default)<br>2 - GRAPH\_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)|Graph item type.| |item|<|x|<|<|Individual item.| |<|host|x|`string`|<|Item host.| |<|key|x|`string`|<|Item key.|
pt-br	##### Tags do gráfico do host  |Elemento|Propriedade do elemento|Requerido|Tipo|Intervalo^**[1](#footnotes)**^|Descrição| |-------|----------------|--------|----|---------- -----|-----------| |gráficos|<|\-|<|<|Elemento raiz para gráficos.| |<|nome|x|`string`|<|Nome do gráfico.| |<|width|\-|`integer`|20-65535 (padrão: 900)|Largura do gráfico, em pixels. Usado para visualização e para gráficos de pizza/explodidos.| |<|altura|\-|`inteiro`|20-65535 (padrão: 200)|Altura do gráfico, em pixels. Usado para visualização e para gráficos de pizza/explodidos.| |<|yaxismin|\-|`double`|Padrão: 0|Valor mínimo do eixo Y.<br><br>Usado se 'ymin\_type\_1' for FIXED.| |<|yaxismax|\-|`double`|Padrão: 0|Valor máximo do eixo Y.<br><br>Usado se 'ymax\_type\_1' for FIXED.| |<|show\_work\_period|\-|`string`|0 - NÃO<br>1 - SIM (padrão)|Realçar horas de folga.<br><br>Usado por gráficos normais e empilhados.| |<|show\_triggers|\-|`string`|0 - NO<br>1 - YES (padrão)|Exibe valores de trigger simples como uma linha.<br><br>Usado por gráficos normais e empilhados.| |<|tipo|\-|`string`|0 - NORMAL (padrão)<br>1 - EMPILHADO<br>2 - TORTA<br>3 - EXPLODIDO|Tipo de gráfico.| |<|show\_legend|\-|`string`|0 - NÃO<br>1 - SIM (padrão)|Exibe legenda do gráfico.| |<|show\_3d|\-|`string`|0 - NO (padrão)<br>1 - YES|Ativar estilo 3D.<br><br>Usado por pizza e gráficos de pizza explodidos.| |<|percent\_left|\-|`double`|Default:0|Mostra a linha de percentil para o eixo esquerdo.<br><br>Usado apenas para gráficos normais.| |<|percent\_right|\-|`double`|Default:0|Mostra a linha de percentil para o eixo direito.<br><br>Usado apenas para gráficos normais.| |<|ymin\_type\_1|\-|`string`|0 - CALCULATED (padrão)<br>1 - FIXED<br>2 - ITEM|Valor mínimo do eixo Y.<br><br>Usado por normal e gráficos empilhados.| |<|ymax\_type\_1|\-|`string`|0 - CALCULATED (padrão)<br>1 - FIXED<br>2 - ITEM|Valor máximo do eixo Y.<br><br>Usado por normal e gráficos empilhados.| |ymin\_item\_1|<|\-|<|<|Detalhes do item individual.<br><br>Obrigatório se 'ymin\_type\_1' for ITEM.| |<|host|x|`string`|<|Anfitrião do item.| |<|chave|x|`string`|<|chave do item.| |ymax\_item\_1|<|\-|<|<|Detalhes do item individual.<br><br>Obrigatório se 'ymax\_type\_1' for ITEM.| |<|host|x|`string`|<|Anfitrião do item.| |<|chave|x|`string`|<|chave do item.| |graph\_items|<|x|<|<|Elemento raiz para itens de gráfico.| |<|sortorder|\-|`integer`|<|Ordem de sorteio. O valor menor é sorteado primeiro. Pode ser usado para desenhar linhas ou regiões atrás (ou na frente) de outra.| |<|drawtype|\-|`string`|0 - SINGLE\_LINE (padrão)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - TRAÇADO \_LINE<br>5 - GRADIENT\_LINE|Estilo de desenho do item gráfico.<br><br>Usado apenas por gráficos normais.| |<|color|\-|`string`|<|Cor do elemento (6 símbolos, hex).| |<|yaxisside|\-|`string`|0 - LEFT (padrão)<br>1 - RIGHT|Lado do gráfico onde a escala Y do item do gráfico será desenhada.<br><br>Usado por normal e empilhado gráficos.| |<|calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (padrão)<br>4 - MAX<br>7 - ALL (mínimo, médio e máximo; usado apenas por gráficos simples )<br>9 - LAST (usado apenas por gráficos de pizza e gráficos de pizza explodidos)|Dados a serem desenhados se existir mais de um valor para um item.| |<|type|\-|`string`|0 - SIMPLE (padrão)<br>2 - GRAPH\_SUM (o valor do item representa a pizza inteira; usado apenas por gráficos de pizza e explodidos)|Tipo de item de gráfico. | |item|<|x|<|<|item individual.| |<|host|x|`string`|<|Anfitrião do item.| |<|chave|x|`string`|<|chave do item.|

en-us	#### host group  Changes:\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massupdate`: `hosts` and `templates` fields are now required.\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massadd`, `hostgroup.massupdate`, `hostgroup.massremove`: added strict validation of the method parameters.\
pt-br	#### grupo de host  Mudanças:\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massupdate`: `hosts` e`templates` os campos agora são obrigatórios.\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massadd`, `hostgroup.massupdate`, `hostgroup.massremove`: adicionada validação estrita dos parâmetros do método.\

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

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

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

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

en-us	# hostgroup.massadd
pt-br	# hostgroup.massadd

en-us	# hostgroup.massremove
pt-br	# hostgroup.massremove

en-us	# hostgroup.massupdate
pt-br	# hostgroup.massupdate

en-us	# > Host group object  The following objects are directly related to the `hostgroup` API.
pt-br	# > Objeto do grupo de hosts  Os objetos a seguir estão diretamente relacionados à API `hostgroup`.

en-us	### Host group  The host group object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupid|string|*(readonly)* ID of the host group.| |**name**<br>(required)|string|Name of the host group.| |flags|integer|*(readonly)* Origin of the host group.<br><br>Possible values:<br>0 - a plain host group;<br>4 - a discovered host group.| |internal|integer|*(readonly)* Whether the group is used internally by the system. An internal group cannot be deleted.<br><br>Possible values:<br>0 - *(default)* not internal;<br>1 - internal.| |uuid|string|Universal unique identifier, used for linking imported host groups to already existing ones. Auto-generated, if not given.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
pt-br	### Grupo de hosts  O objeto de grupo de hosts possui as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |groupid|string|*(somente leitura)* ID of the host group.| |**nome**<br>(obrigatório)|string|Nome do grupo de hosts.| |flags|inteiro|*(somente leitura)* Origem do grupo de hosts.<br><br>Valores possíveis:<br>0 - um grupo de hosts simples;<br>4 - um grupo de host de descoberta.| |internal|inteiro|*(somente leitura)* Se o grupo é usado internamente pelo sistema. Um grupo interno não pode ser excluído.<br><br>Valores possíveis:<br>0 - *(padrão)* não interno;<br>1 - interno.| |uuid|string|Identificador universal exclusivo, usado para vincular grupos de hosts importados a grupos já existentes. Gerado automaticamente, se não fornecido.|  Observe que para alguns métodos (atualização, exclusão), a combinação de parâmetros obrigatórios/opcionais é diferente.

en-us	# Host group  This class is designed to work with host groups.  Object references:\  -   [Host group](/manual/api/reference/hostgroup/object#host_group)  Available methods:\  -   [hostgroup.create](/manual/api/reference/hostgroup/create) -     creating new host groups -   [hostgroup.delete](/manual/api/reference/hostgroup/delete) -     deleting host groups -   [hostgroup.get](/manual/api/reference/hostgroup/get) - retrieving     host groups -   [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) -     adding related objects to host groups -   [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) -     removing related objects from host groups -   [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) -     replacing or removing related objects from host groups -   [hostgroup.update](/manual/api/reference/hostgroup/update) -     updating host groups
pt-br	# Grupo de anfitriões  Esta classe foi projetada para trabalhar com grupos de hosts.  Referências de objetos:\  - [Grupo de hosts](/manual/api/reference/hostgroup/object#host_group)  Métodos disponíveis:\  - [hostgroup.create](/manual/api/reference/hostgroup/create) -     criando novos grupos de hosts - [hostgroup.delete](/manual/api/reference/hostgroup/delete) -     excluindo grupos de hosts - [hostgroup.get](/manual/api/reference/hostgroup/get) - recuperando     grupos de hosts - [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) -     adicionando objetos relacionados a grupos de hosts - [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) -     removendo objetos relacionados de grupos de hosts - [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) -     substituindo ou removendo objetos relacionados de grupos de hosts - [hostgroup.update](/manual/api/reference/hostgroup/update) -     atualizando grupos de hosts

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

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

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

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

en-us	# hostinterface.massadd
pt-br	## hostinterface.massadd

en-us	# hostinterface.massremove
pt-br	## hostinterface.massremove

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

en-us	# hostinterface.replacehostinterfaces
pt-br	# hostinterface.replacehostinterfaces

en-us	### Host interface  The host interface object has the following properties.  ::: noteimportant Note that both IP and DNS are required. If you do not want to use DNS, set it to an empty string. :::  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |available|integer|*(readonly)* Availability of host interface.<br><br>Possible values are:<br>0 - *(default)* unknown;<br>1 - available;<br>2 - unavailable.| |details|array|Additional object for interface. **Required** if interface 'type' is SNMP.| |disable\_until|timestamp|*(readonly)* The next polling time of an unavailable host interface.| |**dns**<br>(required)|string|DNS name used by the interface.<br><br>Can be empty if the connection is made via IP.| |error|string|*(readonly)* Error text if host interface is unavailable.| |errors\_from|timestamp|*(readonly)* Time when host interface became unavailable.| |**hostid**<br>(required)|string|ID of the host the interface belongs to.| |interfaceid|string|*(readonly)* ID of the interface.| |**ip**<br>(required)|string|IP address used by the interface.<br><br>Can be empty if the connection is made via DNS.| |**main**<br>(required)|integer|Whether the interface is used as default on the host. Only one interface of some type can be set as default on a host.<br><br>Possible values are:<br>0 - not default;<br>1 - default.| |**port**<br>(required)|string|Port number used by the interface. Can contain user macros.| |**type**<br>(required)|integer|Interface type.<br><br>Possible values are:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br>| |**useip**<br>(required)|integer|Whether the connection should be made via IP.<br><br>Possible values are:<br>0 - connect using host DNS name;<br>1 - connect using host IP address for this host interface.|
pt-br	### Interface do host  O objeto de interface do host tem as seguintes propriedades.  ::: não importante Observe que IP e DNS são necessários. Se você fizer não quiser usar o DNS, defina-o como uma string vazia. :::  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |disponível|inteiro|*(somente leitura)* Disponibilidade da interface do host.<br><br>Os valores possíveis são:<br>0 - *(padrão)* desconhecido;<br>1 - disponível;<br>2 - indisponível .| |details|array|Objeto adicional para interface. **Obrigatório** se o 'tipo' da interface for SNMP.| |disable\_until|timestamp|*(readonly)* O próximo horário de polling de uma interface de host indisponível.| |**dns**<br>(obrigatório)|string|nome DNS usado pela interface.<br><br>Pode estar vazio se a conexão for feita via IP.| |error|string|*(readonly)* Texto de erro se a interface do host não estiver disponível.| |errors\_from|timestamp|*(readonly)* Hora em que a interface do host ficou indisponível.| |**hostid**<br>(obrigatório)|string|ID do host ao qual a interface pertence.| |interfaceid|string|*(readonly)* ID da interface.| |**ip**<br>(obrigatório)|string|endereço IP usado pela interface.<br><br>Pode estar vazio se a conexão for feita via DNS.| |**main**<br>(obrigatório)|integer|Se a interface é usada como padrão no host. Apenas uma interface de algum tipo pode ser definida como padrão em um host.<br><br>Os valores possíveis são:<br>0 - não padrão;<br>1 - padrão.| |**port**<br>(obrigatório)|string|Número da porta usada pela interface. Pode conter macros de usuário.| |**tipo**<br>(obrigatório)|inteiro|Tipo de interface.<br><br>Os valores possíveis são:<br>1 - agente;<br>2 - SNMP;<br>3 - IPMI;< br>4 - JMX.<br>| |**useip**<br>(obrigatório)|inteiro|Se a conexão deve ser feita via IP.<br><br>Os valores possíveis são:<br>0 - conectar usando o nome DNS do host;<br>1 - conecte-se usando o endereço IP do host para esta interface do host.|

en-us	# Host interface  This class is designed to work with host interfaces.  Object references:\  -   [Host     interface](/manual/api/reference/hostinterface/object#host_interface)  Available methods:\  -   [hostinterface.create](/manual/api/reference/hostinterface/create) -     creating new host interfaces -   [hostinterface.delete](/manual/api/reference/hostinterface/delete) -     deleting host interfaces -   [hostinterface.get](/manual/api/reference/hostinterface/get) -     retrieving host interfaces -   [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) -     adding host interfaces to hosts -   [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) -     removing host interfaces from hosts -   [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) -     replacing host interfaces on a host -   [hostinterface.update](/manual/api/reference/hostinterface/update) -     updating host interfaces
pt-br	#Interface do host  Esta classe foi projetada para trabalhar com interfaces de host.  Referências de objetos:\  -   [Hospedeiro     interface](/manual/api/reference/hostinterface/object#host_interface)  Métodos disponíveis:\  - [hostinterface.create](/manual/api/reference/hostinterface/create) -     criando novas interfaces de host - [hostinterface.delete](/manual/api/reference/hostinterface/delete) -     excluindo interfaces de host - [hostinterface.get](/manual/api/reference/hostinterface/get) -     recuperando interfaces de host - [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) -     adicionando interfaces de host a hosts - [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) -     removendo interfaces de host de hosts - [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) -     substituindo interfaces de host em um host - [hostinterface.update](/manual/api/reference/hostinterface/update) -     atualizando interfaces de host

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

en-us	### Host inventory  The host inventory object has the following properties.  ::: notetip Each property has it's own unique ID number, which is used to associate host inventory fields with items. :::  |ID|Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--------|---------------------------------------------------|-----------| |4|alias|string|Alias.| |11|asset\_tag|string|Asset tag.| |28|chassis|string|Chassis.| |23|contact|string|Contact person.| |32|contract\_number|string|Contract number.| |47|date\_hw\_decomm|string|HW decommissioning date.| |46|date\_hw\_expiry|string|HW maintenance expiry date.| |45|date\_hw\_install|string|HW installation date.| |44|date\_hw\_purchase|string|HW purchase date.| |34|deployment\_status|string|Deployment status.| |14|hardware|string|Hardware.| |15|hardware\_full|string|Detailed hardware.| |39|host\_netmask|string|Host subnet mask.| |38|host\_networks|string|Host networks.| |40|host\_router|string|Host router.| |30|hw\_arch|string|HW architecture.| |33|installer\_name|string|Installer name.| |24|location|string|Location.| |25|location\_lat|string|Location latitude.| |26|location\_lon|string|Location longitude.| |12|macaddress\_a|string|MAC address A.| |13|macaddress\_b|string|MAC address B.| |29|model|string|Model.| |3|name|string|Name.| |27|notes|string|Notes.| |41|oob\_ip|string|OOB IP address.| |42|oob\_netmask|string|OOB host subnet mask.| |43|oob\_router|string|OOB router.| |5|os|string|OS name.| |6|os\_full|string|Detailed OS name.| |7|os\_short|string|Short OS name.| |61|poc\_1\_cell|string|Primary POC mobile number.| |58|poc\_1\_email|string|Primary email.| |57|poc\_1\_name|string|Primary POC name.| |63|poc\_1\_notes|string|Primary POC notes.| |59|poc\_1\_phone\_a|string|Primary POC phone A.| |60|poc\_1\_phone\_b|string|Primary POC phone B.| |62|poc\_1\_screen|string|Primary POC screen name.| |68|poc\_2\_cell|string|Secondary POC mobile number.| |65|poc\_2\_email|string|Secondary POC email.| |64|poc\_2\_name|string|Secondary POC name.| |70|poc\_2\_notes|string|Secondary POC notes.| |66|poc\_2\_phone\_a|string|Secondary POC phone A.| |67|poc\_2\_phone\_b|string|Secondary POC phone B.| |69|poc\_2\_screen|string|Secondary POC screen name.| |8|serialno\_a|string|Serial number A.| |9|serialno\_b|string|Serial number B.| |48|site\_address\_a|string|Site address A.| |49|site\_address\_b|string|Site address B.| |50|site\_address\_c|string|Site address C.| |51|site\_city|string|Site city.| |53|site\_country|string|Site country.| |56|site\_notes|string|Site notes.| |55|site\_rack|string|Site rack location.| |52|site\_state|string|Site state.| |54|site\_zip|string|Site ZIP/postal code.| |16|software|string|Software.| |18|software\_app\_a|string|Software application A.| |19|software\_app\_b|string|Software application B.| |20|software\_app\_c|string|Software application C.| |21|software\_app\_d|string|Software application D.| |22|software\_app\_e|string|Software application E.| |17|software\_full|string|Software details.| |10|tag|string|Tag.| |1|type|string|Type.| |2|type\_full|string|Type details.| |35|url\_a|string|URL A.| |36|url\_b|string|URL B.| |37|url\_c|string|URL C.| |31|vendor|string|Vendor.|
pt-br	### Inventário de host  O objeto de inventário do host tem as seguintes propriedades.  ::: dica Cada propriedade tem seu próprio número de identificação exclusivo, que é usado para associar campos de inventário de host a itens. :::  |ID|Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--------|------------------------------------- --------------|-----------| |4|alias|string|Alias.| |11|ativo\_tag|string|Etiqueta do ativo.| |28|chassis|string|chassis.| |23|contato|string|Pessoa de contato.| |32|contrato\_número|string|Número do contrato.| |47|data\_hw\_decomm|string|data de desativação do HW.| |46|data\_hw\_expiry|string|data de expiração da manutenção do HW.| |45|data\_hw\_install|string|data de instalação do HW.| |44|data\_hw\_purchase|string|data de compra do HW.| |34|implantação\_status|string|Status da implantação.| |14|hardware|string|Hardware.| |15|hardware\_full|string|Hardware detalhado.| |39|host\_netmask|string|Máscara de sub-rede do host.| |38|host\_networks|string|Redes de host.| |40|host\_router|string|Roteador host.| |30|hw\_arch|string|arquitetura HW.| |33|instalador\_name|string|Nome do instalador.| |24|localização|string|Localização.| |25|local\_lat|string|Latitude do local.| |26|local\_lon|string|Longitude do local.| |12|macaddress\_a|string|endereço MAC A.| |13|macaddress\_b|string|endereço MAC B.| |29|modelo|string|Modelo.| |3|nome|string|Nome.| |27|notas|cadeia|Notas.| |41|oob\_ip|string|endereço IP OOB.| |42|oob\_netmask|string|máscara de sub-rede do host OOB.| |43|oob\_router|string|roteador OOB.| |5|os|string|Nome do SO.| |6|os\_full|string|Nome detalhado do SO.| |7|os\_short|string|Nome curto do SO.| |61|poc\_1\_cell|string|Número de celular POC principal.| |58|poc\_1\_email|string|E-mail principal.| |57|poc\_1\_name|string|Nome POC principal.| |63|poc\_1\_notes|string|Notas POC primárias.| |59|poc\_1\_phone\_a|string|Telefone POC principal A.| |60|poc\_1\_phone\_b|string|Telefone POC principal B.| |62|poc\_1\_screen|string|Nome da tela POC principal.| |68|poc\_2\_cell|string|Número de celular POC secundário.| |65|poc\_2\_email|string|E-mail POC secundário.| |64|poc\_2\_name|string|Nome do POC secundário.| |70|poc\_2\_notes|string|Notas POC secundárias.| |66|poc\_2\_phone\_a|string|Telefone POC secundário A.| |67|poc\_2\_phone\_b|string|Telefone POC secundário B.| |69|poc\_2\_screen|string|Nome de tela POC secundário.| |8|serialno\_a|string|Número de série A.| |9|serialno\_b|string|Número de série B.| |48|site\_address\_a|string|Endereço do site A.| |49|site\_address\_b|string|Endereço do site B.| |50|site\_address\_c|string|Endereço do site C.| |51|site\_city|string|Site city.| |53|site\_country|string|País do site.| |56|site\_notes|string|Notas do site.| |55|site\_rack|string|Localização do rack do site.| |52|site\_state|string|Estado do site.| |54|site\_zip|string|CEP do site/código postal.| |16|software|string|Software.| |18|software\_app\_a|string|Aplicativo de software A.| |19|software\_app\_b|string|Aplicativo de software B.| |20|software\_app\_c|string|Aplicativo de software C.| |21|software\_app\_d|string|Aplicativo de software D.| |22|software\_app\_e|string|Aplicativo de software E.| |17|software\_full|string|Detalhes do software.| |10|tag|string|Tag.| |1|tipo|string|Tipo.| |2|type\_full|string|Digite detalhes.| |35|url\_a|string|URL A.| |36|url\_b|string|URL B.| |37|url\_c|string|URL C.| |31|fornecedor|string|Fornecedor.|

en-us	##### Host item tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |items|<|\-|<|<|Root element for items.| |<|name|x|`string`|<|Item name.| |<|type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>15 - CALCULATED<br>16 - JMX<br>17 - SNMP\_TRAP<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT<br>21 - ITEM\_TYPE\_SCRIPT|Item type.| |<|snmp\_oid|\-|`string`|<|SNMP object ID.<br><br>Required by SNMP items.| |<|key|x|`string`|<|Item key.| |<|delay|\-|`string`|Default: 1m|Update interval of the item.<br><br>Note that `delay` will be always '0' for trapper items.<br><br>Accepts seconds or a time unit with suffix (30s, 1m, 2h, 1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).| |<|history|\-|`string`|Default: 90d|A time unit of how long the history data should be stored. Time unit with suffix, user macro or LLD macro.| |<|trends|\-|`string`|Default: 365d|A time unit of how long the trends data should be stored. Time unit with suffix, user macro or LLD macro.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Item status.| |<|value\_type|\-|`string`|0 - FLOAT<br>1 - CHAR<br>2 - LOG<br>3 - UNSIGNED (default)<br>4 - TEXT|Received value type.| |<|allowed\_hosts|\-|`string`|<|List of IP addresses (comma delimited) of hosts allowed sending data for the item.<br><br>Used by trapper and HTTP agent items.| |<|units|\-|`string`|<|Units of returned values (bps, B, etc).| |<|params|\-|`text`|<|Additional parameters depending on the type of the item:<br>- executed script for Script, SSH and Telnet items;<br>- SQL query for database monitor items;<br>- formula for calculated items.| |<|ipmi\_sensor|\-|`string`|<|IPMI sensor.<br><br>Used only by IPMI items.| |<|authtype|\-|`string`|Authentication type for SSH agent items:<br>0 - PASSWORD (default)<br>1 - PUBLIC\_KEY<br><br>Authentication type for HTTP agent items:<br>0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication type.<br><br>Used only by SSH and HTTP agent items.| |<|username|\-|`string`|<|Username for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>Required by SSH and Telnet items.<br>When used by JMX agent, password should also be specified together with the username or both properties should be left blank.| |<|password|\-|`string`|<|Password for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>When used by JMX agent, username should also be specified together with the password or both properties should be left blank.| |<|publickey|\-|`string`|<|Name of the public key file.<br><br>Required for SSH agent items.| |<|privatekey|\-|`string`|<|Name of the private key file.<br><br>Required for SSH agent items.| |<|description|\-|`text`|<|Item description.| |<|inventory\_link|\-|`string`|0 - NONE<br><br>Capitalized host inventory field name. For example:<br>4 - ALIAS<br>6 - OS\_FULL<br>14 - HARDWARE<br>etc.|Host inventory field that is populated by the item.<br><br>Refer to the [host inventory page](/manual/api/reference/host/object#host_inventory) for a list of supported host inventory fields and their IDs.| |<|logtimefmt|\-|`string`|<|Format of the time in log entries.<br>Used only by log items.| |<|interface\_ref|\-|`string`|Format: `if<N>`|Reference to the host interface.| |<|jmx\_endpoint|\-|`string`|<|JMX endpoint.<br><br>Used only by JMX agent items.| |<|url|\-|`string`|<|URL string.<br><br>Required only for HTTP agent items.| |<|allow\_traps|\-|`string`|0 - NO (default)<br>1 - YES|Allow to populate value as in a trapper item.<br><br>Used only by HTTP agent items.| |<|follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP response redirects while pooling data.<br><br>Used only by HTTP agent items.| |headers|<|\-|<|<|Root element for HTTP(S) request headers, where header name is used as key and header value as value.<br>Used only by HTTP agent items.| |<|name|x|`string`|<|Header name.| |<|value|x|`string`|<|Header value.| |<|http\_proxy|\-|`string`|<|HTTP(S) proxy connection string.<br><br>Used only by HTTP agent items.| |<|output\_format|\-|`string`|0 - RAW (default)<br>1 - JSON|How to process response.<br><br>Used only by HTTP agent items.| |<|post\_type|\-|`string`|0 - RAW (default)<br>2 - JSON<br>3 - XML|Type of post data body.<br><br>Used only by HTTP agent items.| |<|posts|\-|`string`|<|HTTP(S) request body data.<br><br>Used only by HTTP agent items.| |query\_fields|<|\-|<|<|Root element for query parameters.<br><br>Used only by HTTP agent items.| |<|name|x|`string`|<|Parameter name.| |<|value|\-|`string`|<|Parameter value.| |<|request\_method|\-|`string`|0 - GET (default)<br>1 - POST<br>2 - PUT<br>3 - HEAD|Request method.<br><br>Used only by HTTP agent items.| |<|retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|What part of response should be stored.<br><br>Used only by HTTP agent items.| |<|ssl\_cert\_file|\-|`string`|<|Public SSL Key file path.<br><br>Used only by HTTP agent items.| |<|ssl\_key\_file|\-|`string`|<|Private SSL Key file path.<br><br>Used only by HTTP agent items.| |<|ssl\_key\_password|\-|`string`|<|Password for SSL Key file.<br><br>Used only by HTTP agent items.| |<|status\_codes|\-|`string`|<|Ranges of required HTTP status codes separated by commas. Supports user macros.<br>Example: 200,200-{$M},{$M},200-400<br><br>Used only by HTTP agent items.| |<|timeout|\-|`string`|<|Item data polling request timeout. Supports user macros.<br><br>Used by HTTP agent and Script items.| |<|verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Validate if host name in URL is in Common Name field or a Subject Alternate Name field of host certificate.<br><br>Used only by HTTP agent items.| |<|verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Validate if host certificate is authentic.<br><br>Used only by HTTP agent items.| |parameters|<|\-|<|<|Root element for user-defined parameters.<br><br>Used only by Script items.| |<|name|x|`string`|<|Parameter name.<br><br>Used only by Script items.| |<|value|\-|`string`|<|Parameter value.<br><br>Used only by Script items.| |value map|<|\-|<|<|Value map.| |<|name|x|`string`|<|Name of the value map to use for the item.| |preprocessing|<|\-|<|<|Root element for item value preprocessing.| |step|<|\-|<|<|Individual item value preprocessing step.| |<|type|x|`string`|1 - MULTIPLIER<br>2 - RTRIM<br>3 - LTRIM<br>4 - TRIM<br>5 - REGEX<br>6 - BOOL\_TO\_DECIMAL<br>7 - OCTAL\_TO\_DECIMAL<br>8 - HEX\_TO\_DECIMAL<br>9 - SIMPLE\_CHANGE (calculated as (received value-previous value))<br>10 - CHANGE\_PER\_SECOND (calculated as (received value-previous value)/(time now-time of last check))<br>11 - XMLPATH<br>12 - JSONPATH<br>13 - IN\_RANGE<br>14 - MATCHES\_REGEX<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>18 - CHECK\_REGEX\_ERROR<br>19 - DISCARD\_UNCHANGED<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>22 - PROMETHEUS\_PATTERN<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>26 - CHECK\_NOT\_SUPPORTED<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |<|parameters|\-|<|<|Root element for parameters of the item value preprocessing step.| |<|parameter|x|`string`|<|Individual parameter of the item value preprocessing step.| |<|error\_handler|\-|`string`|0 - ORIGINAL\_ERROR (default)<br>1 - DISCARD\_VALUE<br>2 - CUSTOM\_VALUE<br>3 - CUSTOM\_ERROR|Action type used in case of preprocessing step failure.| |<|error\_handler\_params|\-|`string`|<|Error handler parameters used with 'error\_handler'.| |master\_item|<|\-|<|<|Individual item master item.<br><br>Required by dependent items.| |<|key|x|`string`|<|Dependent item master item key value.<br><br>Recursion up to 3 dependent items and maximum count of dependent items equal to 29999 are allowed.| |triggers|<|\-|<|<|Root element for simple triggers.| |<|*For trigger element tag values, see host [trigger tags](/manual/xml_export_import/hosts#host_trigger_tags).*|<|<|<|<| |tags|<|\-|<|<|Root element for item tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.|
pt-br	##### Tags de itens do host  |Elemento|Propriedade do elemento|Requerido|Tipo|Intervalo^**[1](#footnotes)**^|Descrição| |-------|----------------|--------|----|---------- -----|-----------| |items|<|\-|<|<|Elemento raiz para itens.| |<|nome|x|`string`|<|Nome do item.| |<|type|\-|`string`|0 - ZABBIX\_PASSIVE (padrão)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNO<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNO<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>15 - CALCULADO<br>16 - JMX<br>17 - SNMP\_TRAP<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT<br>21 - ITEM\_TYPE\_SCRIPT|Tipo de item.| |<|snmp\_oid|\-|`string`|<|ID do objeto SNMP.<br><br>Requerido por itens SNMP.| |<|chave|x|`string`|<|chave do item.| |<|delay|\-|`string`|Padrão: 1m|Intervalo de atualização do item.<br><br>Observe que `delay` será sempre '0' para itens trapper.<br><br>Aceita segundos ou uma unidade de tempo com sufixo (30s, 1m, 2h, 1d).<br>Opcionalmente, um ou mais [intervalos personalizados](/manual/config/items/item/custom_intervals) podem ser especificados como intervalos flexíveis ou agendamento. <br>Vários intervalos são separados por um ponto e vírgula.<br>As macros do usuário podem ser usadas. Uma única macro deve preencher todo o campo. Múltiplas macros em um campo ou macros misturadas com texto não são suportadas.<br>Intervalos flexíveis podem ser escritos como duas macros separadas por uma barra (por exemplo, `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).| |<|history|\-|`string`|Padrão: 90d|Uma unidade de tempo de quanto tempo os dados do histórico devem ser armazenados. Unidade de tempo com sufixo, macro de usuário ou macro LLD.| |<|tendências|\-|`string`|Padrão: 365d|Uma unidade de tempo de quanto tempo os dados de tendências devem ser armazenados. Unidade de tempo com sufixo, macro de usuário ou macro LLD.| |<|status|\-|`string`|0 - ATIVADO (padrão)<br>1 - DESATIVADO|Status do item.| |<|value\_type|\-|`string`|0 - FLOAT<br>1 - CHAR<br>2 - LOG<br>3 - UNSIGNED (padrão)<br>4 - TEXT|Tipo de valor recebido.| |<|allowed\_hosts|\-|`string`|<|Lista de endereços IP (delimitados por vírgula) de hosts com permissão para enviar dados para o item.<br><br>Usado por itens do agente trapper e HTTP.| |<|unidades|\-|`string`|<|Unidades de valores retornados (bps, B, etc).| |<|params|\-|`text`|<|Parâmetros adicionais dependendo do tipo do item:<br>- script executado para itens de Script, SSH e Telnet;<br>- consulta SQL para itens de monitor de banco de dados;< br>- fórmula para itens calculados.| |<|ipmi\_sensor|\-|`string`|<|Sensor IPMI.<br><br>Usado apenas por itens IPMI.| |<|authtype|\-|`string`|Tipo de autenticação para itens do agente SSH:<br>0 - SENHA (padrão)<br>1 - PUBLIC\_KEY<br><br>Tipo de autenticação para itens do agente HTTP:< br>0 - NONE (padrão)<br>1 - BASIC<br>2 - NTLM|Tipo de autenticação.<br><br>Usado apenas por itens de agente SSH e HTTP.| |<|username|\-|`string`|<|Nome de usuário para autenticação.<br>Usado por verificação simples, SSH, Telnet, monitor de banco de dados, itens de agente JMX e HTTP.<br><br>Requerido por SSH e Telnet items.<br>Quando usado pelo agente JMX, a senha também deve ser especificada junto com o nome de usuário ou ambas as propriedades devem ser deixadas em branco.| |<|password|\-|`string`|<|Senha para autenticação.<br>Usado por verificação simples, SSH, Telnet, monitor de banco de dados, itens de agente JMX e HTTP.<br><br>Quando usado pelo agente JMX , o nome de usuário também deve ser especificado junto com a senha ou ambas as propriedades devem ser deixadas em branco.| |<|publickey|\-|`string`|<|Nome do arquivo de chave pública.<br><br>Obrigatório para itens do agente SSH.| |<|privatekey|\-|`string`|<|Nome do arquivo de chave privada.<br><br>Obrigatório para itens do agente SSH.| |<|descrição|\-|`text`|<|Descrição do item.| |<|inventory\_link|\-|`string`|0 - NONE<br><br>Nome do campo de inventário do host em letras maiúsculas. Por exemplo:<br>4 - ALIAS<br>6 - OS\_FULL<br>14 - HARDWARE<br>etc.|Campo de inventário do host que é preenchido pelo item.<br><br>Consulte o [host página de inventário](/manual/api/reference/host/object#host_inventory) para obter uma lista de campos de inventário de host compatíveis e seus IDs.| |<|logtimefmt|\-|`string`|<|Formato da hora nas entradas de log.<br>Usado apenas por itens de log.| |<|interface\_ref|\-|`string`|Formato: `if<N>`|Referência à interface do host.| |<|jmx\_endpoint|\-|`string`|<|JMX endpoint.<br><br>Usado apenas por itens do agente JMX.| |<|url|\-|`string`|<|String de URL.<br><br>Requerido apenas para itens de agente HTTP.| |<|allow\_traps|\-|`string`|0 - NO (padrão)<br>1 - YES|Permitir preencher o valor como em um item de trapper.<br><br>Usado apenas por itens de agente HTTP. | |<|follow\_redirects|\-|`string`|0 - NÃO<br>1 - SIM (padrão)|Seguir redirecionamentos de resposta HTTP ao agrupar dados.<br><br>Usado apenas por itens de agente HTTP.| |headers|<|\-|<|<|Elemento raiz para cabeçalhos de solicitação HTTP(S), em que o nome do cabeçalho é usado como chave e o valor do cabeçalho como valor.<br>Usado apenas por itens de agente HTTP.| |<|nome|x|`string`|<|Nome do cabeçalho.| |<|valor|x|`string`|<|Valor do cabeçalho.| |<|http\_proxy|\-|`string`|<|String de conexão do proxy HTTP(S).<br><br>Usado apenas por itens do agente HTTP.| |<|output\_format|\-|`string`|0 - RAW (padrão)<br>1 - JSON|Como processar a resposta.<br><br>Usado apenas por itens do agente HTTP.| |<|post\_type|\-|`string`|0 - RAW (padrão)<br>2 - JSON<br>3 - XML|Tipo de corpo de dados da postagem.<br><br>Usado apenas pelo agente HTTP item

en-us	##### Host low-level discovery rule tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |discovery\_rules|<|\-|<|<|Root element for low-level discovery rules.| |<|*For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to low-level discovery rules, are described below.*|<|<|<|<| |<|type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Item type.| |<|lifetime|\-|`string`|Default: 30d|Time period after which items that are no longer discovered will be deleted. Seconds, time unit with suffix or user macro.| |filter|<|<|<|<|Individual filter.| |<|evaltype|\-|`string`|0 - AND\_OR (default)<br>1 - AND<br>2 - OR<br>3 - FORMULA|Logic to use for checking low-level discovery rule filter conditions.| |<|formula|\-|`string`|<|Custom calculation formula for filter conditions.| |conditions|<|\-|<|<|Root element for filter conditions.| |<|macro|x|`string`|<|Low-level discovery macro name.| |<|value|\-|`string`|<|Filter value: regular expression or global regular expression.| |<|operator|\-|`string`|8 - MATCHES\_REGEX (default)<br>9 - NOT\_MATCHES\_REGEX|Condition operator.| |<|formulaid|x|`character`|<|Arbitrary unique ID that is used to reference a condition from the 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.| |lld\_macro\_paths|<|\-|<|<|Root element for LLD macro paths.| |<|lld\_macro|x|`string`|<|Low-level discovery macro name.| |<|path|x|`string`|<|Selector for value which will be assigned to the corresponding macro.| |preprocessing|<|\-|<|<|LLD rule value preprocessing.| |step|<|\-|<|<|Individual LLD rule value preprocessing step.| |<|*For most of the element tag values, see element tag values for a host item value preprocessing. Only the tags that are specific to low-level discovery value preprocessing, are described below.*|<|<|<|<| |<|type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |trigger\_prototypes|<|\-|<|<|Root element for trigger prototypes.| |<|*For trigger prototype element tag values, see regular [host trigger](/manual/xml_export_import/hosts#host_trigger_tags) tags.*|<|<|<|<| |graph\_prototypes|<|\-|<|<|Root element for graph prototypes.| |<|*For graph prototype element tag values, see regular [host graph](/manual/xml_export_import/hosts#host_graph_tags) tags.*|<|<|<|<| |host\_prototypes|<|\-|<|<|Root element for host prototypes.| |<|*For host prototype element tag values, see regular [host](/manual/xml_export_import/hosts#host_tags) tags.*|<|<|<|<| |item\_prototypes|<|\-|<|<|Root element for item prototypes.| |<|*For item prototype element tag values, see regular [host item](/manual/xml_export_import/hosts#host_item_tags) tags.*|<|<|<|<| |master\_item|<|\-|<|<|Individual item prototype master item/item prototype data.| |<|key|x|`string`|<|Dependent item prototype master item/item prototype key value.<br><br>Required for a dependent item.|
pt-br	##### Hospedar tags de regra de descoberta de baixo nível  |Elemento|Propriedade do elemento|Requerido|Tipo|Intervalo^**[1](#footnotes)**^|Descrição| |-------|----------------|--------|----|---------- -----|-----------| |discovery\_rules|<|\-|<|<|Elemento raiz para regras de descoberta de baixo nível.| |<|*Para a maioria dos valores de tag de elemento, veja valores de tag de elemento para um item regular. Somente as tags específicas para regras de descoberta de baixo nível são descritas abaixo.*|<|<|<|<| |<|type|\-|`string`|0 - ZABBIX\_PASSIVE (padrão)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNO<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNO<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENTE<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Tipo de item.| |<|vida|\-|`string`|Padrão: 30d|Período de tempo após o qual os itens que não são mais descobertos serão excluídos. Segundos, unidade de tempo com sufixo ou macro de usuário.| |filtro|<|<|<|<|Filtro individual.| |<|evaltype|\-|`string`|0 - AND\_OR (padrão)<br>1 - AND<br>2 - OU<br>3 - FORMULA|Lógica a ser usada para verificar o filtro de regra de descoberta de baixo nível condições.| |<|formula|\-|`string`|<|Fórmula de cálculo personalizada para condições de filtro.| |conditions|<|\-|<|<|Elemento raiz para condições de filtro.| |<|macro|x|`string`|<|Nome da macro de descoberta de baixo nível.| |<|valor|\-|`string`|<|Valor do filtro: expressão regular ou expressão regular global.| |<|operador|\-|`string`|8 - MATCHES\_REGEX (padrão)<br>9 - NOT\_MATCHES\_REGEX|Operador de condição.| |<|formulaid|x|`character`|<|ID exclusivo arbitrário que é usado para fazer referência a uma condição da 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.| |lld\_macro\_paths|<|\-|<|<|Elemento raiz para caminhos de macro LLD.| |<|lld\_macro|x|`string`|<|Nome da macro de descoberta de baixo nível.| |<|path|x|`string`|<|Seletor para o valor que será atribuído à macro correspondente.| |pré-processamento|<|\-|<|<|pré-processamento do valor da regra LLD.| |step|<|\-|<|<|Etapa de pré-processamento do valor da regra LLD individual.| |<|*Para a maioria dos valores de tag de elemento, consulte valores de tag de elemento para um pré-processamento de valor de item de host. Somente as tags que são específicas para o pré-processamento de valor de descoberta de baixo nível são descritas abaixo.*|<|<|<|<| |<|type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE <br>27 - XML\_TO\_JSON|Tipo da etapa de pré-processamento do valor do item.| |trigger\_prototypes|<|\-|<|<|Elemento raiz para protótipos de trigger.| |<|*Para valores de tag de elemento protótipo de acionador, consulte tags regulares [host trigger](/manual/xml_export_import/hosts#host_trigger_tags).*|<|<|<|<| |graph\_prototypes|<|\-|<|<|Elemento raiz para protótipos de gráfico.| |<|*Para valores de tag de elemento de protótipo de gráfico, consulte tags regulares [host graph](/manual/xml_export_import/hosts#host_graph_tags).*|<|<|<|<| |host\_prototypes|<|\-|<|<|Elemento raiz para protótipos de host.| |<|*Para valores de tag de elemento de protótipo de host, consulte tags regulares [host](/manual/xml_export_import/hosts#host_tags).*|<|<|<|<| |item\_prototypes|<|\-|<|<|Elemento raiz para protótipos de itens.| |<|*Para valores de tag de elemento de protótipo de item, consulte tags regulares [host item](/manual/xml_export_import/hosts#host_item_tags).*|<|<|<|<| |master\_item|<|\-|<|<|Dados de protótipo de item/protótipo de item de protótipo de item individual.| |<|key|x|`string`|<|Valor da chave do protótipo do item mestre/protótipo do item dependente.<br><br>Obrigatório para um item dependente.|

en-us	### Host macro  The host macro object defines a macro available on a host, host prototype or template. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostmacroid|string|*(readonly)* ID of the host macro.| |**hostid**<br>(required)|string|ID of the host that the macro belongs to.| |**macro**<br>(required)|string|Macro string.| |**value**<br>(required)|string|Value of the macro.| |type|integer|Type of macro.<br><br>Possible values:<br>0 - *(default)* Text macro;<br>1 - Secret macro;<br>2 - Vault secret.| |description|string|Description of the macro.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
pt-br	### Host macro  O objeto do host macro define a disponibilidade de um macro no host, prototype host ou template. Ele tem as seguintes propriedades:   |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |hostmacroid|string|*(readonly)* ID do host macro.| |**hostid**<br>(requisitado)|string|ID do macro que pertence ao host.| |**macro**<br>(requisitado)|string|Macro string.| |**value**<br>(requisitado)|string|Valor do macro.| |tipo|integer|Tipo do macro.<br><br>Valores Possíveis:<br>0 - *(default)* Texto macro;<br>1 - Macro seguro;<br>2 - Vault seguro.| |Descrição|string|Descrição do macro.|  Note que para alguns dos métodos (update, delete) a combinação do parêmetro requisitado/opcional é diferente.

en-us	Host markers displayed on the map have the color of the host's most serious problem and green color if a host has no problems. Clicking on a host marker allows viewing the host's visible name and the number of unresolved problems grouped by severity. Clicking on the visible name will open [host menu](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu).  Hosts displayed on the map can be filtered by problem severity. Press on the filter icon in the widget's upper right corner and mark the required severities.  ![](../../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/geomap_widget_filter.png)
pt-br	Os marcadores de host exibidos no mapa têm a cor do host mais problema sério e cor verde se um host não tiver problemas. Clicando em um marcador de host permite visualizar o nome visível do host e o número de problemas não resolvidos agrupados por gravidade. Clicando no nome visível vai abrir [host menu](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu).  Os hosts exibidos no mapa podem ser filtrados por gravidade do problema. Pressione o ícone de filtro no canto superior direito do widget e marque o gravidades.  ![](../../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/geomap_widget_filter.png)

en-us	# host.massadd
pt-br	## host.massadd

en-us	# host.massremove
pt-br	## host.massremove

en-us	# host.massupdate
pt-br	## host.massupdate

en-us	##### Host naming  When adding hosts, a host name is the result of reverse DNS lookup or IP address if reverse lookup fails. Lookup is performed from the Zabbix server or Zabbix proxy, depending on which is doing the discovery. If lookup fails on the proxy, it is not retried on the server. If the host with such a name already exists, the next host would get **\_2** appended to the name, then **\_3** and so on.  It is also possible to override DNS/IP lookup and instead use an item value for host name, for example:  -   You may discover multiple servers with Zabbix agent running using a     Zabbix agent item for discovery and assign proper names to them     automatically, based on the string value returned by this item -   You may discover multiple SNMP network devices using an SNMP agent     item for discovery and assign proper names to them automatically,     based on the string value returned by this item  If the host name has been set using an item value, it is not updated during the following discovery checks. If it is not possible to set host name using an item value, default value (DNS name) is used.  If a host already exists with the discovered IP address, a new host is not created. However, if the discovery action contains operations (link template, add to host group, etc), they are performed on the existing host.
pt-br	##### Nomeação do host  Ao adicionar hosts, um nome de host é o resultado de pesquisa de DNS reverso ou IP endereço se a pesquisa reversa falhar. A pesquisa é realizada a partir do Zabbix servidor ou proxy Zabbix, dependendo de qual está fazendo a descoberta. Se a pesquisa falha no proxy, ela não é repetida no servidor. Se o anfitrião com esse nome já existe, o próximo host obteria **\_2** anexado ao nome, depois **\_3** e assim por diante.  Também é possível substituir a pesquisa de DNS/IP e usar um item valor para o nome do host, por exemplo:  - Você pode descobrir vários servidores com o agente Zabbix rodando usando um     Item do agente Zabbix para descoberta e atribuir nomes próprios a eles     automaticamente, com base no valor da string retornado por este item - Você pode descobrir vários dispositivos de rede SNMP usando um agente SNMP     item para descoberta e atribuir nomes próprios a eles automaticamente,     com base no valor da string retornado por este item  Se o nome do host tiver sido definido usando um valor de item, ele não será atualizado durante as seguintes verificações de descoberta. Se não for possível definir o host nome usando um valor de item, o valor padrão (nome DNS) é usado.  Se já existir um host com o endereço IP descoberto, um novo host será não criado. No entanto, se a ação de descoberta contiver operações (link modelo, adicionar ao grupo de hosts, etc), eles são executados no hospedeiro.

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

en-us	#### host prototype  Changes:\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.get`: dropped support of properties `group_prototypeid`, `hostid`, `templateid` of group link and group prototype API objects.\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.update`: dropped the ability to modify the readonly fields `host`, `name`, `custom_interfaces`, `interfaces`, `groupLinks`, `groupPrototypes`, `templates`, `tags`, `macros`, `inventory_mode` of inherited host prototypes.\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.create`, `hostprototype.update`, `hostprototype.delete`: added strict validation of the method parameters.\
pt-br	#### host prototype  Alterações:\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.get`: suporte removido para as propriedades `group_prototypeid`, `hostid`, `templateid` dos objetos de API de vínculo de grupo e protótipo de grupos.\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.update`: removida a capacidade de modificar os campos somente leitura`host`, `name`, `custom_interfaces`, `interfaces`, `groupLinks`, `groupPrototypes`, `templates`, `tags`, `macros`, `inventory_mode` de protótipos de hots herdados.\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.create`, `hostprototype.update`, `hostprototype.delete`: adição de validação estrita dos parâmetros do método.\

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

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

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

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

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

en-us	#### Host prototypes  Host prototypes can be created with the low-level discovery rule. When virtual machines are discovered, these prototypes become real hosts. Prototypes, before becoming discovered, cannot have their own items and triggers, other than those from the linked templates. Discovered hosts will belong to an existing host.  ![](../../assets/en/manual/vm_monitoring/vm_host_prototypes.png)  In order for hosts created from a prototype to have unique host names, the *Host name* field must contain at least one [low-level discovery macro](/manual/config/macros/lld_macros).  Since Zabbix 5.2, discovered hosts may be configured with custom interfaces or inherit the IP of a host the discovery rule belongs to (default). To add one or more custom interface, switch the *Interface* selector from *Inherit* to *Custom* mode, then press ![add\_link.png](../../assets/en/manual/config/add_link.png) and select the required interface type from the drop-down menu that appears. All supported types of interfaces can be defined for a host prototype: Zabbix agent, SNMP, JMX, IPMI. Interface fields support low-level discovery macros and [user macros](/manual/config/macros/user_macros). If several custom interfaces are specified - use the *Default* column to specify the primary interface.  Notes:  -   If *Custom* is selected, but no interfaces have been specified the     hosts will be created without interfaces. -   If *Inherit* is selected for a host prototype that belongs to a     template, discovered hosts will inherit the interface of a host to     which the template is linked to.  ::: notewarning  A host will not be created, if the host interface contains incorrect data  :::  ![](../../assets/en/manual/vm_monitoring/vm_host_prototypes_if2.png)  LLD macros can also be used for the visible name, host group prototype fields, tag values, or values of host prototype user macros.  Other options that can be specified for a host prototype are:  -   Linkage to existing host groups -   Template linkage -   Encryption  If *Create enabled* is checked, the host will be added in an enabled state. If unchecked, the host will be added, but in a disabled state.  If *Discover* is checked (default), the host will be created. If unchecked, the host will not be created, unless this setting is overridden in the [discovery rule](/manual/discovery/low_level_discovery#override). This functionality provides additional flexibility when creating discovery rules.  Discovered hosts are prefixed with the name of the discovery rule that created them, in the host list. Discovered hosts can be manually deleted. Discovered hosts will also be automatically deleted, based on the *Keep lost resources period (in days)* value of the discovery rule. Most of the configuration options are read-only, except for enabling/disabling the host and host inventory. Discovered hosts cannot have host prototypes of their own.
pt-br	#### Protótipos de host  Os protótipos de host podem ser criados com a regra de descoberta de baixo nível. Quando máquinas virtuais são descobertas, esses protótipos se tornam hosts reais. Os protótipos, antes de serem descobertos, não podem ter seus próprios itens e gatilhos, além daqueles dos modelos vinculados. Anfitriões descobertos pertencerá a um host existente.  ![](../../assets/en/manual/vm_monitoring/vm_host_prototypes.png)  Para que os hosts criados a partir de um protótipo tenham nomes de host exclusivos, o campo *Nome do host* deve conter pelo menos um [descoberta de baixo nível macro](/manual/config/macros/lld_macros).  Desde o Zabbix 5.2, os hosts descobertos podem ser configurados com interfaces ou herdar o IP de um host ao qual a regra de descoberta pertence (predefinição). Para adicionar uma ou mais interfaces personalizadas, alterne a *Interface* seletor do modo *Herdar* para o modo *Personalizado* e pressione ![add\_link.png](../../assets/en/manual/config/add_link.png) e selecione o tipo de interface necessário no menu suspenso que aparece. Todo tipos de interfaces suportados podem ser definidos para um protótipo de host: Agente Zabbix, SNMP, JMX, IPMI. Campos de interface suportam baixo nível macros de descoberta e [macros de usuário](/manual/config/macros/user_macros). Se várias interfaces personalizadas forem especificadas - use a coluna *Default* para especifique a interface primária.  Notas:  - Se *Personalizado* for selecionado, mas nenhuma interface tiver sido especificada, o     hosts serão criados sem interfaces. - Se *Herdar* for selecionado para um protótipo de host que pertence a um     template, os hosts descobertos herdarão a interface de um host para     ao qual o modelo está vinculado.  ::: aviso  Um host não será criado, se a interface do host contém dados incorretos :::  ![](../../assets/en/manual/vm_monitoring/vm_host_prototypes_if2.png)  As macros LLD também podem ser usadas para o nome visível, protótipo do grupo de host campos, valores de tag ou valores de macros de usuário de protótipo de host.  Outras opções que podem ser especificadas para um protótipo de host são:  - Vinculação a grupos de hosts existentes - Vinculação de modelos - Criptografia  Se *Criar habilitado* estiver marcado, o host será adicionado em um Estado. Se desmarcado, o host será adicionado, mas em um estado desabilitado.  Se *Discover* estiver marcado (padrão), o host será criado. Se desmarcada, o host não será criado, a menos que esta configuração seja substituído na [descoberta regra](/manual/discovery/low_level_discovery#override). este funcionalidade fornece flexibilidade adicional ao criar descoberta as regras.  Os hosts descobertos são prefixados com o nome da regra de descoberta que os criou, na lista de hosts. Hosts descobertos podem ser manualmente excluído. Os hosts descobertos também serão excluídos automaticamente, com base em o valor *Manter o período de recursos perdidos (em dias)* da regra de descoberta. A maioria das opções de configuração são somente leitura, exceto habilitar/desabilitar o host e o inventário do host. Os hosts descobertos não podem têm seus próprios protótipos de host.

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

en-us	### Host prototype  The host prototype object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |hostid|string|*(readonly)* ID of the host prototype.| |**host**<br>(required)|string|Technical name of the host prototype.| |name|string|Visible name of the host prototype.<br><br>Default: `host` property value.| |status|integer|Status of the host prototype.<br><br>Possible values are:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values are:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |templateid|string|*(readonly)* ID of the parent template host prototype.| |discover|integer|Host prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new hosts will be discovered;<br>1 - new hosts will not be discovered and existing hosts will be marked as lost.| |custom\_interfaces|integer|Source of interfaces for hosts created by the host prototype.<br><br>Possible values:<br>0 - *(default)* inherit interfaces from parent host;<br>1 - use host prototypes custom interfaces.| |uuid|string|Universal unique identifier, used for linking imported host prototypes to already existing ones. Used only for host prototypes on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.|
pt-br	### Protótipo de host  O objeto de protótipo do host tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |hostid|string|*(readonly)* ID do protótipo do host.| |**host**<br>(obrigatório)|string|Nome técnico do protótipo do host.| |name|string|Nome visível do protótipo do host.<br><br>Padrão: valor da propriedade `host`.| |status|inteiro|Status do protótipo do host.<br><br>Os valores possíveis são:<br>0 - *(padrão)* host monitorado;<br>1 - host não monitorado.| |inventário\_modo|inteiro|Modo de preenchimento do inventário do host.<br><br>Os valores possíveis são:<br>-1 - *(padrão)* desativado;<br>0 - manual;<br>1 - automático.| |templateid|string|*(readonly)* ID do protótipo do host do modelo pai.| |discover|integer|Status de descoberta do protótipo do host.<br><br>Valores possíveis:<br>0 - *(padrão)* novos hosts serão descobertos;<br>1 - novos hosts não serão descobertos e os hosts existentes serão ser marcado como perdido.| |custom\_interfaces|integer|Fonte de interfaces para hosts criados pelo protótipo do host.<br><br>Valores possíveis:<br>0 - *(padrão)* herdam interfaces do host pai;<br>1 - use host protótipos de interfaces personalizadas.| |uuid|string|Identificador único universal, usado para vincular protótipos de host importados aos já existentes. Usado apenas para protótipos de host em modelos. Gerado automaticamente, se não fornecido.<br><br>Para operações de atualização, este campo é *somente leitura*.|

en-us	# Host prototype  This class is designed to work with host prototypes.  Object references:\  -   [Host     prototype](/manual/api/reference/hostprototype/object#host_prototype) -   [Host prototype     inventory](/manual/api/reference/hostprototype/object#host_prototype_inventory) -   [Group link](/manual/api/reference/hostprototype/object#group_link) -   [Group     prototype](/manual/api/reference/hostprototype/object#group_prototype)  Available methods:\  -   [hostprototype.create](/manual/api/reference/hostprototype/create) -     creating new host prototypes -   [hostprototype.delete](/manual/api/reference/hostprototype/delete) -     deleting host prototypes -   [hostprototype.get](/manual/api/reference/hostprototype/get) -     retrieving host prototypes -   [hostprototype.update](/manual/api/reference/hostprototype/update) -     updating host prototypes
pt-br	# Protótipo de host  Esta classe foi projetada para trabalhar com protótipos de host.  Referências de objetos:\  -   [Hospedeiro     protótipo](/manual/api/reference/hostprototype/object#host_prototype) - [Protótipo do host     inventário](/manual/api/reference/hostprototype/object#host_prototype_inventory) - [Link do grupo](/manual/api/reference/hostprototype/object#group_link) -   [Grupo     protótipo](/manual/api/reference/hostprototype/object#group_prototype)  Métodos disponíveis:\  - [hostprototype.create](/manual/api/reference/hostprototype/create) -     criando novos protótipos de host - [hostprototype.delete](/manual/api/reference/hostprototype/delete) -     excluindo protótipos de host - [hostprototype.get](/manual/api/reference/hostprototype/get) -     recuperando protótipos de host - [hostprototype.update](/manual/api/reference/hostprototype/update) -     atualizando protótipos de host

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

en-us	##### Host removal  Hosts discovered by a network discovery rule are removed automatically from *Monitoring* → *Discovery* if a discovered entity is not in the rule's IP range any more. Hosts are removed immediately.
pt-br	##### Remoção de host  Os hosts descobertos por uma regra de descoberta de rede são removidos automaticamente de *Monitoramento* → *Descoberta* se uma entidade descoberta não estiver no intervalo de IP da regra. Os hosts são removidos imediatamente.

en-us	#### Hosts/host prototypes  In a [host](/manual/config/hosts/host) and [host prototype](/manual/vm_monitoring#host_prototypes) configuration, user macros can be used in the following fields:  |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |--------|-|------------------------------------------------------------------------| |Interface IP/DNS|<|DNS only| |Interface port|<|no| |*SNMP v1, v2*|<|<| |<|SNMP community|yes| |*SNMP v3*|<|<| |<|Context name|yes| |^|Security name|yes| |^|Authentication passphrase|yes| |^|Privacy passphrase|yes| |*IPMI*|<|<| |<|Username|yes| |^|Password|yes| |*Tags*|<|<| |<|Tag names|yes| |^|Tag values|yes|
pt-br	#### Hosts/protótipos de host  Na configuração de um [host](/manual/config/hosts/host) e [protótipo de host](/manual/vm_monitoring#host_prototypes), macros de usuário podem ser usadas nos seguintes campos:  |Localização|<|Macros múltiplas/misturado com texto^[1](supported_by_location_user#footnotes)^| |--------|-|------------------------------------------------------------------------| |IP/DNS de interface|<|apenas DNS| |Porta de interface|<|no| |*SNMP v1, v2*|<|<| |<|Comunidade SNMP|yes| |*SNMP v3*|<|<| |<|Nome de contexto|yes| |^|Nome de segurança|yes| |^|Senha passe de autenticação|yes| |^|Senha passe de privacidade|yes| |*IPMI*|<|<| |<|Nome de usuário|yes| |^|Senha|yes| |*Etiquetas*|<|<| |<|Nomes de etiqueta|yes| |^|Valores de etiqueta|yes|

en-us	##### Host tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |groups|<|x|<|<|Root element for host groups.| |<|name|x|`string`|<|Host group name.| |hosts|<|\-|<|<|Root element for hosts.| |<|host|x|`string`|<|Unique host name.| |<|name|\-|`string`|<|Visible host name.| |<|description|\-|`text`|<|Host description.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Host status.| |<|ipmi\_authtype|\-|`string`|-1 - DEFAULT (default)<br>0 - NONE<br>1 - MD2<br>2 - MD5<br>4 - STRAIGHT<br>5 - OEM<br>6 - RMCP\_PLUS|IPMI session authentication type.| |<|ipmi\_privilege|\-|`string`|1 - CALLBACK<br>2 - USER (default)<br>3 - OPERATOR<br>4 - ADMIN<br>5 - OEM|IPMI session privilege level.| |<|ipmi\_username|\-|`string`|<|Username for IPMI checks.| |<|ipmi\_password|\-|`string`|<|Password for IPMI checks.| |proxy|<|\-|<|<|Proxy.| |<|name|x|`string`|<|Name of the proxy (if any) that monitors the host.| |templates|<|\-|<|<|Root element for linked templates.| |<|name|x|`string`|<|Template name.| |interfaces|<|\-|<|<|Root element for host interfaces.| |<|default|\-|`string`|0 - NO<br>1 - YES (default)|Whether this is the primary host interface.<br>There can be only one primary interface of one type on a host.| |<|type|\-|`string`|1 - ZABBIX (default)<br>2 - SNMP<br>3 - IPMI<br>4 - JMX|Interface type.| |<|useip|\-|`string`|0 - NO<br>1 - YES (default)|Whether to use IP as the interface for connecting to the host (if not, DNS will be used).| |<|ip|\-|`string`|<|IP address, can be either IPv4 or IPv6.<br><br>Required if the connection is made via IP.| |<|dns|\-|`string`|<|DNS name.<br><br>Required if the connection is made via DNS.| |<|port|\-|`string`|<|Port number. Supports user macros.| |<|interface\_ref|x|`string`|Format: `if<N>`|Interface reference name to be used in items.| |details|<|\-|<|<|Root element for interface details.| |<|version|\-|`string`|1 - SNMPV1<br>2 - SNMP\_V2C (default)<br>3 - SNMP\_V3|Use this SNMP version.| |<|community|\-|`string`|<|SNMP community.<br><br>Required by SNMPv1 and SNMPv2 items.| |<|contextname|\-|`string`|<|SNMPv3 context name.<br><br>Used only by SNMPv3 items.| |<|securityname|\-|`string`|<|SNMPv3 security name.<br><br>Used only by SNMPv3 items.| |<|securitylevel|\-|`string`|0 - NOAUTHNOPRIV (default)<br>1 - AUTHNOPRIV<br>2 - AUTHPRIV|SNMPv3 security level.<br><br>Used only by SNMPv3 items.| |<|authprotocol|\-|`string`|0 - MD5 (default)<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512|SNMPv3 authentication protocol.<br><br>Used only by SNMPv3 items.| |<|authpassphrase|\-|`string`|<|SNMPv3 authentication passphrase.<br><br>Used only by SNMPv3 items.| |<|privprotocol|\-|`string`|0 - DES (default)<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C|SNMPv3 privacy protocol.<br><br>Used only by SNMPv3 items.| |<|privpassphrase|\-|`string`|<|SNMPv3 privacy passphrase.<br><br>Used only by SNMPv3 items.| |<|bulk|\-|`string`|0 - NO<br>1 - YES (default)|Use bulk requests for SNMP.| |items|<|\-|<|<|Root element for items.| |<|*For item element tag values, see host [item](/manual/xml_export_import/hosts#host_item_tags) tags.*|<|<|<|<| |tags|<|\-|<|<|Root element for host tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.| |macros|<|\-|<|<|Root element for macros.| |<|macro|x|<|<|User macro name.| |<|type|\-|`string`|0 - TEXT (default)<br>1 - SECRET\_TEXT<br>2 - VAULT|Type of the macro.| |<|value|\-|`string`|<|User macro value.| |<|description|\-|`string`|<|User macro description.| |inventory|<|\-|<|<|Root element for host inventory.| |<|<inventory\_property>|\-|<|<|Individual inventory property.<br><br>All available inventory properties are listed under the respective tags, e.g. <type>, <name>, <os> (see example above).| |inventory\_mode|<|\-|`string`|-1 - DISABLED<br>0 - MANUAL (default)<br>1 - AUTOMATIC|Inventory mode.| |valuemaps|<|\-|<|<|Root element for host value maps.| |<|name|x|`string`|<|Value map name.| |<|mapping|\-|<|<|Root element for mappings.| |<|value|x|`string`|<|Value of a mapping.| |<|newvalue|x|`string`|<|New value of a mapping.|
pt-br	##### Tags de host  |Elemento|Propriedade do elemento|Requerido|Tipo|Intervalo^**[1](#footnotes)**^|Descrição| |-------|----------------|--------|----|---------- -----|-----------| |groups|<|x|<|<|Elemento raiz para grupos de hosts.| |<|name|x|`string`|<|Nome do grupo de hosts.| |hosts|<|\-|<|<|Elemento raiz para hosts.| |<|host|x|`string`|<|Nome de host exclusivo.| |<|name|\-|`string`|<|Nome do host visível.| |<|descrição|\-|`text`|<|Descrição do host.| |<|status|\-|`string`|0 - ATIVADO (padrão)<br>1 - DESATIVADO|Status do host.| |<|ipmi\_authtype|\-|`string`|-1 - DEFAULT (padrão)<br>0 - NONE<br>1 - MD2<br>2 - MD5<br>4 - STRAIGHT<br>5 - OEM<br>6 - RMCP\_PLUS|tipo de autenticação de sessão IPMI.| |<|ipmi\_privilege|\-|`string`|1 - CALLBACK<br>2 - USER (padrão)<br>3 - OPERATOR<br>4 - ADMIN<br>5 - OEM|IPMI nível de privilégio de sessão. | |<|ipmi\_username|\-|`string`|<|Nome de usuário para verificações de IPMI.| |<|ipmi\_password|\-|`string`|<|Senha para verificações de IPMI.| |proxy|<|\-|<|<|Proxy.| |<|name|x|`string`|<|Nome do proxy (se houver) que monitora o host.| |templates|<|\-|<|<|Elemento raiz para templates vinculados.| |<|nome|x|`string`|<|Nome do modelo.| |interfaces|<|\-|<|<|Elemento raiz para interfaces de host.| |<|default|\-|`string`|0 - NO<br>1 - YES (default)|Se esta é a interface principal do host.<br>Só pode haver uma interface primária de um tipo em um host. | |<|tipo|\-|`string`|1 - ZABBIX (padrão)<br>2 - SNMP<br>3 - IPMI<br>4 - JMX|Tipo de interface.| |<|useip|\-|`string`|0 - NÃO<br>1 - SIM (padrão)|Se usar IP como interface para conexão com o host (se não, DNS será usado).| |<|ip|\-|`string`|<|endereço IP, pode ser IPv4 ou IPv6.<br><br>Obrigatório se a conexão for feita via IP.| |<|dns|\-|`string`|<|Nome DNS.<br><br>Obrigatório se a conexão for feita via DNS.| |<|port|\-|`string`|<|Número da porta. Suporta macros de usuário.| |<|interface\_ref|x|`string`|Formato: `if<N>`|Nome de referência de interface a ser usado em itens.| |details|<|\-|<|<|Elemento raiz para detalhes da interface.| |<|versão|\-|`string`|1 - SNMPV1<br>2 - SNMP\_V2C (padrão)<br>3 - SNMP\_V3|Use esta versão SNMP.| |<|comunidade|\-|`string`|<|Comunidade SNMP.<br><br>Requerido para itens SNMPv1 e SNMPv2.| |<|contextname|\-|`string`|<|Nome do contexto SNMPv3.<br><br>Usado apenas por itens SNMPv3.| |<|securityname|\-|`string`|<|Nome de segurança SNMPv3.<br><br>Usado apenas por itens SNMPv3.| |<|securitylevel|\-|`string`|0 - NOAUTHNOPRIV (padrão)<br>1 - AUTHNOPRIV<br>2 - AUTHPRIV|Nível de segurança SNMPv3.<br><br>Usado apenas por itens SNMPv3.| |<|authprotocol|\-|`string`|0 - MD5 (padrão)<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512|SNMPv3 protocolo de autenticação.<br><br>Usado apenas por itens SNMPv3.| |<|authpassphrase|\-|`string`|<|Senha de autenticação SNMPv3.<br><br>Usado apenas por itens SNMPv3.| |<|privprotocol|\-|`string`|0 - DES (padrão)<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C|SNMPv3 protocolo de privacidade.<br><br>Usado apenas por itens SNMPv3.| |<|privpassphrase|\-|`string`|<|Senha de privacidade SNMPv3.<br><br>Usado apenas por itens SNMPv3.| |<|bulk|\-|`string`|0 - NÃO<br>1 - SIM (padrão)|Use solicitações em massa para SNMP.| |items|<|\-|<|<|Elemento raiz para itens.| |<|*Para valores de tag de elemento de item, consulte tags de host [item](/manual/xml_export_import/hosts#host_item_tags).*|<|<|<|<| |tags|<|\-|<|<|Elemento raiz para tags de host.| |<|tag|x|`string`|<|Nome da tag.| |<|valor|\-|`string`|<|Valor da tag.| |macros|<|\-|<|<|Elemento raiz para macros.| |<|macro|x|<|<|Nome da macro do usuário.| |<|type|\-|`string`|0 - TEXT (padrão)<br>1 - SECRET\_TEXT<br>2 - VAULT|Tipo da macro.| |<|valor|\-|`string`|<|Valor da macro do usuário.| |<|descrição|\-|`string`|<|Descrição da macro do usuário.| |inventário|<|\-|<|<|Elemento raiz para inventário do host.| |<|<inventário\_property>|\-|<|<|Propriedade de inventário individual.<br><br>Todas as propriedades de inventário disponíveis estão listadas nas respectivas tags, por exemplo, <type>, <name>, <os> (veja o exemplo acima).| |inventory\_mode|<|\-|`string`|-1 - DESATIVADO<br>0 - MANUAL (padrão)<br>1 - AUTOMÁTICO|Modo de inventário.| |valuemaps|<|\-|<|<|Elemento raiz para mapas de valor do host.| |<|nome|x|`string`|<|Nome do mapa de valores.| |<|mapping|\-|<|<|Elemento raiz para mapeamentos.| |<|valor|x|`string`|<|Valor de um mapeamento.| |<|newvalue|x|`string`|<|Novo valor de um mapeamento.|

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

en-us	### Host  The host object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |hostid|string|*(readonly)* ID of the host.| |**host**<br>(required)|string|Technical name of the host.| |description|text|Description of the host.| |flags|integer|*(readonly)* Origin of the host.<br><br>Possible values:<br>0 - a plain host;<br>4 - a discovered host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values are:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |ipmi\_authtype|integer|IPMI authentication algorithm.<br><br>Possible values are:<br>-1 - *(default)* default;<br>0 - none;<br>1 - MD2;<br>2 - MD5<br>4 - straight;<br>5 - OEM;<br>6 - RMCP+.| |ipmi\_password|string|IPMI password.| |ipmi\_privilege|integer|IPMI privilege level.<br><br>Possible values are:<br>1 - callback;<br>2 - *(default)* user;<br>3 - operator;<br>4 - admin;<br>5 - OEM.| |ipmi\_username|string|IPMI username.| |maintenance\_from|timestamp|*(readonly)* Starting time of the effective maintenance.| |maintenance\_status|integer|*(readonly)* Effective maintenance status.<br><br>Possible values are:<br>0 - *(default)* no maintenance;<br>1 - maintenance in effect.| |maintenance\_type|integer|*(readonly)* Effective maintenance type.<br><br>Possible values are:<br>0 - *(default)* maintenance with data collection;<br>1 - maintenance without data collection.| |maintenanceid|string|*(readonly)* ID of the maintenance that is currently in effect on the host.| |name|string|Visible name of the host.<br><br>Default: `host` property value.| |proxy\_hostid|string|ID of the proxy that is used to monitor the host.| |status|integer|Status and function of the host.<br><br>Possible values are:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |tls\_connect|integer|Connections to host.<br><br>Possible values are:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_accept|integer|Connections from host.<br><br>Possible bitmap values are:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_issuer|string|Certificate issuer.| |tls\_subject|string|Certificate subject.| |tls\_psk\_identity|string|*(write-only)* PSK identity. Required if either `tls_connect` or `tls_accept` has PSK enabled.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |tls\_psk|string|*(write-only)* The preshared key, at least 32 hex digits. Required if either `tls_connect` or `tls_accept` has PSK enabled.|
pt-br	### Hospedeiro  O objeto host tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |hostid|string|*(readonly)* ID do host.| |**host**<br>(obrigatório)|string|Nome técnico do host.| |descrição|texto|Descrição do host.| |flags|inteiro|*(somente leitura)* Origem do host.<br><br>Valores possíveis:<br>0 - um host simples;<br>4 - um host descoberto.| |inventário\_modo|inteiro|Modo de preenchimento do inventário do host.<br><br>Os valores possíveis são:<br>-1 - *(padrão)* desativado;<br>0 - manual;<br>1 - automático.| |ipmi\_authtype|inteiro|Algoritmo de autenticação IPMI.<br><br>Os valores possíveis são:<br>-1 - *(padrão)* padrão;<br>0 - nenhum;<br>1 - MD2;<br >2 - MD5<br>4 - reto;<br>5 - OEM;<br>6 - RMCP+.| |ipmi\_password|string|senha do IPMI.| |ipmi\_privilege|inteiro|Nível de privilégio IPMI.<br><br>Os valores possíveis são:<br>1 - retorno de chamada;<br>2 - *(padrão)* usuário;<br>3 - operador;<br> 4 - admin;<br>5 - OEM.| |ipmi\_username|string|IPMI username.| |manutenção\_from|timestamp|*(somente leitura)* Hora de início da manutenção efetiva.| |manutenção\_status|inteiro|*(somente leitura)* Status de manutenção efetiva.<br><br>Os valores possíveis são:<br>0 - *(padrão)* sem manutenção;<br>1 - manutenção em vigor.| |manutenção\_tipo|inteiro|*(somente leitura)* Tipo de manutenção efetiva.<br><br>Os valores possíveis são:<br>0 - *(padrão)* manutenção com coleta de dados;<br>1 - manutenção sem coleta de dados .| |maintenanceid|string|*(readonly)* ID da manutenção que está atualmente em vigor no host.| |name|string|Nome visível do host.<br><br>Padrão: valor da propriedade `host`.| |proxy\_hostid|string|ID do proxy que é usado para monitorar o host.| |status|inteiro|Status e função do host.<br><br>Os valores possíveis são:<br>0 - *(padrão)* host monitorado;<br>1 - host não monitorado.| |tls\_connect|integer|Conexões ao host.<br><br>Os valores possíveis são:<br>1 - *(padrão)* Sem criptografia;<br>2 - PSK;<br>4 - certificado.| |tls\_accept|inteiro|Conexões do host.<br><br>Os valores de bitmap possíveis são:<br>1 - *(padrão)* Sem criptografia;<br>2 - PSK;<br>4 - certificado.| |tls\_issuer|string|Emissor do certificado.| |tls\_subject|string|Assunto do certificado.| |tls\_psk\_identity|string|*(somente gravação)* identidade PSK. Necessário se `tls_connect` ou `tls_accept` tiver o PSK ativado.<br>Não coloque informações confidenciais na identidade do PSK, elas são transmitidas sem criptografia pela rede para informar ao receptor qual PSK usar.| |tls\_psk|string|*(write-only)* A chave pré-compartilhada, com pelo menos 32 dígitos hexadecimais. Necessário se `tls_connect` ou `tls_accept` tiver o PSK ativado.|

en-us	# Host  This class is designed to work with hosts.  Object references:\  -   [Host](/manual/api/reference/host/object#host) -   [Host inventory](/manual/api/reference/host/object#host_inventory)  Available methods:\  -   [host.create](/manual/api/reference/host/create) - creating new     hosts -   [host.delete](/manual/api/reference/host/delete) - deleting hosts -   [host.get](/manual/api/reference/host/get) - retrieving hosts -   [host.massadd](/manual/api/reference/host/massadd) - adding related     objects to hosts -   [host.massremove](/manual/api/reference/host/massremove) - removing     related objects from hosts -   [host.massupdate](/manual/api/reference/host/massupdate) - replacing     or removing related objects from hosts -   [host.update](/manual/api/reference/host/update) - updating hosts
pt-br	# Host  Esta classe foi projetada para trabalhar com hosts.  Referências de objetos:\  - [Host](/manual/api/reference/host/object#host) - [Inventário do host](/manual/api/reference/host/object#host_inventory)  Métodos disponíveis:\  - [host.create](/manual/api/reference/host/create) - criando novo     anfitriões - [host.delete](/manual/api/reference/host/delete) - excluindo hosts - [host.get](/manual/api/reference/host/get) - recuperando hosts - [host.massadd](/manual/api/reference/host/massadd) - adicionando relacionado     objetos para hosts - [host.massremove](/manual/api/reference/host/massremove) - removendo     objetos relacionados de hosts - [host.massupdate](/manual/api/reference/host/massupdate) - substituindo     ou removendo objetos relacionados dos hosts - [host.update](/manual/api/reference/host/update) - atualizando hosts

en-us	##### Host trigger tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |triggers|<|\-|<|<|Root element for triggers.| |<|expression|x|`string`|<|Trigger expression.| |<|recovery\_mode|\-|`string`|0 - EXPRESSION (default)<br>1 - RECOVERY\_EXPRESSION<br>2 - NONE|Basis for generating OK events.| |<|recovery\_expression|\-|`string`|<|Trigger recovery expression.| |<|name|x|`string`|<|Trigger name.| |<|correlation\_mode|\-|`string`|0 - DISABLED (default)<br>1 - TAG\_VALUE|Correlation mode (no event correlation or event correlation by tag).| |<|correlation\_tag|\-|`string`|<|The tag name to be used for event correlation.| |<|url|\-|`string`|<|URL associated with the trigger.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Trigger status.| |<|priority|\-|`string`|0 - NOT\_CLASSIFIED (default)<br>1 - INFO<br>2 - WARNING<br>3 - AVERAGE<br>4 - HIGH<br>5 - DISASTER|Trigger severity.| |<|description|\-|`text`|<|Trigger description.| |<|type|\-|`string`|0 - SINGLE (default)<br>1 - MULTIPLE|Event generation type (single problem event or multiple problem events).| |<|manual\_close|\-|`string`|0 - NO (default)<br>1 - YES|Manual closing of problem events.| |dependencies|<|\-|<|<|Root element for dependencies.| |<|name|x|`string`|<|Dependency trigger name.| |<|expression|x|`string`|<|Dependency trigger expression.| |<|recovery\_expression|\-|`string`|<|Dependency trigger recovery expression.| |tags|<|\-|<|<|Root element for event tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.|
pt-br	##### Tags de gatilho do host  |Elemento|Propriedade do elemento|Requerido|Tipo|Intervalo^**[1](#footnotes)**^|Descrição| |-------|----------------|--------|----|---------- -----|-----------| |triggers|<|\-|<|<|Elemento raiz para triggers.| |<|expressão|x|`string`|<|Expressão de gatilho.| |<|recovery\_mode|\-|`string`|0 - EXPRESSION (padrão)<br>1 - RECOVERY\_EXPRESSION<br>2 - NONE|Base para geração de eventos OK.| |<|recuperação\_expression|\-|`string`|<|Expressão de recuperação de gatilho.| |<|nome|x|`string`|<|Nome do gatilho.| |<|correlation\_mode|\-|`string`|0 - DISABLED (padrão)<br>1 - TAG\_VALUE|Modo de correlação (sem correlação de evento ou correlação de evento por tag).| |<|correlation\_tag|\-|`string`|<|O nome do tag a ser usado para correlação de eventos.| |<|url|\-|`string`|<|URL associado ao gatilho.| |<|status|\-|`string`|0 - ATIVADO (padrão)<br>1 - DESATIVADO|Status do gatilho.| |<|prioridade|\-|`string`|0 - NOT\_CLASSIFIED (padrão)<br>1 - INFO<br>2 - AVISO<br>3 - MÉDIA<br>4 - ALTA<br>5 - DESASTRE |Gravidade do gatilho.| |<|descrição|\-|`text`|<|Descrição do gatilho.| |<|type|\-|`string`|0 - SINGLE (padrão)<br>1 - MULTIPLE|Tipo de geração de evento (evento de problema único ou vários eventos de problema).| |<|manual\_close|\-|`string`|0 - NÃO (padrão)<br>1 - SIM|Fechamento manual de eventos de problema.| |dependencies|<|\-|<|<|Elemento raiz para dependências.| |<|nome|x|`string`|<|Nome do gatilho de dependência.| |<|expression|x|`string`|<|Expressão do gatilho de dependência.| |<|recuperação\_expression|\-|`string`|<|Expressão de recuperação do gatilho de dependência.| |tags|<|\-|<|<|Elemento raiz para tags de evento.| |<|tag|x|`string`|<|Nome da tag.| |<|valor|\-|`string`|<|Valor da tag.|

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

en-us	##### Host web scenario tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |httptests|<|\-|<|<|Root element for web scenarios.| |<|name|x|`string`|<|Web scenario name.| |<|delay|\-|`string`|Default: 1m|Frequency of executing the web scenario. Seconds, time unit with suffix or user macro.| |<|attempts|\-|`integer`|1-10 (default: 1)|The number of attempts for executing web scenario steps.| |<|agent|\-|`string`|Default: Zabbix|Client agent. Zabbix will pretend to be the selected browser. This is useful when a website returns different content for different browsers.| |<|http\_proxy|\-|`string`|<|Specify an HTTP proxy to use, using the format: `http://[username[:password]@]proxy.example.com[:port]`| |variables|<|\-|<|<|Root element for scenario-level variables (macros) that may be used in scenario steps.| |<|name|x|`text`|<|Variable name.| |<|value|x|`text`|<|Variable value.| |headers|<|\-|<|<|Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| |<|name|x|`text`|<|Header name.| |<|value|x|`text`|<|Header value.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Web scenario status.| |<|authentication|\-|`string`|0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication method.| |<|http\_user|\-|`string`|<|User name used for basic, HTTP or NTLM authentication.| |<|http\_password|\-|`string`|<|Password used for basic, HTTP or NTLM authentication.| |<|verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Verify the SSL certificate of the web server.| |<|verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Verify that the Common Name field or the Subject Alternate Name field of the web server certificate matches.| |<|ssl\_cert\_file|\-|`string`|<|Name of the SSL certificate file used for client authentication (must be in PEM format).| |<|ssl\_key\_file|\-|`string`|<|Name of the SSL private key file used for client authentication (must be in PEM format).| |<|ssl\_key\_password|\-|`string`|<|SSL private key file password.| |steps|<|x|<|<|Root element for web scenario steps.| |<|name|x|`string`|<|Web scenario step name.| |<|url|x|`string`|<|URL for monitoring.| |query\_fields|<|\-|<|<|Root element for query fields - an array of HTTP fields that will be added to the URL when performing a request.| |<|name|x|`string`|<|Query field name.| |<|value|\-|`string`|<|Query field value.| |posts|<|\-|<|<|HTTP POST variables as a string (raw post data) or as an array of HTTP fields (form field data).| |<|name|x|`string`|<|Post field name.| |<|value|x|`string`|<|Post field value.| |variables|<|\-|<|<|Root element of step-level variables (macros) that should be applied after this step.<br><br>If the variable value has a 'regex:' prefix, then its value is extracted from the data returned by this step according to the regular expression pattern following the 'regex:' prefix| |<|name|x|`string`|<|Variable name.| |<|value|x|`string`|<|Variable value.| |headers|<|\-|<|<|Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| |<|name|x|`string`|<|Header name.| |<|value|x|`string`|<|Header value.| |<|follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP redirects.| |<|retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|HTTP response retrieve mode.| |<|timeout|\-|`string`|Default: 15s|Timeout of step execution. Seconds, time unit with suffix or user macro.| |<|required|\-|`string`|<|Text that must be present in the response. Ignored if empty.| |<|status\_codes|\-|`string`|<|A comma delimited list of accepted HTTP status codes. Ignored if empty. For example: 200-201,210-299| |tags|<|\-|<|<|Root element for web scenario tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.|
pt-br	##### Hospedar tags de cenário da web  |Elemento|Propriedade do elemento|Requerido|Tipo|Intervalo^**[1](#footnotes)**^|Descrição| |-------|----------------|--------|----|---------- -----|-----------| |httptests|<|\-|<|<|Elemento raiz para cenários da web.| |<|name|x|`string`|<|Nome do cenário da Web.| |<|delay|\-|`string`|Padrão: 1m|Frequência de execução do cenário web. Segundos, unidade de tempo com sufixo ou macro de usuário.| |<|attempts|\-|`integer`|1-10 (padrão: 1)|O número de tentativas para executar as etapas do cenário web.| |<|agente|\-|`string`|Padrão: Zabbix|Agente cliente. O Zabbix fingirá ser o navegador selecionado. Isso é útil quando um site retorna conteúdo diferente para navegadores diferentes.| |<|http\_proxy|\-|`string`|<|Especifique um proxy HTTP a ser usado, usando o formato: `http://[username[:password]@]proxy.example.com[:port]` | |variables|<|\-|<|<|Elemento raiz para variáveis ​​de nível de cenário (macros) que podem ser usadas em etapas de cenário.| |<|nome|x|`texto`|<|Nome da variável.| |<|valor|x|`texto`|<|Valor da variável.| |headers|<|\-|<|<|Elemento raiz para cabeçalhos HTTP que serão enviados ao realizar uma solicitação. Os cabeçalhos devem ser listados usando a mesma sintaxe que apareceriam no protocolo HTTP.| |<|nome|x|`texto`|<|Nome do cabeçalho.| |<|valor|x|`texto`|<|Valor do cabeçalho.| |<|status|\-|`string`|0 - ATIVADO (padrão)<br>1 - DESATIVADO|Status do cenário da Web.| |<|autenticação|\-|`string`|0 - NONE (padrão)<br>1 - BASIC<br>2 - NTLM|Método de autenticação.| |<|http\_user|\-|`string`|<|Nome de usuário usado para autenticação básica, HTTP ou NTLM.| |<|http\_password|\-|`string`|<|Senha usada para autenticação básica, HTTP ou NTLM.| |<|verify\_peer|\-|`string`|0 - NO (padrão)<br>1 - YES|Verifique o certificado SSL do servidor web.| |<|verify\_host|\-|`string`|0 - NO (padrão)<br>1 - YES|Verifique se o campo Common Name ou o campo Subject Alternate Name do certificado do servidor web corresponde.| |<|ssl\_cert\_file|\-|`string`|<|Nome do arquivo de certificado SSL usado para autenticação do cliente (deve estar no formato PEM).| |<|ssl\_key\_file|\-|`string`|<|Nome do arquivo de chave privada SSL usado para autenticação do cliente (deve estar no formato PEM).| |<|ssl\_key\_password|\-|`string`|<|Senha do arquivo de chave privada SSL.| |steps|<|x|<|<|Elemento raiz para etapas do cenário da web.| |<|name|x|`string`|<|Nome da etapa do cenário da Web.| |<|url|x|`string`|<|URL para monitoramento.| |query\_fields|<|\-|<|<|Elemento raiz para campos de consulta - uma matriz de campos HTTP que serão adicionados à URL ao realizar uma solicitação.| |<|nome|x|`string`|<|Nome do campo de consulta.| |<|valor|\-|`string`|<|Valor do campo de consulta.| |posts|<|\-|<|<|Variáveis ​​HTTP POST como uma string (dados brutos de postagem) ou como uma matriz de campos HTTP (dados de campo de formulário).| |<|nome|x|`string`|<|Nome do campo de postagem.| |<|valor|x|`string`|<|Valor do campo de postagem.| |variables|<|\-|<|<|Elemento raiz das variáveis ​​de nível de etapa (macros) que devem ser aplicadas após esta etapa.<br><br>Se o valor da variável tiver um prefixo 'regex:', então seu value é extraído dos dados retornados por esta etapa de acordo com o padrão de expressão regular seguindo o prefixo 'regex:'| |<|nome|x|`string`|<|Nome da variável.| |<|valor|x|`string`|<|Valor da variável.| |headers|<|\-|<|<|Elemento raiz para cabeçalhos HTTP que serão enviados ao realizar uma solicitação. Os cabeçalhos devem ser listados usando a mesma sintaxe que apareceriam no protocolo HTTP.| |<|nome|x|`string`|<|Nome do cabeçalho.| |<|valor|x|`string`|<|Valor do cabeçalho.| |<|follow\_redirects|\-|`string`|0 - NÃO<br>1 - SIM (padrão)|Siga redirecionamentos HTTP.| |<|retrieve\_mode|\-|`string`|0 - BODY (padrão)<br>1 - HEADERS<br>2 - BOTH|Modo de recuperação de resposta HTTP.| |<|timeout|\-|`string`|Padrão: 15s|Tempo limite de execução da etapa. Segundos, unidade de tempo com sufixo ou macro de usuário.| |<|required|\-|`string`|<|Texto que deve estar presente na resposta. Ignorado se estiver vazio.| |<|status\_codes|\-|`string`|<|Uma lista delimitada por vírgulas de códigos de status HTTP aceitos. Ignorado se estiver vazio. Por exemplo: 200-201,210-299| |tags|<|\-|<|<|Elemento raiz para tags de cenário da web.| |<|tag|x|`string`|<|Nome da tag.| |<|valor|\-|`string`|<|Valor da tag.|

en-us	#### - Housekeeper  The housekeeper is a periodical process, executed by Zabbix server. The process removes outdated information and information deleted by user.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_housekeeper1.png)  In this section housekeeping tasks can be enabled or disabled on a per-task basis separately for: events and alerts/IT services/user sessions/history/trends. Audit housekeeping settings are available in a separate [menu section](/manual/web_interface/frontend_sections/administration/general#audit_log).  If housekeeping is enabled, it is possible to set for how many days data records will be kept before being removed by the housekeeper.  Deleting an item/trigger will also delete problems generated by that item/trigger.  Also, an event will only be deleted by the housekeeper if it is not associated with a problem in any way. This means that if an event is either a problem or recovery event, it will not be deleted until the related problem record is removed. The housekeeper will delete problems first and events after, to avoid potential problems with stale events or problem records.  For history and trends an additional option is available: *Override item history period* and *Override item trend period*. This option allows to globally set for how many days item history/trends will be kept (1 hour to 25 years; or "0"), in this case overriding the values set for individual items in *History storage period/Trend storage period* fields in [item configuration](/manual/config/items/item). Note, that the storage period will not be overridden for items that have configuration option *Do not keep history* and/or *Do not keep trends* enabled.  It is possible to override the history/trend storage period even if internal housekeeping is disabled. Thus, when using an external housekeeper, the history storage period could be set using the history *Data storage period* field.  ::: noteimportant If using TimescaleDB, in order to take full advantage of TimescaleDB automatic partitioning of history and trends tables, *Override item history period* and *Override item trend period* options must be enabled as well as *Enable internal housekeeping* option for history and trends. Otherwise, the data kept in these tables will still be stored in partitions, however, the housekeeper will be cleaning the history and trends by deleting individual records rather than by dropping outdated partitions. When dropping of outdated partitions is enabled, Zabbix server and frontend will no longer keep track of deleted items and history for deleted items will be cleared when an outdated partition is deleted. :::  [Time suffixes](/manual/appendix/suffixes) are supported in the period fields, e.g. 1d (one day), 1w (one week). The minimum is 1 day (1 hour for history), the maximum - 25 years.  *Reset defaults* button allows to revert any changes made.
pt-br	#### - Empregada  A governanta é um processo periódico, executado pelo servidor Zabbix. O processo remove informações desatualizadas e informações excluídas pelo usuário.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_housekeeper1.png)  Nesta seção, as tarefas de limpeza podem ser ativadas ou desativadas em um por tarefa separadamente para: eventos e alertas/serviços de TI/usuário sessões/histórico/tendências. As configurações de manutenção de auditoria estão disponíveis em um separar [menu seção](/manual/web_interface/frontend_sections/administration/general#audit_log).  Se o serviço de limpeza estiver ativado, é possível definir por quantos dias os dados registros serão mantidos antes de serem removidos pela governanta.  A exclusão de um item/gatilho também excluirá os problemas gerados por esse item/gatilho.  Além disso, um evento só será excluído pela governanta se não for associado a um problema de alguma forma. Isso significa que, se um evento for um problema ou evento de recuperação, ele não será excluído até que o registro de problema relacionado é removido. A governanta excluirá problemas primeiro e eventos depois, para evitar problemas potenciais com eventos obsoletos ou registros de problemas.  Para histórico e tendências, uma opção adicional está disponível: *Substituir item período do histórico* e *Substituir período de tendência do item*. Esta opção permite definido globalmente por quantos dias o histórico/tendências do item serão mantidos (1 hora a 25 anos; ou "0"), neste caso substituindo os valores definidos para itens individuais nos campos *Período de armazenamento de histórico/Período de armazenamento de tendências* em [configuração do item](/manual/config/items/item). Observe que o período de armazenamento não será substituído por itens que possuem configuração opção *Não manter histórico* e/ou *Não manter tendências* habilitadas.  É possível substituir o período de armazenamento de histórico/tendência mesmo se a limpeza interna está desativada. Assim, ao usar uma fonte externa governanta, o período de armazenamento do histórico pode ser definido usando o histórico Campo *Período de armazenamento de dados*.  ::: não importante Se estiver usando o TimescaleDB, para obter vantagem do particionamento automático de histórico e tendências do TimescaleDB tabelas, *Substituir período do histórico do item* e *Substituir período de tendência do item* as opções devem ser ativadas, bem como a opção *Ativar limpeza interna* para história e tendências. Caso contrário, os dados mantidos nessas tabelas serão ainda será armazenado em divisórias, no entanto, a governanta estará limpando o histórico e as tendências excluindo registros individuais em vez de descartando partições desatualizadas. Ao descartar partições desatualizadas é habilitado, o servidor Zabbix e o frontend não acompanharão mais os arquivos excluídos itens e histórico para itens excluídos serão apagados quando um desatualizado partição é excluída. :::  [Sufixos de tempo](/manual/apêndice/sufixos) são suportados no período campos, por exemplo 1d (um dia), 1w (uma semana). O mínimo é 1 dia (1 hora para a história), o máximo - 25 anos.  O botão *Redefinir padrões* permite reverter quaisquer alterações feitas.

en-us	#### housekeeping  Changes:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) added support of property `hk_events_service`.\
pt-br	#### housekeeping  Mudanças:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) adicionado suporte da propriedade `hk_events_service`.\

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

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

en-us	### Housekeeping  The settings object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |hk\_events\_mode|integer|Enable internal housekeeping for events and alerts.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_events\_trigger|string|Trigger data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_events\_service|string|Service data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_internal|string|Internal data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_discovery|string|Network discovery data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_autoreg|string|Autoregistration data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_services\_mode|integer|Enable internal housekeeping for services.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_services|string|Services data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_audit\_mode|integer|Enable internal housekeeping for audit.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_audit|string|Audit data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_sessions\_mode|integer|Enable internal housekeeping for sessions.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_sessions|string|Sessions data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_history\_mode|integer|Enable internal housekeeping for history.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_history\_global|integer|Override item history period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_history|string|History data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 90d.| |hk\_trends\_mode|integer|Enable internal housekeeping for trends.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_trends\_global|integer|Override item trend period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_trends|string|Trends data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |db\_extension|string|*(readonly)* Configuration flag DB extension. If this flag is set to "timescaledb" then the server changes its behavior for housekeeping and item deletion.| |compression\_status|integer|Enable TimescaleDB compression for history and trends.<br><br>Possible values:<br>0 - *(default)* Off;<br>1 - On.| |compress\_older|string|Compress history and trends records older than specified period. Accepts seconds and time unit with suffix.<br><br>Default: 7d.| |compression\_availability|integer|*(readonly)* Compression availability.<br><br>Possible values:<br>0 - Unavailable;<br>1 - Available.|
pt-br	### Serviço de limpeza  O objeto de configurações tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--------|---------------------------------------- -----------|-----------| |hk\_events\_mode|integer|Ativar limpeza interna para eventos e alertas.<br><br>Valores possíveis:<br>0 - Desativar;<br>1 - *(padrão)* Ativar.| |hk\_events\_trigger|string|Período de armazenamento de dados do acionador. Aceita segundos e unidade de tempo com sufixo.<br><br>Padrão: 365d.| |hk\_events\_service|string|Período de armazenamento de dados do serviço. Aceita segundos e unidade de tempo com sufixo.<br><br>Padrão: 1d.| |hk\_events\_internal|string|Período de armazenamento de dados internos. Aceita segundos e unidade de tempo com sufixo.<br><br>Padrão: 1d.| |hk\_events\_discovery|string|Período de armazenamento de dados de descoberta de rede. Aceita segundos e unidade de tempo com sufixo.<br><br>Padrão: 1d.| |hk\_events\_autoreg|string|Período de armazenamento de dados de registro automático. Aceita segundos e unidade de tempo com sufixo.<br><br>Padrão: 1d.| |hk\_services\_mode|integer|Ativar limpeza interna para serviços.<br><br>Valores possíveis:<br>0 - Desativar;<br>1 - *(padrão)* Ativar.| |hk\_services|string|Período de armazenamento de dados de serviços. Aceita segundos e unidade de tempo com sufixo.<br><br>Padrão: 365d.| |hk\_audit\_mode|integer|Ativar manutenção interna para auditoria.<br><br>Valores possíveis:<br>0 - Desativar;<br>1 - *(padrão)* Ativar.| |hk\_audit|string|Período de armazenamento de dados de auditoria. Aceita segundos e unidade de tempo com sufixo.<br><br>Padrão: 365d.| |hk\_sessions\_mode|integer|Ativar limpeza interna para sessões.<br><br>Valores possíveis:<br>0 - Desativar;<br>1 - *(padrão)* Ativar.| |hk\_sessions|string|Período de armazenamento de dados da sessão. Aceita segundos e unidade de tempo com sufixo.<br><br>Padrão: 365d.| |hk\_history\_mode|integer|Ativar manutenção interna para histórico.<br><br>Valores possíveis:<br>0 - Desativar;<br>1 - *(padrão)* Ativar.| |hk\_history\_global|integer|Substituir o período do histórico do item.<br><br>Valores possíveis:<br>0 - Não substituir;<br>1 - *(padrão)* Substituir.| |hk\_history|string|Período de armazenamento de dados do histórico. Aceita segundos e unidade de tempo com sufixo.<br><br>Padrão: 90d.| |hk\_trends\_mode|integer|Ativar manutenção interna para tendências.<br><br>Valores possíveis:<br>0 - Desativar;<br>1 - *(padrão)* Ativar.| |hk\_trends\_global|integer|Substituir período de tendência do item.<br><br>Valores possíveis:<br>0 - Não substituir;<br>1 - *(padrão)* substituir.| |hk\_trends|string|Período de armazenamento de dados do Trends. Aceita segundos e unidade de tempo com sufixo.<br><br>Padrão: 365d.| |db\_extension|string|*(readonly)* Extensão do banco de dados do sinalizador de configuração. Se esse sinalizador estiver definido como "timescaledb", o servidor altera seu comportamento para limpeza e exclusão de item.| |compression\_status|integer|Ative a compactação do TimescaleDB para histórico e tendências.<br><br>Valores possíveis:<br>0 - *(padrão)* Desativado;<br>1 - Ativado.| |compress\_older|string|Comprimir registros de histórico e tendências anteriores ao período especificado. Aceita segundos e unidade de tempo com sufixo.<br><br>Padrão: 7d.| |compressão\_disponibilidade|inteiro|*(somente leitura)* Disponibilidade de compactação.<br><br>Valores possíveis:<br>0 - Indisponível;<br>1 - Disponível.|

en-us	# Housekeeping  This class is designed to work with housekeeping.  Object references:\  -   [Housekeeping](/manual/api/reference/housekeeping/object#housekeeping)  Available methods:\  -   [housekeeping.get](/manual/api/reference/housekeeping/get) -     retrieve housekeeping -   [housekeeping.update](/manual/api/reference/housekeeping/update) -     update housekeeping
pt-br	# Serviço de limpeza  Esta classe é projetada para trabalhar com tarefas domésticas.  Referências de objetos:\  - [Arrumação](/manual/api/referência/arrumação/objeto#arrumação)  Métodos disponíveis:\  - [housekeeping.get](/manual/api/reference/housekeeping/get) -     recuperar a limpeza - [housekeeping.update](/manual/api/reference/housekeeping/update) -     atualizar a limpeza

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

en-us	#### How to  To begin with, you need to create a PHP file and save it as `local/conf/brand.conf.php`. The contents of the file should be the following:  ``` {.php} <?php  return []; ```  This will hide the links to Zabbix Support and Zabbix Integrations.
pt-br	#### Como Fazer Para começar, você precisa criar um arquivo PHP e salvá-lo como `local/conf/brand.conf.php`. O conteúdo do arquivo deve ser o Segue:  ``` {.php} <?php  Retorna []; ```  Isso ocultará os links para o Zabbix Support e Zabbix Integrations.

en-us	#### HP OpenView  Zabbix can be configured to send messages to OpenView server. The following steps must be performed:
pt-br	#### HP OpenView  O Zabbix pode ser configurado para enviar mensagens para um servidor OpenView. Os passos a seguir precisam ser executados:

en-us	### HTML support in Geomap attribution dropped  The attribution text for the [Geomap dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) can now only contain plain text; HTML support has been dropped. If this field already contains HTML, it will be rendered as plain text after the upgrade.  In [Geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical-maps) settings in the Administration → General section, the field *Attribution* is now only visible when *Tile provider* is set to *Other*.
pt-br	### Suporte HTML removido na atribuição do Geomap   O texto atribuído para [Geomap dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) agora pode somente conter texto puro; o suporte ao HTML foi removido. Se este campo já conter HTML, será renderizado como texto puro depois da atualização.   Nas configurações do [Geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical-maps) em  Administração → Seção Geral, o campo *Atribuição* agora fica somente visível quando *Tile provider* é configurado para *Outro*.

en-us	### HTML support in Geomap attribution dropped  The attribution text for the [Geomap dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) can now only contain plain text; HTML support has been dropped.  In [Geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical-maps) settings in the Administration → General section, the field *Attribution* is now only visible when *Tile provider* is set to *Other*.
pt-br	### O suporte a HTML na atribuição do Geomap foi removido  Agora, o texto de atribuição para o  [Geomap dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) pode somente conter um texto simples; o suporte para HTML foi removido.   Nas configurações [Geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical-maps) da  Administração→ Sessão geral, o campo *Atribuição* somente estará visível quando o *Tile provider* estiver configurado como *Outro*.

en-us	### HTTP field  The HTTP field object defines a name and value that is used to specify variable, HTTP header, POST form field data of query field data. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Name of header / variable / POST or GET field.| |**value**<br>(required)|string|Value of header / variable / POST or GET field.|
pt-br	### Campo HTTP  O objeto de campo HTTP define um nome e um valor que é usado para  especificar a variável, o cabeçalho HTTP, os dados do campo de formulário  POST dos dados do campo de consulta. Tem as seguintes propriedades.  |Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição| |--|--|------| |**name**<br>(required)|string|Nome do cabeçalho / variável / Campo POST ou GET.| |**value**<br>(required)|string|Valor do cabeçalho / variável / Campo POST ou GET.|