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

8 Mapeamento de valores

Visão geral

Para uma representação mais "humana" dos valores recebidos, você pode usar value mapas que contêm o mapeamento entre valores numéricos/string e string representações.

Mapeamentos de valor podem ser usados tanto no frontend do Zabbix quanto nas notificações enviados por tipos de mídia.

Por exemplo, um item que tem valor '0' ou '1' pode usar mapeamento de valor para representam os valores em uma forma legível por humanos:

  • '0' => 'Não disponível'
  • '1' => 'Disponível'

Ou, um mapa de valor relacionado ao backup pode ser:

  • 'F' => 'Cheio'
  • 'D' => 'Diferencial'
  • 'Eu' => 'Incremental'

Em outro exemplo, as faixas de valores para tensão podem ser mapeadas:

  • '<=209' => 'Baixo'
  • '210-230' => 'OK'
  • '>=231' => 'Alto'

Os mapeamentos de valor são definidos no modelo ou no nível do host. Uma vez definidos eles tornam-se disponíveis para todos os itens do respectivo modelo ou host. Lá não há herança de mapa de valor - um item de modelo em um host ainda usa o mapa de valor do modelo; vincular um modelo com mapas de valor ao host não faz com que o host herde os mapas de valores.

Ao configurar itens você pode usar um mapa de valores para "humanizar" o forma como um valor de item será exibido. Para fazer isso, você se refere ao nome de um mapa de valores previamente definido no campo Mapeamento de valores.

O mapeamento de valores pode ser usado com itens com Numeric (sem sinal), Numérico (float) e Caractere tipo de em formação.

Os mapeamentos de valor podem ser exportados/importados com o respectivo modelo ou hospedeiro.

Os mapeamentos de valor podem ser atualizados em massa. Ambos host e template os formulários de atualização em massa têm um Guia Mapeamento de valores para mapas de valores de atualização em massa.

Configuração

Para definir um mapa de valores:

  • Abra um formulário de configuração de host ou modelo
  • Vá para a guia Mapeamento de valores
  • Clique em Adicionar para adicionar um novo mapa
  • Clique no nome de um mapa existente para editá-lo

Parâmetros de um mapa de valores:

Parâmetro Descrição
Nome Nome exclusivo de um conjunto de mapeamentos de valor.
Mapeamentos Regras de mapeamento individual para mapear valores numéricos/string para representações de string.
O mapeamento é aplicado de acordo com a ordem das regras de mapeamento. É possível reordenar mapeamentos arrastando.
Somente tipos de valores numéricos são suportados para mapeamentos de intervalos (é maior ou igual a, é menor ou igual a, no intervalo tipos de mapeamento).
Tipo Tipo de mapeamento:
igual - valores iguais serão mapeados
é maior ou igual a - valores iguais ou maiores serão mapeados
é menor ou igual - valores iguais ou menores serão mapeados
no intervalo - valores no intervalo serão mapeados; o intervalo é expresso como <number1>-<number2> ou <number>. Vários intervalos são compatíveis (por exemplo, 1-10.101-110.201)
regexp - valores correspondentes à expressão regular serão mapeados (expressões regulares globais não são compatíveis)
* *padrão** - todos os valores pendentes serão mapeados, exceto aqueles com mapeamentos específicos
Value Valor de entrada.
Dependendo do tipo de mapeamento, também pode conter um intervalo ou expressão regular.
Mapeado para Representação de string para o valor de entrada.

Todos os campos de entrada obrigatórios estão marcados com um asterisco vermelho.

Quando o mapa de valores é exibido na lista, apenas os três primeiros mapeamentos dele são visíveis, enquanto três pontos indicam que mais mapeamentos existir.

Como isso funciona

Por exemplo, um dos itens de agente predefinidos 'ping do agente Zabbix' usa um mapa de valores no nível do modelo chamado 'status de ping do agente Zabbix' para exibir seus valores.

No item formulário de configuração você pode ver uma referência a este mapa de valores no campo Mapeamento de valores:

Portanto, em Monitoring → Últimos dados, o mapeamento é usado para exibir 'Up' (com o valor bruto entre parênteses).

Na seção Latest data, os valores exibidos são reduzidos para 20 símbolos. Se o mapeamento de valor for usado, esse encurtamento não será aplicado ao valor mapeado, mas apenas para o valor bruto separadamente (exibido em parênteses).

Um valor sendo exibido em um formato legível também é mais fácil de entender ao receber notificações.

Sem um mapa de valores predefinido, você só obteria isso:

Então, neste caso, você teria que adivinhar o que o '1' significa ou faça uma pesquisa de documentação para descobrir.