As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configurar mapeamentos de valores
<a name="v10-panels-configure-value-mappings"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

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

Os mapeamentos de valores ignoram a formatação da unidade definida nas [Opções padrão](v10-panels-configure-standard-options.md) do editor de painéis, como cor ou número de casas decimais exibidas. Quando os mapeamentos de valores estão presentes em um painel, o Grafana exibe um resumo deles na seção **Mapeamentos de valores** do editor do painel.

**Visualizações compatíveis**
+ Gráfico de barras
+ Medidor em barras
+ Candlestick
+ Canvas
+ Medidor
+ Mapa geográfico
+ Histograma
+ Gráfico de pizza
+ Stat
+ Linha do tempo dos estados
+ Histórico de status
+ Tabela
+ Séries temporais
+ Tendência

## Tipos de mapeamentos de valores
<a name="v10-panels-value-mappings-types"></a>

O Grafana é compatível com os seguintes tipos de mapeamento de valores:
+ **Valor**: mapeia valores específicos para um texto e uma cor. Por exemplo, você pode configurar um mapeamento de valores para que todas as instâncias do valor `10` apareçam como `Perfection!` em vez do número. Use um mapeamento de **valores** quando quiser formatar um único valor.
+ **Intervalo**: mapeia intervalos numéricos para texto e cor. Por exemplo, se um valor estiver dentro de um determinado intervalo, você poderá configurar um mapeamento de valores do intervalo para exibir `Low` ou `High` em vez do número. Use o mapeamento de **intervalos** quando quiser formatar vários valores contínuos.
+ **Regex**: mapeia expressões regulares para texto e cor. Por exemplo, se um valor for `www.example.com`, você pode configurar um mapeamento de valores regex para que o Grafana exiba `www` e trunque o domínio. Use o mapeamento de **regex** quando quiser formatar o texto e a cor de um valor de expressão regular.
+ **Especial**: mapeia valores especiais como `Null`, `NaN` (não um número) e valores booleanos como `true` e `false` para um texto e cor. Por exemplo, você pode configurar um mapeamento de valores especiais para que os valores `null` apareçam como `N/A`. Use o mapeamento **especial** quando quiser formatar valores incomuns, booleanos ou vazios.

## Adicionar um mapeamento de valores
<a name="v10-panels-value-mappings-add"></a>

Você pode adicionar mapeamentos de valor aos seus painéis.

**Para adicionar um mapeamento de valores**

1. Navegue até o painel que você deseja atualizar.

1. Passe o mouse sobre qualquer parte do painel para exibir um menu no canto superior direito do painel.

1. No menu, escolha **Editar**.

1. Na seção **Mapeamentos de valores**, escolha **Adicionar mapeamentos de valores**.

1. Escolha **Adicionar um novo mapeamento** e, em seguida, selecione uma das seguintes opções:
   + **Valor**: insira um único valor a ser correspondido.
   + **Intervalo**: insira os valores inicial e final de um intervalo a serem correspondidos.
   + **Regex**: insira um padrão de expressão regular a ser correspondido.
   + **Especial**: escolha um valor especial a ser correspondido.

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

1. (Opcional) Defina a cor.

1. Escolha **Atualizar** para salvar o mapeamento de valores.

Depois de adicionar um mapeamento, o botão **Editar mapeamentos de valores** substitui o botão **Adicionar mapeamentos de valores**. Escolha o botão de edição para adicionar ou atualizar mapeamentos.