Esta é uma tradução da página de documentação original em inglês. Ajude-nos a torná-la melhor.

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

1 Criando um item

Visão geral

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

  • · Vá para: ConfiguraçãoHosts
  • · 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.

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.
Chave Chave to item (até 2048 caracteres).
As item keys 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 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).
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.
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óriaJEDEC é 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.
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 são suportados, ex.: 30s, 1m, 2h, 1d.
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.
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.
Time suffixes são suportados no campo Intervalo, ex.: 30s, 1m, 2h, 1d.
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 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 são suportados, ex.: 2h, 1d. User macros são suportadas.
O valor do Período de armazenamento pode ser sobreescrito globalmente em Administração → Geral → 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.
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 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 são suportados, ex.: 24h, 1d. User macros são suportados.
O valor do Período de armazenamento pode ser sobreescrito globalmente em Administração → Geral → 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.
Mapeamento de valores Aplica mapeamento de valores para o item. Value 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 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.

Campos de tipos de itens específicos estão descritos em corresponding pages.

Quando estiver editando um item de template 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 de itens.

Pré-processamento do valor do item

A aba Pré-processamento permite definir transformation rules para os valores recebidos.

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.

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.

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

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

Conversão de unidade

Por padrão, especificar uma unidade para um item resulta em um prefixo multiplicador sendo adicionado - por exemplo, um valor de entrada '2048' com unidade 'B' ser exibido como '2 KB'.

Para evitar a conversão de uma unidade, use o prefixo !, por exemplo, !B. Para entender melhor como funciona a conversão com e sem o ponto de exclamação, veja os seguintes exemplos de valores e unidades:

1024 !B → 1024 B
       1024 B → 1 KB
       61 !s → 61 s
       61 s → 1m 1s
       0 !uptime → 0 uptime
       0 uptime → 00:00:00
       0 !! → 0 !
       0 ! → 0

Antes do Zabbix 4.0, havia uma lista de parada de unidade codificada consistindo de ms, rpm, RPM, %. Esta lista de parada foi obsoleto, portanto, a maneira correta de evitar a conversão de tais unidades é !ms, !rpm, !RPM, !%.

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

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 padrão.

Itens não suportados são reportados como tendo um estado NÃO SUPORTADO.