Opções de campo e substituições - Amazon Managed Grafana
Opções de campoSubstituições de campoOpções de campo disponíveis e substituições

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á.

Opções de campo e substituições

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.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 9.x, consulte Trabalhar no Grafana versão 9.

Esta seção explica quais são as opções e substituições de campo no Amazon Managed Grafana e como usá-las.

O modelo de dados usado nos espaços de trabalho do Grafana, um quadro de dados, é uma estrutura de tabela orientada por colunas que unifica as séries temporais e os resultados da tabela da consulta. Cada coluna dentro dessa estrutura é chamada de campo. Um campo pode representar uma única série temporal ou coluna de tabela.

As opções de campo permitem que você altere a forma como os dados são exibidos nas visualizações. As opções e substituições que você aplica não alteram os dados, elas alteram a forma como o Amazon Managed Grafana exibe os dados.

Opções de campo

As opções de campo, tanto padrão quanto personalizadas, podem ser encontradas na guia Campo no editor do painéis. As alterações feitas nessa guia se aplicam a todos os campos (ou seja, séries e colunas). Por exemplo, se você alterar a unidade para porcentagem, então todos os campos com valores numéricos serão exibidos em porcentagens. Saiba como aplicar uma opção de campo em Configurar todos os campos.

Substituições de campo

As substituições de campo podem ser adicionadas na guia Substituições no editor de painéis. Nele, você pode adicionar as mesmas opções encontradas na guia Campo, mas elas são aplicadas somente a campos específicos. Saiba como aplicar uma substituição em Configurar campos específicos.

Opções de campo disponíveis e substituições

Os tipos de opção de campo são comuns às opções de campo e às substituições de campo. A única diferença é se a alteração será aplicada a todos os campos (aplicada na guia Campo) ou a um subconjunto de campos (aplicada na guia Substituições).

Configurar todos os campos

Para alterar a forma como todos os campos exibem dados, você pode alterar uma opção na guia Campo. Na guia Substituições, você pode então substituir as opções de campo para campos específicos. Para ter mais informações, consulte Configurar campos específicos.

Por exemplo, você pode alterar o número de casas decimais mostradas em todos os campos alterando a opção Decimais. Para obter mais informações sobre as opções, consulte Opções de campo padrão e Opções de campo de tabelas.

Alterar uma opção de campo

Você pode alterar quantas opções quiser.

Para alterar uma opção de campo

  1. Escolha o painel que você deseja editar, escolha o título e, em seguida, escolha Editar.

  2. Escolha a guia Campo.

  3. Encontre a opção que você deseja alterar. Você pode definir o seguinte:

  4. Adicione opções acrescentando valores nos campos. Para retornar as opções aos valores padrão, exclua o texto em branco nos campos.

  5. Ao terminar de fazer edições no dashboard, escolha Salvar.

Exemplo de opção de campo

Vamos supor que o conjunto de resultados seja um quadro de dados que consiste em dois campos: tempo e temperatura.

horário temperatura
2/1/2020 3:04:00 45.0
2/1/2020 3:05:00 47,0
2/1/2020 3:06:00 48,0

Cada campo (coluna) dessa estrutura pode ter opções de campo aplicadas de uma forma que altere o modo como seus valores são exibidos. Por exemplo, você pode definir a Unidade como Temperatura > Celsius, resultando na tabela a seguir.

horário temperatura
2/1/2020 3:04:00 45,0 °C
2/1/2020 3:05:00 47,0 °C
2/1/2020 3:06:00 48,0 °C

A casa decimal não significa nada nesse caso. Você pode alterar os decimais de auto para zero (0), resultando na tabela a seguir.

horário temperatura
2/1/2020 3:04:00 45 °C
2/1/2020 3:05:00 47 °C
2/1/2020 3:06:00 48 °C

Configurar campos específicos

Você pode usar substituições para alterar as configurações de um ou mais campos. As opções de campo para substituições são exatamente iguais às opções de campo que estão disponíveis em uma visualização específica. A única diferença é que você escolhe em quais campos aplicá-las.

Por exemplo, você pode alterar o número de casas decimais mostradas em todos os campos ou colunas numéricos alterando a opção Decimais para Campos com tipo que corresponda a Numérico. Para obter mais informações sobre as opções, consulte Opções de campo padrão, que se aplicam a todas as visualizações de painel que permitem transformações, e Opções de campo de tabelas que se aplicam somente às visualizações de painel de tabela.

Adicionar uma substituição de campo

Você pode substituir quantas opções de campo quiser.

Para adicionar uma substituição de campo

  1. Escolha o painel que você deseja editar, escolha o título e, em seguida, escolha Editar.

  2. Escolha a guia Substituições.

  3. Escolha Adicionar uma substituição para.

  4. Selecione os campos aos quais você deseja aplicar uma regra de substituição.

    • Campos com nome: use esta opção para selecionar um campo na lista de todos os campos disponíveis. As propriedades que você adiciona a uma regra com esse seletor são aplicadas somente a esse único campo.

    • Campos com regex de correspondência de nome: use para especificar os campos a serem substituídos por uma expressão regular. As propriedades que você adiciona a uma regra usando esse seletor são aplicadas a todos os campos em que os nomes dos campos correspondem ao regex.

    • Campos com tipo: use para selecionar campos por tipo, como string, numérico e assim por diante. As propriedades que você adiciona a uma regra com esse seletor são aplicadas a todos os campos que correspondem ao tipo selecionado.

  5. Escolha Adicionar propriedade de substituição.

  6. Selecione a opção de campo que você deseja aplicar.

  7. Insira as opções adicionando valores nos campos. Para retornar as opções aos valores padrão, exclua o texto em branco nos campos.

  8. Continue adicionando substituições a esse campo escolhendo Adicionar propriedade de substituição, ou você pode escolher Adicionar substituição e selecionar outro campo ao qual adicionar substituições.

  9. Quando terminar, escolha Save (Salvar).

Excluir uma substituição de campo

  1. Escolha a guia Substituições que contém a substituição que você deseja excluir.

  2. Escolha o ícone da lixeira ao lado da substituição.

Exemplo de substituição de campo

Vamos supor que nosso conjunto de resultados seja um quadro de dados que consiste em quatro campos: tempo, alta temperatura, baixa temperatura e umidade.

horário alta temperatura baixa temperatura umidade
2/1/2020 3:04:00 45.0 30.0 67
2/1/2020 3:05:00 47,0 34,0 68
2/1/2020 3:06:00 48,0 31,0 68

Vamos aplicar as opções de campo de Exemplo de opção de campo para aplicar a unidade Celsius e eliminar a casa decimal. Isso resulta na tabela a seguir.

horário alta temperatura baixa temperatura umidade
2/1/2020 3:04:00 45 °C 30 °C 67 °C
2/1/2020 3:05:00 47 °C 34 °C 68 °C
2/1/2020 3:06:00 48 °C 31 °C 68 °C

Os campos de temperatura parecem bons, mas a umidade está disparatada. Você pode corrigir essa questão aplicando uma substituição de opção de campo ao campo de umidade e alterando a unidade para Misc > por cento (0 a 100). Isso resulta em uma tabela que faz muito mais sentido.

horário alta temperatura baixa temperatura umidade
2/1/2020 3:04:00 45 °C 30 °C 67%
2/1/2020 3:05:00 47 °C 34 °C 68%
2/1/2020 3:06:00 48 °C 31 °C 68%

Opções de campo padrão

Esta seção explica as opções de campo disponíveis. Elas são listadas em ordem alfabética.

Você pode aplicar as opções de campo padrão à maioria dos painéis integrados da área de trabalho do Grafana. Alguns painéis antigos e painéis comunitários que não foram atualizados para o novo painel e modelo de dados perderão todas ou algumas dessas opções de campo.

A maioria das opções de campo não afetará a visualização até que você escolha fora da caixa de opções de campo que você está editando ou pressione Enter.

Para obter mais informações sobre como aplicar essas opções, consulte as seguintes seções:

Decimais

Esta opção define o número de decimais a serem incluídos ao renderizar um valor. Deixe em branco para que o Amazon Managed Grafana use o número de decimais fornecido pela fonte de dados.

Para alterar essa configuração, insira um número no campo.

Esta opção controla o URL ao qual um valor ou visualização está vinculado. Para mais informações e instruções, consulte Links de dados.

Nome de exibição

Esta opção define o título de exibição de todos os campos. Você pode usar variáveis no título do campo. Para obter mais informações sobre modelos e variáveis de modelos, consulte Modelos e variáveis.

Quando várias estatísticas, campos ou séries são mostrados, esse campo controla o título em cada estatística. Você pode usar expressões como ${__field.name} para usar somente o nome da série ou o nome do campo no título.

Fornecido um campo com o nome Temp e rótulos de {"Loc"="PBI", "Sensor"="3"}

Sintaxe da expressão Exemplo Renderiza para Explicação
${__field.displayName} O mesmo que a sintaxe Temp {Loc="PBI", Sensor="3"} Exibe o nome do campo e os rótulos entre {}, se estiverem presentes. Se houver apenas uma chave de rótulo na resposta, então, para a parte do rótulo, o Amazon Managed Grafana exibirá o valor do rótulo sem os colchetes.
${__field.name} O mesmo que a sintaxe Temp Exibe o nome do campo (sem rótulos).
${__field.labels} O mesmo que a sintaxe Loc="PBI", Sensor="3" Exibe os rótulos sem o nome.
${__field.labels.X} ${__field.labels.Loc} PBI Exibe o valor da chave de rótulo especificada.
${__field.labels.__values} O mesmo que a sintaxe PBI, 3 Exibe os valores dos rótulos separados por uma vírgula (sem as chaves do rótulo).

Se o valor for uma string vazia após renderizar a expressão para um campo específico, o método de exibição padrão será usado.

Máx

Esta opção define o valor máximo usado nos cálculos do limite percentual. Para o cálculo automático com base em todas as séries e campos, deixe esta configuração em branco.

Mín.

Esta opção define o valor mínimo usado nos cálculos do limite percentual. Para o cálculo automático com base em todas as séries e campos, deixe esta configuração em branco.

Nenhum valor

Insira o que o Amazon Managed Grafana deve exibir se o valor do campo estiver vazio ou nulo.

Unidade

Esta opção especifica a unidade que um campo deve usar. Escolha o campo Unidade e, em seguida, faça uma busca detalhada até encontrar a unidade desejada. A unidade selecionada será aplicada a todos os campos, exceto a hora.

Unidades personalizadas

Você também pode usar a lista suspensa de unidades para especificar unidades personalizadas, prefixo ou sufixo personalizado e formatos de data e hora.

Para selecionar uma unidade personalizada, insira a unidade e selecione a última opção Custom: xxx na lista suspensa.

  • suffix:<suffix> para uma unidade personalizada que deve ficar depois do valor.

  • time:<format> para formatos de data e hora personalizados; por exemplo, time:YYYY-MM-DD. Para obter a sintaxe e as opções de formato, consulte Exibir.

  • si:<base scale><unit characters> para unidades personalizadas do SI; por exemplo, si: mF. Esta opção é um pouco mais avançada porque você pode especificar uma unidade e a escala de dados de origem. Por exemplo, se os dados de origem forem representados como uma unidade mili (milhares de), prefixe a unidade com o caractere da escala do SI.

  • count:<unit> para uma unidade de contagem personalizada.

  • currency:<unit> para personalizar uma unidade monetária.

Você também pode colar um emoji nativo no seletor de unidades e selecioná-lo como uma unidade personalizada.

Unidades de string

Às vezes, o Amazon Managed Grafana pode analisar strings e mostrá-las como números. Para fazer com que o Amazon Managed Grafana mostre a string original, crie uma substituição de campo e adicione uma propriedade de unidade com a unidade da string.

Esquema de cores

A opção de cor do campo define como o Amazon Managed Grafana aplica cores a séries ou campos. Há vários modos aqui que funcionam de forma diferente, e sua utilidade depende muito da visualização atualmente selecionada.

Os modos de cores contínuas usam a porcentagem de um valor em relação ao mínimo e ao máximo para interpolar uma cor.

  • Cor única: cor específica definida usando o seletor de cores. Isto é mais útil em uma regra de substituição.

  • Nos limites: cor derivada do limite correspondente. Isto é útil para medidores, estatísticas e visualizações de tabelas.

Aplicar cor por série

O Amazon Managed Grafana inclui esquemas de cores que definem a cor por série. Isso é útil para grafos e diagramas de pizza, por exemplo.

Cor por valor

O Amazon Managed Grafana também inclui esquemas de cores contínuas (gradiente). Isto é útil para visualizações que aplicam cores a valores individuais, por exemplo, painéis de estatísticas e o painel de tabela.

Limites

Você pode usar limites para alterar a cor de um campo com base no valor. Para mais informações e instruções, consulte Limites.

Mapeamento de valores

Você pode usar esta opção para definir regras que traduzem um valor de campo ou um intervalo de valores em texto explícito. Você pode adicionar mais de um mapeamento de valores.

  • Tipo de mapeamento: escolha uma opção.

    • Valor: insira um valor. Se o valor do campo for maior que ou igual ao valor, o Texto será exibido.

    • De e Até: insira um intervalo. Se o valor do campo estiver entre os valores no intervalo, ou igual a eles, o Texto será exibido.

  • Texto: o texto exibido se as condições forem atendidas em um campo. Este campo aceita variáveis.