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="v9-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 9.x**.  
Para espaços de trabalho do Grafana que suportam a versão 12.x do Grafana, consulte. [Trabalhando na versão 12 do Grafana](using-grafana-v12.md)  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.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 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. 

**nota**  
 Os novos mapeamentos de valores não são compatíveis com algumas visualizações, como Grafo (antigo), Texto e Mapa de calor. 

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

 O Grafana é compatível com 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 de 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 valores regex para que o Grafana exiba **www** e trunque o domínio. 
+  **Especial:** mapeia valores especiais como **Nulo**, **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 os valores **nulos** apareçam como **N/A**. 

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

## Mapear um valor
<a name="v9-panels-value-mappings-map-a-value"></a>

 Mapeie um valor quando quiser formatar um único valor. 

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

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

1.  Clique em **Adicionar um novo mapeamento** e selecione **Valor**. 

1.  Insira o valor correspondente para o Grafana. 

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

1.  (Opcional) Defina a cor. 

1.  Clique em **Atualizar** para salvar o mapeamento de valores. 

## Mapear um intervalo
<a name="v9-panels-value-mappings-map-a-range"></a>

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

1.  Edite o painel para o qual você deseja mapear um intervalo de valores. 

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

1.  Clique em **Adicionar um novo mapeamento** e selecione **Intervalo**. 

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

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

1.  (Opcional) Defina a cor. 

1.  Clique em **Atualizar** para salvar o mapeamento de valores. 

## Mapear uma expressão regular
<a name="v9-panels-value-mappings-map-a-regex"></a>

 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. 

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

1.  Clique em **Adicionar um novo mapeamento** e selecione **Regex**. 

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

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

1.  (Opcional) Defina a cor. 

1.  Clique em **Atualizar** para salvar o mapeamento de valores. 

## Mapear um valor especial
<a name="v9-panels-value-mappings-map-a-special-value"></a>

 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. 

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

1.  Clique em **Adicionar um novo mapeamento** e selecione **Especial**. 

1.  Selecione o valor especial para o Grafana corresponder. 

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

1.  (Opcional) Defina a cor. 

1.  Clique em **Atualizar** para salvar o mapeamento de valores. 

## Editar um mapeamento de valores
<a name="v9-panels-value-mappings-edit-a-value"></a>

 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. 

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

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