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 que oferecem suporte à versão 8.x do Grafana.

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

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

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 da Grafana, o quadro de dados, é uma estrutura de tabela orientada por colunas que unifica as séries temporais e os resultados das consultas de tabelas. 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 em suas 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 painel. 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, todos os campos com valores numéricos serão exibidos em porcentagens. Saiba como aplicar uma opção de campo emConfigurar todos os campos.

Substituições de campo

As substituições de campo podem ser adicionadas na guia Substituições no editor do painel. Lá, 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 emConfigurar 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 Opções de campo da tabela e.

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 do painel 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 adicionando valores nos campos. Para retornar as opções aos valores padrão, exclua o texto em branco nos campos.

  5. Quando terminar de fazer edições no painel, 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
2020-01-02 03:04:00 45.0
2020-01-02 03:05:00 47,0
2020-01-02 03:06:00 48,0

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

horário temperatura
2020-01-02 03:04:00 45,0 °C
2020-01-02 03:05:00 47,0 °C
2020-01-02 03:06:00 48,0 °C

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

horário temperatura
2020-01-02 03:04:00 45 °C
2020-01-02 03:05:00 47 °C
2020-01-02 03: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 disponíveis em uma visualização específica. A única diferença é que você escolhe em quais campos aplicá-los.

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, consulteOpções de campo padrão, que se aplicam a todas as visualizações de painel que permitem transformações e Opções de campo da tabela 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 do painel 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 essa 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 nome correspondente a regex — Use isso para especificar 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 isso 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 um campo diferente para 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
2020-01-02 03:04:00 45.0 30.0 67
2020-01-02 03:05:00 47,0 34,0 68
2020-01-02 03:06:00 48,0 31,0 68

Vamos aplicar as opções de campo do 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
2020-01-02 03:04:00 45 °C 30 °C 67 °C
2020-01-02 03:05:00 47 °C 34 °C 68 °C
2020-01-02 03:06:00 48 °C 31 °C 68 °C

Os campos de temperatura parecem bons, mas a umidade não faz sentido. Você pode corrigir isso aplicando uma substituição de opção de campo ao campo de umidade e alterando a unidade para Misc > percent (0-100). Isso resulta em uma tabela que faz muito mais sentido.

horário alta temperatura baixa temperatura umidade
2020-01-02 03:04:00 45 °C 30 °C 67%
2020-01-02 03:05:00 47 °C 34 °C 68%
2020-01-02 03:06:00 48 °C 31 °C 68%

Opções de campo padrão

Esta seção explica as opções de campo disponíveis. Eles estão listados em ordem alfabética.

Você pode aplicar 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 seções a seguir:

Números decimais

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

Essa 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

Essa 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 modelo, consulteModelos 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} 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, {} se estiverem presentes. Se houver apenas uma chave de etiqueta na resposta, então, para a parte da etiqueta, o Amazon Managed Grafana exibirá o valor da etiqueta 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 etiqueta especificada.
${__field.labels.__values} O mesmo que a sintaxe PBI, 3 Exibe os valores dos rótulos separados por uma vírgula (sem as teclas 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

Essa 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 essa configuração em branco.

Mín.

Essa 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 essa configuração em branco.

Sem valor

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

Unidade

Essa 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 é 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/hora.

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

  • suffix:<suffix>para uma unidade personalizada que deve ir atrás do valor.

  • time:<format>para formatos de data/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 SI personalizadas; por exemplo,si: mF. Essa opção é um pouco mais avançada porque você pode especificar uma unidade e a escala de dados de origem. Por exemplo, se seus dados de origem forem representados como mili (milhares de) unidades, prefixe a unidade com esse caractere de escala 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 sequências de caracteres 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 à unidade. string

Esquema de cores

A opção de cor do campo define como o Amazon Managed Grafana colore 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. Isso é mais útil a partir de uma regra de substituição.

  • Dos limites — Cor derivada do limite correspondente. Isso é útil para medidores, estatísticas e visualizações de tabelas.

Cor por série

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

Cor por valor

O Amazon Managed Grafana também inclui esquemas de cores contínuos (gradientes). Isso é útil para visualizações que colorem 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 essa opção para definir regras que traduzem um valor de campo ou 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 ou igual ao valor, o Texto será exibido.

    • De e Para — Insira um intervalo. Se o valor do campo estiver entre ou igual aos valores no intervalo, o Texto será exibido.

  • Texto — Texto exibido se as condições forem atendidas em um campo. Esse campo aceita variáveis.