Configurar mapeamentos de valores

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte ao Grafana versão 9.x.

Para espaços de trabalho do Grafana que suportam a versão 8.x do Grafana, consulte. Trabalhando na versão 8 da Grafana

Além das substituições de campo, o mapeamento de valores é uma técnica que você pode usar para alterar o tratamento visual dos dados que aparecem em uma visualização.

Valores mapeados por meio de mapeamentos de valores ignoram a formatação da unidade. Isso significa que um valor de texto mapeado para um valor numérico não é formatado usando a unidade configurada.

Se os mapeamentos de valores estiverem presentes em um painel, o Grafana exibirá um resumo no painel lateral do editor de painéis.

Tipos de mapeamentos de valores

Grafana suporta os seguintes mapeamentos de valores:

• Valor: mapeia valores de texto para uma cor ou texto de exibição diferente. Por exemplo, você pode configurar um mapeamento de valores para que todas as instâncias do valor 10 apareçam como Perfeição! em vez do número.

• Intervalo: mapeia intervalos numéricos para exibir texto e cor. Por exemplo, se um valor estiver dentro de um determinado intervalo, você poderá configurar um mapeamento de valores de intervalo para exibir Baixo ou Alto em vez do número.

• Regex: mapeia expressões regulares para substituir texto e uma cor. Por exemplo, se um valor for www.example.com, você pode configurar um mapeamento de valor regex para que o Grafana exiba www e trunque o domínio.

• Special Mapeia valores especiais como Null, NaN (não é um número) e valores booleanos como true e false para exibir texto e cor. Por exemplo, você pode configurar um mapeamento de valor especial para que valores nulos apareçam como N/A.

Você também pode usar os pontos à esquerda para arrastar e reordenar os mapeamentos de valores na lista.

Mapear um valor

Mapeie um valor quando quiser formatar um único valor.

1. Abra um painel para o qual você deseja mapear um valor.

2. Nas opções de exibição do painel, localize a seção Mapeamentos de valor e clique em Adicionar mapeamentos de valor.

3. Clique em Adicionar um novo mapeamento e selecione Valor.

4. Insira o valor correspondente para Grafana.

5. (Opcional) Insira o texto de exibição.

6. (Opcional) Defina a cor.

7. Clique em Atualizar para salvar o mapeamento de valores.

Mapeie um intervalo

Mapeie um intervalo de valores quando quiser formatar vários valores contínuos.

1. Edite o painel para o qual você deseja mapear uma faixa de valores.

2. Nas opções de exibição do painel, na seção Mapeamentos de valor, clique em Adicionar mapeamentos de valor.

3. Clique em Adicionar um novo mapeamento e selecione Intervalo.

4. Insira os valores inicial e final no intervalo para que Grafana corresponda.

5. (Opcional) Insira o texto de exibição.

6. (Opcional) Defina a cor.

7. Clique em Atualizar para salvar o mapeamento de valores.

Mapear uma expressão regular

Mapeie uma expressão regular quando quiser formatar o texto e a cor de um valor de expressão regular.

1. Edite o painel para o qual você deseja mapear uma expressão regular.

2. Na seção Mapeamentos de valor das opções de exibição do painel, clique em Adicionar mapeamentos de valor.

3. Clique em Adicionar um novo mapeamento e selecione Regex.

4. Insira o padrão de expressão regular para que Grafana corresponda.

5. (Opcional) Insira o texto de exibição.

6. (Opcional) Defina a cor.

7. Clique em Atualizar para salvar o mapeamento de valores.

Mapeie um valor especial

Mapeie um valor especial quando quiser formatar valores incomuns, booleanos ou vazios.

1. Edite o painel para o qual você deseja mapear um valor especial.

2. Nas opções de exibição do painel, localize a seção Mapeamentos de valor e clique em Adicionar mapeamentos de valor.

3. Clique em Adicionar um novo mapeamento e selecione Especial.

4. Selecione o valor especial para Grafana corresponder.

5. (Opcional) Insira o texto de exibição.

6. (Opcional) Defina a cor.

7. Clique em Atualizar para salvar o mapeamento de valores.

Editar um mapeamento de valores

Você pode alterar um mapeamento de valores a qualquer momento.

1. Edite o painel que contém o mapeamento de valores que você deseja editar.

2. Nas opções de exibição do painel, na seção Mapeamentos de valor, clique em Editar mapeamentos de valor.

3. Faça as alterações e clique em Atualizar.