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 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 valores previamente configurado no parâmetro Mapeamento de valores.
Não há herança de mapeamento de valores - hosts e templates não herdam mapeamentos de valores de templates vinculados. 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: igual - valores iguais serão mapeados; maior ou igual - valores iguais ou maiores serão mapeados; menor ou igual - valores iguais ou menores serão mapeados; em intervalo - 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); padrão - todos os valores restantes serão mapeados, exceto aqueles com mapeamentos específicos. Para mapeamento de intervalos, apenas tipos de valores numéricos (maior ou igual, menor ou igual, em intervalo) 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 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 valores
Um dos itens de agent predefinidos, Zabbix agent ping, usa 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 esse mapeamento de valores no campo Mapeamento de valores:
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 encurtados para 20 símbolos. Se o mapeamento de valores for usado, esse encurtamento não é aplicado 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.
