Table of Contents
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:
- ao preencher o inventário do host;
- ao expandir as macros suportadas {ITEM.VALUE}, {ITEM.LASTVALUE}, {EVENT.OPDATA} e {EVENT.CAUSE.OPDATA}.
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 valor, siga estas etapas:
1. Abra o formulário de configuração do host ou template.
2. Na aba Mapeamento de valor, clique em Adicionar para adicionar um novo mapeamento de valor, ou clique no nome de um mapeamento existente para editá-lo.
Parâmetros de um mapeamento de valor:
| Parâmetro | Descrição | |
|---|---|---|
| Nome | Nome exclusivo para o conjunto de mapeamentos de valor. | |
| Mapeamentos | Regras individuais para mapear valores numéricos/strings para representações em string. O mapeamento é aplicado na ordem das regras, que podem ser reordenadas por arrastar. |
|
| Tipo | 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 <número1>-<número2> ou <número>; múltiplos 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 valores numéricos (is greater than or equals, is less than or equals, in range) são suportados. |
|
| Valor | Valor de entrada (pode conter um intervalo ou expressão regular, dependendo do tipo de mapeamento). | |
| Mapeado para | 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 valor na lista, apenas os três primeiros mapeamentos são visíveis, com três pontos indicando que existem 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.
