8 Mapeamento de valores

Visão geral

O mapeamento de valores permite configurar uma representação mais amigável dos valores recebidos, usando mapeamentos entre valores numéricos/strings e representações em string.

Por exemplo, quando o valor de um item é "0" ou "1", os mapeamentos de valores podem ser usados para representar esses valores de forma mais amigável:

  • 0 → Não disponível
  • 1 → Disponível

Os mapeamentos de valores para tipos de backup de dados podem ser configurados da seguinte forma:

  • F → Completo
  • D → Diferencial
  • I → Incremental

Os intervalos de valores para tensão podem ser configurados da seguinte forma:

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

O mapeamento de valores é usado no frontend do Zabbix e nas notificações enviadas pelos tipos de mídia.

A substituição do valor recebido pela representação configurada é realizada tanto no frontend do Zabbix quanto no server; no entanto, o server realiza a substituição apenas nos seguintes casos:

Os mapeamentos de valores são configurados em templates ou hosts. Uma vez configurados, eles ficam disponíveis para todos os items dentro do respectivo template ou host. Ao configurar items, especifique o nome de um mapeamento de valor previamente configurado no parâmetro Mapeamento de valor.

Não há herança de mapeamento de valor - hosts e templates não herdam mapeamentos de valores de templates vinculados. Os items de template em um host continuarão a usar os mapeamentos de valores configurados no template.

Os mapeamentos de valores podem ser usados com items que possuem os tipos de informação Numérico (sem sinal), Numérico (float) e Caracter.

Os mapeamentos de valores são exportados/importados com o respectivo template ou host. Eles também podem ser atualizados em massa usando os formulários de atualização em massa de host e template.

Configuração

Para configurar um mapeamento de valores, siga estas etapas:

1. Abra o formulário de configuração do host ou template.

2. Na aba Value mapping, clique em Add para adicionar um novo mapeamento de valores ou clique no nome de um mapeamento existente para editá-lo.

Parâmetros de um mapeamento de valores:

Parâmetro Descrição
Name Nome exclusivo para o conjunto de mapeamentos de valores.
Mappings Regras individuais para mapear valores numéricos/de string para representações em string.

O mapeamento é aplicado na ordem das regras, que podem ser reordenadas arrastando.
Type Tipo de mapeamento:
equals - valores iguais serão mapeados;
is greater than or equals - valores iguais ou maiores serão mapeados;
is less than or equals - valores iguais ou menores serão mapeados;
in range - valores no intervalo serão mapeados; o intervalo é expresso como <number1>-<number2> ou <number>; vários intervalos são suportados (por exemplo, 1-10,101-110,201);
regexp - valores correspondentes à expressão regular serão mapeados (expressões regulares globais não são suportadas);
default - todos os valores restantes serão mapeados, exceto aqueles com mapeamentos específicos.

Para mapeamento de intervalos, apenas tipos de valor numérico (is greater than or equals, is less than or equals, in range) são suportados.
Value Valor de entrada (pode conter um intervalo ou expressão regular, dependendo do tipo de mapeamento).
Mapped to Representação em string (até 64 caracteres) para o valor de entrada.

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

Ao visualizar o mapeamento de valores na lista, apenas os três primeiros mapeamentos ficam visíveis, com reticências indicando que há mais mapeamentos.

Exemplo de mapeamento de valores

Um dos itens de agent predefinidos, Zabbix agent ping, utiliza um mapeamento de valores em nível de template "Zabbix agent ping status" para exibir seus valores.

No formulário de configuração do item, você pode encontrar uma referência a este mapeamento de valores no campo Mapeamento de valores:

Este mapeamento é utilizado na seção Monitoramento → Últimos dados para exibir "Up" (com o valor bruto entre parênteses).

Na seção Últimos dados, os valores exibidos são reduzidos para 20 símbolos. Se o mapeamento de valores for utilizado, essa redução não é aplicada ao valor mapeado, mas apenas ao valor bruto (exibido entre parênteses).

Sem um mapeamento de valores predefinido, você veria apenas "1", o que pode ser difícil de entender.