Documentation
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 uma forma mais amigável:
- 0 → Não disponível
- 1 → Disponível
Mapeamentos de valores para tipos de backup de dados podem ser configurados da seguinte forma:
- F → Completo
- D → Diferencial
- I → Incremental
Intervalos de valores para tensão podem ser configurados da seguinte forma:
- <=209 → Baixa
- 210-230 → OK
- >=231 → Alta
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 mapa de valores - 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 Mapeamento de valores, clique em Adicionar 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 | |
|---|---|---|
| Nome | Nome exclusivo para o conjunto de mapeamentos de valores. | |
| Mapeamentos | Regras individuais para mapear valores numéricos/string para representações em string. O mapeamento é aplicado na ordem das regras, que podem ser reordenadas arrastando. |
|
| 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 dentro do 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 estão marcados com um asterisco vermelho.
Ao visualizar o mapeamento de valores 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 valor
Um dos itens de agent predefinidos, Zabbix agent ping, usa um mapeamento de valor 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 esse mapeamento de valor no campo Mapeamento de valor:
Esse mapeamento é usado 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 valor for usado, essa redução não é aplicada ao valor mapeado, mas apenas ao valor bruto (exibido entre parênteses).
Sem um mapeamento de valor predefinido, você veria apenas "1", o que pode ser difícil de entender.
