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á.
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 compatíveis com o Grafana versão 10.x, consulte Trabalhar no Grafana versão 10.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Trabalhar no Grafana versão 8.
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
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 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
Mapeie um valor quando quiser formatar um único valor.
-
Abra um painel para o qual você deseja mapear um valor.
-
Nas opções de exibição do painel, localize a seção Mapeamentos de valores e clique em Adicionar mapeamentos de valores.
-
Clique em Adicionar um novo mapeamento e selecione Valor.
-
Insira o valor correspondente para o Grafana.
-
(Opcional) Insira o texto de exibição.
-
(Opcional) Defina a cor.
-
Clique em Atualizar para salvar o mapeamento de valores.
Mapear um intervalo
Mapeie um intervalo de valores quando quiser formatar vários valores contínuos.
-
Edite o painel para o qual você deseja mapear um intervalo de valores.
-
Nas opções de exibição do painel, na seção Mapeamentos de valores, clique em Adicionar mapeamentos de valores.
-
Clique em Adicionar um novo mapeamento e selecione Intervalo.
-
Insira os valores inicial e final no intervalo para que o Grafana corresponda.
-
(Opcional) Insira o texto de exibição.
-
(Opcional) Defina a cor.
-
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.
-
Edite o painel para o qual você deseja mapear uma expressão regular.
-
Na seção Mapeamentos de valores das opções de exibição do painel, clique em Adicionar mapeamentos de valores.
-
Clique em Adicionar um novo mapeamento e selecione Regex.
-
Insira o padrão de expressão regular para que o Grafana corresponda.
-
(Opcional) Insira o texto de exibição.
-
(Opcional) Defina a cor.
-
Clique em Atualizar para salvar o mapeamento de valores.
Mapear um valor especial
Mapeie um valor especial quando quiser formatar valores incomuns, booleanos ou vazios.
-
Edite o painel para o qual você deseja mapear um valor especial.
-
Nas opções de exibição do painel, localize a seção Mapeamentos de valores e clique em Adicionar mapeamentos de valores.
-
Clique em Adicionar um novo mapeamento e selecione Especial.
-
Selecione o valor especial para o Grafana corresponder.
-
(Opcional) Insira o texto de exibição.
-
(Opcional) Defina a cor.
-
Clique em Atualizar para salvar o mapeamento de valores.
Editar um mapeamento de valores
Você pode alterar um mapeamento de valores a qualquer momento.
-
Edite o painel que contém o mapeamento de valores que você deseja editar.
-
Nas opções de exibição do painel, na seção Mapeamentos de valores, clique em Editar mapeamentos de valores.
-
Faça as alterações e clique em Atualizar.
