1 Criando um item

Visão geral

Para criar um item no frontend do Zabbix, faça o seguinte:

• Vá para: Coleta de dados > Hosts
• Clique em Itens na linha do host
• Clique em Criar 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 já existente, pressionando o botão Clonar e salvando com um nome diferente.

Configuração

A aba Item contém os atributos gerais do item.

Todos os campos obrigatórios são marcados com um asterisco vermelho.

Parâmetro	Descrição
Nome	Nome do item. Macros de usuário são suportadas.
Tipo	Tipo do item. Veja as seções individuais de tipos de item.
Chave	Chave do item (até 2048 caracteres). As chaves de item suportadas podem ser encontradas nas seções de tipos de item. A chave deve ser única dentro de um único host. Se o tipo de chave for '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 formato correto da chave.
Tipo de informação	Tipo de dado conforme armazenado no banco de dados após realizar conversões, se houver. Numérico (sem sinal) - inteiro sem sinal de 64 bits. Observe que um valor de ponto flutuante, se recebido para um item inteiro, será truncado da parte decimal. Numérico (float) - número de ponto flutuante de 64 bits. Este tipo permitirá precisão de aproximadamente 15 dígitos e intervalo de aproximadamente -1.79E+308 a 1.79E+308 (com exceção do PostgreSQL 11 e versões anteriores). Receber valores em notação científica também é suportado. Ex: 1.23E+7, 1e308, 1.1E-4. Caracter - dados de texto curtos. Log - dados de texto longos com propriedades opcionais relacionadas a log (timestamp, source, severity, logeventid). Texto - dados de texto longos. Veja também limites de dados de texto. Binário - número binário (suportado apenas para itens dependentes). Um número binário será resolvido para uma string estática "binary value" em Últimos dados; {ITEM.VALUE}, {ITEM.LASTVALUE} e macros de expressão serão resolvidos como UNKNOWN. Para chaves de item que retornam dados apenas em um formato específico, o tipo de informação correspondente é selecionado automaticamente.
Interface do host	Selecione a interface do host. Este campo está disponível ao editar um item no nível do host.
Unidades	Se um símbolo de unidade for definido, o Zabbix aplica pós-processamento ao valor do item recebido e o exibe com o sufixo de unidade especificado. Unidades suportadas com formatação especial (e exemplos de valor recebido → valor exibido): B - bytes (1024 → 1 KB) Bps - bytes por segundo (1024 → 1 KBps) s - segundos, exibidos usando até três maiores unidades de tempo não nulas (881764 → 10d 4h 56m) uptime - tempo decorrido em hh:mm:ss ou N dias, hh:mm:ss (881764 → 10 dias, 04:56:04) unixtime - timestamp Unix, formatado como yyyy.mm.dd hh:mm:ss (881764 → 1970-01-11 04:56:04 AM); para formatação correta, o valor recebido deve ser Numérico (sem sinal). Para outras unidades (como Hz, W, etc.), se o valor recebido exceder 1000, ele é dividido por 1000 e exibido com um prefixo correspondente (5000 → 5 KHz, 881764 → 881.76 KW). Se o símbolo da unidade for prefixado com !, a conversão e o prefixo da unidade são desabilitados (1024 !B → 1024 B, 61 !s → 61 s). Para mais exemplos e detalhes sobre símbolos e conversão de unidades, veja Sufixos de valor de item.
Intervalo de atualização	Recupera um novo valor para este item a cada N segundos. O intervalo máximo permitido é 86400 segundos (1 dia). Sufixos de tempo são suportados, ex: 30s, 1m, 2h, 1d. Macros de usuário são suportadas. Uma única macro deve preencher todo o campo. Múltiplas macros em um campo ou macros misturadas com texto não são suportadas. Nota: O intervalo de atualização só pode ser definido como '0' se existirem intervalos personalizados com valor diferente de zero. Se definido como '0', e um intervalo personalizado (flexível ou agendado) existir com valor diferente de zero, o item será coletado durante a duração do intervalo personalizado. Nota que a primeira coleta do item após ele se tornar ativo ou após alteração do intervalo pode ocorrer antes do valor configurado. Novos itens serão verificados em até 60 segundos após sua criação, a menos que tenham Agendamento ou Intervalo de atualização flexível e o Intervalo de atualização esteja definido como 0. Um item passivo existente pode ser coletado imediatamente pressionando o botão Executar agora botão.
Intervalos personalizados	Você pode criar regras personalizadas para checar o item: Flexível - cria uma exceção ao Intervalo de atualização (intervalo com frequência diferente). Agendamento - cria um agendamento de coleta personalizado. Para informações detalhadas veja Intervalos personalizados. Sufixos de tempo são suportados no campo Intervalo, ex: 30s, 1m, 2h, 1d. Macros de usuário são suportadas. Uma única macro deve preencher todo o campo. Múltiplas macros em um campo ou macros misturadas com texto não são suportadas.
Timeout	Define o timeout da checagem do item (disponível para tipos de item suportados). Selecione a opção de timeout: Global - o timeout do proxy/global é usado (exibido no campo Timeout desabilitado). Substituir - timeout personalizado é usado (definido no campo Timeout; intervalo permitido: 1 - 600s). Sufixos de tempo, ex: 30s, 1m, e macros de usuário são suportados. Clicar no link Timeouts permite configurar timeouts do proxy ou globais (se um proxy não for usado). Observe que o link Timeouts é visível apenas para usuários do tipo Super admin com permissão para as seções do frontend Administração > Geral ou Administração > Proxies.
Histórico	Selecione: Não armazenar - o histórico do item não é armazenado. Útil para itens mestres se apenas itens dependentes precisarem manter histórico. Esta configuração não pode ser sobrescrita pelas configurações globais do housekeeper. Armazenar até - especifique a duração de armazenamento do histórico detalhado no banco de dados (1 hora a 25 anos). Dados mais antigos serão removidos pelo housekeeper. Armazenado em segundos. Sufixos de tempo são suportados, ex: 2h, 1d. Macros de usuário são suportadas. O valor de Armazenar até pode ser sobrescrito globalmente em Administração > Housekeeping. Se existir uma configuração global de sobrescrita, um ícone laranja é exibido. Se você posicionar o mouse sobre ele, uma mensagem de aviso é exibida, ex: Sobrescrito pelas configurações globais do housekeeper (1d). Recomenda-se manter os valores gravados pelo menor tempo possível para reduzir o tamanho do histórico de valores no banco de dados. Em vez de armazenar um longo histórico de valores, você pode armazenar tendências por mais tempo. Veja também Histórico e tendências.
Tendências	Selecione: Não armazenar - tendências não são armazenadas. Esta configuração não pode ser sobrescrita pelas configurações globais do housekeeper. Armazenar até - especifique a duração de armazenamento do histórico agregado (mínimo, máximo, média, contagem por hora) no banco de dados (1 dia a 25 anos). Dados mais antigos serão removidos pelo housekeeper. Armazenado em segundos. Sufixos de tempo são suportados, ex: 24h, 1d. Macros de usuário são suportadas. O valor de Armazenar até pode ser sobrescrito globalmente em Administração > Housekeeping. Se existir uma configuração global de sobrescrita, um ícone laranja é exibido. Se você posicionar o mouse sobre ele, uma mensagem de aviso é exibida, ex: Sobrescrito pelas configurações globais do housekeeper (7d). Nota: Manter tendências não está disponível para dados não numéricos - caracter, log e texto. Veja também Histórico e tendências.
Mapeamento de valor	Aplica mapeamento de valor a este item. O mapeamento de valor não altera os valores recebidos, serve apenas para exibição. Funciona com itens Numérico (sem sinal), Numérico (float) e Caracter. Por exemplo, "Estados de serviços do Windows".
Formato de tempo do log	Disponível apenas 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, o timestamp será definido como 0 em tempo Unix, representando 1 de janeiro de 1970. Por exemplo, considere a seguinte linha do arquivo de log do Zabbix agent: " 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)." Ela começa com seis posições de caractere para o PID, seguidas por data, hora e o restante da mensagem. O formato de tempo do log para esta linha seria "pppppp:yyyyMMdd:hhmmss". Observe que os caracteres "p" e ":" são placeholders e podem ser quaisquer caracteres, exceto "yMdhms".
Preenche campo de inventário do host	Você pode selecionar um campo de inventário do host que o valor do item irá preencher. Isso funcionará se o preenchimento automático do inventário estiver habilitado para o host. Este campo não está disponível se o Tipo de informação estiver definido como 'Log'.
Descrição	Insira uma descrição do item. Macros de usuário são suportadas.
Habilitado	Marque a caixa para habilitar o item para que ele seja processado. Quando você desabilita o item, ele é imediatamente removido do cache de histórico (exceto pelo seu último valor, que é mantido para logs).
Últimos dados	Clique no link para ver os últimos dados do item. Este link só está disponível ao editar um item já existente.

A aba Tags permite definir tags no nível do item.

Pré-processamento de valor de item

A aba Pré-processamento permite definir regras de transformação para os valores recebidos.

Testando

É possível testar um item e, se configurado corretamente, obter um valor real como retorno. O teste pode ocorrer mesmo antes de um item ser salvo.

O teste está disponível para itens de host e template, protótipos de item e regras de descoberta de baixo nível. O teste não está disponível para itens ativos.

O teste de item está disponível para os seguintes tipos de item passivo:

• Zabbix agent
• SNMP agent (v1, v2, v3)
• IPMI agent
• Verificações SSH
• Verificações Telnet
• JMX agent
• Verificações simples (exceto itens icmpping*, vmware.*)
• Zabbix internal
• Itens calculados
• Verificações externas
• Monitor de banco de dados
• HTTP agent
• Script
• Navegador

Para testar um item, clique no botão Testar na parte inferior do formulário de configuração do item. Observe que o botão Testar ficará desabilitado para itens que não podem ser testados (como verificações ativas, verificações simples excluídas).

O formulário de teste de item possui campos para os parâmetros necessários do host (endereço do host, porta, testar com server/proxy (nome do proxy)) e detalhes específicos do item (como comunidade SNMPv2 ou credenciais de segurança SNMPv3). Esses campos são sensíveis ao contexto:

• Os valores são preenchidos automaticamente quando possível, ou seja, para itens que exigem um agent, obtendo as informações da interface agent selecionada do host.
• Os valores devem ser preenchidos manualmente para itens de template.
• Os valores de macros em texto simples são resolvidos.
• Os campos em que o valor (ou parte do valor) é uma macro secreta ou macro do Vault ficam vazios e devem ser preenchidos manualmente. Se qualquer parâmetro do item contiver um valor de macro secreto, a seguinte mensagem de aviso será exibida: "Item contains user-defined macros with secret values. Values of these macros should be entered manually."
• Os campos são desabilitados quando não são necessários no contexto do tipo de item (por exemplo, o campo de endereço do host e o campo proxy são desabilitados para itens calculados)

Para testar o item, clique em Obter valor. Se o valor for recuperado com sucesso, ele preencherá o campo Valor, movendo o valor atual (se houver) para o campo Valor anterior enquanto também calcula o campo Tempo ant., ou seja, a diferença de tempo entre os dois valores (cliques) e tentando detectar uma sequência EOL e alternar para CRLF se detectar "\n\r" no valor recuperado.

Clique em Obter valor e testar para testar o pré-processamento.

Os valores recuperados de um host e os resultados dos testes são truncados para um tamanho máximo de 512KB quando enviados para o frontend. Se um resultado for truncado, um ícone de aviso será exibido. A descrição do aviso é exibida ao passar o mouse. Observe que dados maiores que 512KB ainda são processados totalmente pelo Zabbix server.

Se a configuração estiver incorreta, uma mensagem de erro será exibida descrevendo a possível causa.

Um valor recuperado com sucesso do host também pode ser usado para testar etapas de pré-processamento.

Botões do formulário

Os botões na parte inferior do formulário permitem realizar várias operações.

	Adicionar um item. Este botão está disponível apenas para novos items.
	Atualizar as propriedades de um item.
	Criar outro item com base nas propriedades do item atual.
	Executar uma verificação para obter um novo valor do item imediatamente. Suportado apenas para verificações passivas (veja mais detalhes). Observe que, ao 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.
	Testar se a configuração do item está correta obtendo um valor.
	Excluir o histórico e as tendências do item.
	Excluir o item.
	Cancelar a edição das propriedades do item.

Limites de dados de texto

Os limites de dados de texto dependem do banco de dados utilizado. Antes de armazenar valores de texto no banco de dados, eles são truncados para corresponder ao limite do tipo de valor do banco de dados:

Limite de script personalizado

O comprimento disponível do script personalizado depende do banco de dados utilizado:

Items não suportados

Itens não suportados são relatados com o status Não suportado e ainda são verificados novamente no seu Intervalo de atualização padrão.

Um item se torna não suportado se seu valor não puder ser recuperado por algum motivo (por exemplo, erro de conexão, nenhum poller configurado para processar o item). Além disso, itens que não recebem dados históricos permanecem no status Não suportado. Esse é o comportamento esperado—um item muda para o status Normal somente quando recebe novos dados históricos válidos.

Assim como problemas, itens não suportados são reavaliados apenas quando novos dados são recebidos—mesmo que não haja mais dados históricos disponíveis para esse item. Em outras palavras, itens e triggers mudam seu estado somente ao receber novos dados. No entanto, se uma expressão de trigger incluir uma função de data e hora e/ou nodata(), a trigger será recalculada a cada 30 segundos (veja tempo de cálculo das triggers para detalhes).