[comment]: # translation:outdated
[comment]: # ({4d20cd83-50342b23})
# 1 Criando um item
[comment]: # ({/4d20cd83-50342b23})
[comment]: # ({d3a04061-d3a04061})
#### Visão geral
Para criar um item no frontend do Zabbix, faça o seguinte:
- · Vá para: *Configuração* → *Hosts*
- · Clique em *Items* na linha do host
- · Clique em *Create item* no canto superior direito da tela
- · Insira os parâmetros do item no formulário
Você também pode criar um item abrindo um existente, pressionando o botão *Clone* e, em seguida, salvando com um nome diferente.
[comment]: # ({/d3a04061-d3a04061})
[comment]: # ({743cf9ea-d0a0a311})
#### Configuração
A aba **Item** contém atributos genéricos do item.
Todo os campos de entrada mandatórios são demarcados com um asterico vermelho.
|Parâmetro|Descrição|
|---------|-----------|
|*Nome*|Nome do item.|
|*Tipo*|Tipo do item. Veja sessões individuais de [item type](itemtypes).|
|*Chave*|Chave to item (até 2048 caracteres).
As [item keys](itemtypes) suportadas podem ser encontradas em seções de tipo de item individual.
A chave deve ser única em um host.
Se a chave for do tipo 'Zabbix agent', 'Zabbix agent (active)' ou 'Simple check', o valor da chave deve ser suportado pelo Zabbix agent ou Zabbix server.
Veja também: o [key format](/manual/config/items/item/key) correto.|
|*Tipo da informação*|Tipo do dadoarmazenado em uma base de dados após a realização de conversões, se houver.
**Numérico (sem sinal)** - inteiro sem sinal de 64 bits
**Numérico (ponto flutuante)** - número de ponto flutuante de 64 bits
Este tipo permitirá a precisão de aproxidamente 15 dígitos em uma faixa de aproximadamente -1.79E+308 to 1.79E+308 (com a exceção do [PostgreSQL 11 and earlier versions](/manual/installation/known_issues#floating_point_values)).
Receber valores em notação científica também é suportado. Ex.: 1.23E+7, 1e308, 1.1E-4.
**Caracter** - dados de texto curto
**Log** - dados de texto longo com propriedades relacionadas ao log opcionais (timestamp, source, severidade, logeventid)
**Texto** - dados de texto longo.Veja também [text data limits](#text-data-limits).
Para chaves de itens que retornam dados em apenas um formato específicou, o tipo da informação é selecionada de forma automática.|
|*Intreface do host*|Selecione a interface do host. Este campo está disponível quando estiver editiando um item no host.|
|*Unidades*|Se o símbolo da unidade for definido, o Zabbix o adicionar após o processamento do valor recebido e o exibirá com o prefixo de unidade definido.
Por padrão, se o valor original exceder 1000, ele será dividido por 1000 e exibido de acordo. Por exemplo, se você configurar *bps* e receber o valor 881764, ele será exibido como 881.76 Kbps.
O padrão de memória[JEDEC](https://en.wikipedia.org/wiki/JEDEC_memory_standards) é utilizado para o processar as unidades **B** (byte), **Bps** (bytes por segundo), as quais são divididas por 1024. Deste modo, se a unidade for configurada como **B** ou **Bps** o Zabbix exibirá:
1 como 1B/1Bps
1024 como 1KB/1KBps
1536 como 1.5KB/1.5KBps
O processamento especial é utilizado se as seguintes unidas relacionadas a tempo forem utilizadas:
**unixtime** - traduzido para "aaaa.mm.dd hh:mm:ss". Para traduzir corretamente, o valor recebido deve ser do tipo numérico (sem sinal).
**uptime** - traduzido para "hh:mm:ss" or "N dias, hh:mm:ss"
Por exemplo, se você receber um valor como 881764 (segundos), ele será exibido como "10 dias, 04:56:04"
**s** - traduzido para "aaa mmm ddd hhh mmm sss ms"; o parêmtro é tratado como o número de segundos.
Por exemplo, se você receber um valor como 881764 (seconds), ele será exibido como "10d 4h 56m"
Apenas 3 unidades principais são mostradas, como por exemplo "1m 15d 5h" ou "2h 4m 46s". Caso não tenha dias para serem exibidos, apenas dois níveis serão exibidos - "1m 5h" (minutos, segundos ou milisegundos não são exibidos). Será traduzido para "< 1 ms" se o valor for inferior a 0.001.
*Observação* se o prefixo da unidade for configurado com `!`, então o prefixo da unidade e/ou o processamento não serão aplicados aos valores do item. Veja [unit conversion](#unit_conversion).|
|*Intervalo de atualização*|Coleta um novo valor para este item a cada N segundos. O intervalo máximo de atualização permitido é de 86.400 segundos (1 dia).
[Time suffixes](/manual/appendix/suffixes) são suportados, ex.: 30s, 1m, 2h, 1d.
[User macros](/manual/config/macros/user_macros) são suportadas.
Uma única macro deve preencher todo o campo. Não há suporte para várias macros em um campo ou macros misturadas com texto.
*Observação*: o intervalo de atualização pode ser configurado para '0' se os intervalos customizados existirem com um valor diferente de zero. Se for configurado para '0' e o intervalo customizado (flexível ou agendado) existir com um valor diferente de zero, o item será coletado durante a duração do intervalo customizado.
*Observação:* a primeira pesquisa de item após o item se tornar ativo ou após a alteração do intervalo de atualização pode ocorrer antes do valor configurado.
Um item passivo existente pode ser coletado para valores imediatamente pressionando o *Execute now* [button](#form_buttons).|
|*Intervalos customizados*|Você pode criar regras customizadas para a checagem de itens:
**Flexível** - cria uma exceção para o *intervalo de atualização* (intervalo com frequência distintai)
**Agendada** - cria um esquema de coleta customizado.
Para informações maisdetalhadas veja [Custom intervals](/manual/config/items/item/custom_intervals).
[Time suffixes](/manual/appendix/suffixes) são suportados no campo *Intervalo*, ex.: 30s, 1m, 2h, 1d.
[User macros](/manual/config/macros/user_macros) são suportados.
Uma única macro deve preencher todo o campo. Não há suporte para várias macros em um campo ou macros misturadas com texto.
O agendamento é suportado desde a o Zabbix 3.0.0.
*Observação*: não disponível para itens do tipo agente Zabbix ativo.|
|*Período de armazenamento de histórico*|Selecione:
**Não manter histórico** - o histórico do item não será armazenado. Útil para itens do tipo mestre se apenas os itens dependentes devem manter o histórico.
Esta configuração não pode ser sobreescrita pelo por [settings](/manual/web_interface/frontend_sections/administration/general#housekeeper) globais do housekeeper.
**Período de armazenamentoS** - especifica a duração de manter histórico detalhado na base de dados (1 hora a 25 anos). Dados mais antigos serão removidos pelo housekeeper. Armazenado em segundos.
[Time suffixes](/manual/appendix/suffixes) são suportados, ex.: 2h, 1d. [User macros](/manual/config/macros/user_macros) são suportadas.
O valor do *Período de armazenamento* pode ser sobreescrito globalmente em *Administração → Geral → [Housekeeper](/manual/web_interface/frontend_sections/administration/general#housekeeper)*.
Se existir uma configuração de sobreescrita global,um ícone verde será exibido . Se você posicionar o seu cursor sob o ícone, uma mensagem será exebida, ex.: *Sobrescrito por configurações globais de limpeza de dados (1d)*.
É recomendado manter os dados coletados pelo menor tempo possível para reduzir o tamanho dos dados históricos na base de dados. Em vez de manter um longo histórico de valores, você pode manter dados mais longos de estatísticas.
Veja também [History and trends](/manual/config/items/history_and_trends).|
|*Período de armazenamento de estatísticas*|Selecione:
**Não manter dados estatísticos** - as estatísticas não serão armazenadas.
Esta configuração não poderá ser sobreescrita pela [settings](/manual/web_interface/frontend_sections/administration/general#housekeeper) global do housekeeper.
**Período de armazenamento** - especifica a duração para manter dados históricos agregados (hourly min, max, avg, count) na base de dados (1 dia a 25 anos). Dados antigos serão removidos pelo housekeeper. Armazenado em segundos.
[Time suffixes](/manual/appendix/suffixes) são suportados, ex.: 24h, 1d. [User macros](/manual/config/macros/user_macros) são suportados.
O valor do *Período de armazenamento* pode ser sobreescrito globalmente em *Administração → Geral → [Housekeeper](/manual/web_interface/frontend_sections/administration/general#housekeeper)*.
Se existir uma configuração de sobreescrita global,um ícone verde será exibido . Se você posicionar o seu cursor sob o ícone, uma mensagem será exebida, ex.: *Sobrescrito por configurações globais de limpeza de dados (7d)*.
*Observação:* Manter estatísticas de dados não numéricos - caracter, log e texto - não está disponível.
Veja também [History and trends](/manual/config/items/history_and_trends).|
|*Mapeamento de valores*|Aplica mapeamento de valores para o item. [Value mapping](/manual/config/items/mapping) não altera os valores recebidos, é apenas para a exibição de dados.
Funciona com itens dos tipo *Numérico(sem sinal)*, *Numérico(ponto flutuante)* e *Caracter*.
Por exemplo, "Windows service states".|
|*Formato do log de tempo*|Disponível somente para itens do tipo **Log**. Placeholders suportados:
\* **y**: *Ano (1970-2038)*
\* **M**: *Mês (01-12)*
\* **d**: *Dia (01-31)*
\* **h**: *Hora (00-23)*
\* **m**: *Minuto (00-59)*
\* **s**: *Segundo (00-59)*
Se deixado em branco não haverá o processamento do timestamp.
Por exemplo, considere a seguinte linha do arquivo de log do agente Zabbix:
" 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."
Ela começa com seis posições de caracteres para PID, seguidas por data, hora e o restante da linha.
O formato de hora de log para esta linha seria "pppppp:aaaaMMdd:hhmmss".
Observe que " p" e ":" são apenas placeholders e podem ser qualquer coisa menos "yMdhms".|
|*Popular campos de invetário do host*|Você pode selecionar o campo de inventário do host que aquele valor deve popular. Isso funcionará se o preenchimento automático do [inventory](/manual/config/hosts/inventory) estiver configurado para o host.
Este campo não está disponível se o *Tipo da informação* for configurada para 'Log'.|
|*Descrição*|Forneça uma descrição do item.|
|*Habilitado*|Marque a caixa de seleção para habilitar o item para que seja processado.|
|*Dados recentes*|Clique no link para ver os dados mais recentes do item.
Este link só está disponível ao editar um item já existente.|
::: noteclassic
Campos de tipos de itens específicos estão descritos em [corresponding
pages](itemtypes).
:::
::: noteclassic
Quando estiver editando um item de [template](/manual/config/templates) no host, uma quantidade de campos é de somente leitura. Você pode usar o link no cabeçalho do formulário e ir para a template e editá-los nela, tendo em mente que as alterações em uma template irá alterar o item para todos os hosts em que a tempalte está vinculada.
:::
A aba de **Tags** permite a definição de [tags](/manual/config/tagging) de itens.
[comment]: # ({/743cf9ea-d0a0a311})
[comment]: # ({9974d990-4f9077b8})
##### Pré-processamento do valor do item
A aba **Pré-processamento** permite definir [transformation
rules](/manual/config/items/preprocessing) para os valores recebidos.
[comment]: # ({/9974d990-4f9077b8})
[comment]: # ({c8cfd6d9-006c45ea})
#### Testando
É possível testar um item e, se configurado corretamente, obter um valor de retorno verdadeiro. O teste pode ocorrer antes mesmo do item ser salvo.
O teste é disponível para itens em hosts e templates, protótipos de itens e regras de descoberta. O teste não está disponível para itens do tipo ativo.
O teste de itens está disponível para os seguintes itens do tipo passivo:
- Agent Zabbix
- Agente SNMP (v1, v2, v3)
- Agente IPMI
- Checagem via SSH
- Checagem via Telnet
- Agente JMX
- Checagem simples (exceto itens `icmpping*`, `vmware.*`)
- Checagem interna do Zabbix
- Itens calculados
- Checagem external
- Monitor de base da dados
- Agente HTTP
- Script
Para testar um item, clique no botão *Teste* na configuração do item. Note que o botão *Teste* estará desabilitado se não for possível testar o item (tais como checagens ativas, desconsiderando checagens simples).
O formulário para testar o item possui campos os parâmetros de host necessários (endereço do host, porta, nome do proxy ou sem proxy) e detalhes específicos do item (tais como a comunidade do SNMPv2 ou as credenciais de segurança para o SNMPv3). Esses campos são cientes do contexto:
- Os valores são pré-preenchidos quando possível, ou seja, para itens que requerem agente, pegando as informações da interface do agente selecionado do host
- Os valores devem ser preenchidos manualmente para itens de modelo
- Os valores de macro de texto simples são resolvidos
- Campos onde o valor (ou parte do valor) é um segredo ou Vault macro estão vazias e devem ser inseridas manualmente. Se algum item parâmetro contém um valor de macro secreta, o seguinte aviso mensagem é exibida: "O item contém macros definidas pelo usuário com segredo valores. Os valores dessas macros devem ser inseridos manualmente."
- Os campos são desabilitados quando não são necessários no contexto do item tipo (por exemplo, o campo de endereço do host e o campo de proxy estão desabilitados para itens calculados)
Para tester um item, clique em *Obter valor*. Se o valor for recebido com sucesso, o campo *Valor* será preenchido, movendo o valor atual (caso exista) para o campo *Valor anterior* enquanto calcula o campo *Tempo anterior*, ex.: a diferença de tempo entre os dois valores e tentando detectar uma sequência de final de arquivo e trocar para CRLF se detectar "\\n\\r" no valor recebido.
{width="600"}
Se a configuração estiver incorreta, uma mensagem de erro é exibida
descrevendo a possível causa.
A coleta bem sucedida do valor de um host pode ser utilizada para testar os [preprocessing steps](/manual/config/items/preprocessing#testing).
[comment]: # ({/c8cfd6d9-006c45ea})
[comment]: # ({b00dba3b-4b126a62})
#### Botões de formulário
Os botões na parte inferior do formulário permitem a realização de diversas operações.
| | |
|---|---|
||Adicione um item. Este botão está disponível apenas para novos itens.|
||Atualiza as propriedades de um item.|
||Cria um outro item baseado nas propriedades do item atual.|
||Executa uma checagem imediata para um novo valor do item. Suportado somente em checagens **passivas** (veja [more details](/manual/config/items/check_now)).
*Observação* o verificar um valor imediatamente, o cache de configuração não é atualizado, portanto, o valor não refletirá alterações muito recentes na configuração do item.|
||Teste se a configuração do item está correta obtendo um valor|
||Deleta o histórico e estatísticas de um item.|
||Deleta o item.|
||Cancela a edição das propriedades do item.|
[comment]: # ({/b00dba3b-4b126a62})
[comment]: # ({409e4cc6-8cb32bf5})
#### Limite de dados de texto
O limite de dados de texto depend na base de dados utilizada no backend. Antes de armazenar o texto valores no banco de dados eles são truncados para corresponder ao valor do banco de dados limite de tipo:
|Base de dados|Tipo de informação|<|<|
|--------|-------------------|-|-|
| |**Caracter**|**Log**|**Texto**|
|MySQL|255 caracteres|65536 bytes|65536 bytes|
|PostgreSQL|255 caracteres|65536 caracteres|65536 caracteres|
|Oracle|255 caracteres|65536 caracteres|65536 caracteres|
[comment]: # ({/409e4cc6-8cb32bf5})
[comment]: # ({a4f78784-d4406a73})
#### Limite de script personalizado
O comprimento do script personalizado disponível depende do banco de dados usado:
| | | |
|---|---|---|
|*Base de dados*|*Limite em caracteres*|*Limite em bytes*|
|**MySQL**|65535|65535|
|**Oracle Database**|2048|4000|
|**PostgreSQL**|65535|sem limite|
|**SQLite (somente no proxy Zabbix)**|65535|sem limite|
[comment]: # ({/a4f78784-d4406a73})
[comment]: # ({a5f02458-2cd40177})
#### Itens não suportados
Um item pode se tornar não suportado se não for possível coletar o seu valor por algum motivo. Esses itens ainda são verificados novamente em seu *[Update
interval](/manual/config/items/item?#configuration)* padrão.
Itens não suportados são reportados como tendo um estado NÃO SUPORTADO.
[comment]: # ({/a5f02458-2cd40177})