Configurar substituições de campo - Amazon Managed Grafana
Exemplo 1: Formatar a temperaturaExemplo 2: Formatar temperatura e umidadeAdicionar uma substituição de campoExcluir uma substituição de campoExibir substituições de campoEditar uma substituição de campo

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 substituições de campo

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte ao Grafana versão 9.x.

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 8.x do Grafana, consulte. Trabalhando na versão 8 da Grafana

As substituições permitem que você personalize as configurações de visualização para campos ou séries específicos. Isso é feito adicionando uma regra de substituição que tem como alvo um determinado conjunto de campos e que pode definir várias opções.

Por exemplo, você define a unidade para todos os campos que incluem o texto “bytes” adicionando uma substituição usando a correspondência de regex Fields with name matching e, em seguida, adiciona a opção Unit à regra de substituição.

Exemplo 1: Formatar a temperatura

Vamos supor que nosso 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 que alteram a forma como seus valores são exibidos. Isso significa que você pode, por exemplo, definir a unidade para 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

Além disso, a casa decimal não é necessária, então podemos removê-la. Você pode alterar os decimais de automático para 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

Exemplo 2: Formatar temperatura e umidade

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 adicionar 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 agora deve ser alterada. Podemos corrigir isso aplicando uma substituição de opção de campo ao campo de umidade e alterando a unidade para Misc > percent (0-100).

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%

Adicionar uma substituição de campo

Uma regra de substituição de campo pode personalizar as configurações de visualização para um campo ou série específica.

  1. Edite o painel ao qual você deseja adicionar uma substituição.

  2. No painel lateral de opções do painel, clique em Adicionar substituição de campo na parte inferior do painel.

  3. Selecione em quais campos uma regra de substituição será aplicada:

    • Campos com nome: selecione um campo na lista de todos os campos disponíveis. As propriedades adicionadas a uma regra com esse seletor são aplicadas somente a esse único campo.

    • Campos com nome correspondente ao regex: especifique os campos a serem substituídos por uma expressão regular. As propriedades adicionadas a uma regra com esse seletor são aplicadas a todos os campos em que o nome do campo corresponde ao regex.

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

    • Campos retornados pela consulta: selecione todos os campos retornados por uma consulta específica, como A, B ou C. As propriedades adicionadas a uma regra com esse seletor são aplicadas a todos os campos retornados pela consulta selecionada.

  4. Clique em Adicionar propriedade de substituição.

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

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

  7. Continue adicionando substituições a esse campo clicando em Adicionar propriedade de substituição, ou você pode clicar em Adicionar substituição e selecionar um campo diferente para adicionar substituições.

  8. Ao terminar, clique em Salvar para salvar todas as edições do painel no painel.

Excluir uma substituição de campo

Exclua uma substituição de campo quando não precisar mais dela. Quando você exclui uma substituição, a aparência do valor é padronizada para seu formato original. Essa alteração afeta os painéis e os usuários do painel que dependem de um painel afetado.

  1. Edite o painel que contém a substituição que você deseja excluir.

  2. No painel lateral de opções do painel, role para baixo até ver as substituições.

  3. Clique na substituição que você deseja excluir e, em seguida, clique no ícone de lixeira associado.

Exibir substituições de campo

Você pode visualizar as substituições de campo nas opções de exibição do painel.

  1. Edite o painel que contém as substituições que você deseja visualizar.

  2. No painel lateral de opções do painel, role para baixo até ver as substituições.

Editar uma substituição de campo

Edite uma substituição de campo quando quiser fazer alterações em uma configuração de substituição. A alteração que você fizer entrará em vigor imediatamente.

  1. Edite o painel que contém as substituições que você deseja editar.

  2. No painel lateral de opções do painel, role para baixo até ver as substituições.

  3. Localize a substituição que você deseja alterar.

  4. Execute qualquer uma das ações a seguir:

    • Edite as configurações nas substituições existentes ou nos parâmetros de seleção de campo.

    • Exclua as propriedades de substituição existentes clicando no X ao lado da propriedade.

    • Adicione propriedades de substituição clicando em Adicionar propriedade de substituição.