Configurar substituições de campo

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte à versão 10.x 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

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 expressões regulares Campos com correspondência de nome correspondente e, em seguida, adiciona a opção Unidade à 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: time temperature e.

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: time high templow temp,, humidity e.

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.

Para adicionar uma substituição de campo

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

2. No painel lateral de opções do painel, escolha 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 a 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. Isso seleciona os campos a serem substituídos, mas não os renomeia; para fazer isso, use a transformação Renomear por 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. Escolha 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 escolhendo Adicionar propriedade de substituição, ou você pode escolher Adicionar substituição e selecionar um campo diferente para adicionar substituições.

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

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

Para excluir um campo, substitua

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. Escolha a substituição que você deseja excluir e, em seguida, escolha o ícone de lixeira associado.

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

nota

As configurações de substituição que aparecem na guia Tudo são as mesmas que aparecem na guia Substituições.

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

Para editar um campo, substitua

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 escolhendo o X ao lado da propriedade.

   • Adicione propriedades de substituição escolhendo Adicionar propriedade de substituição.