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á.
Transformar dados
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte Trabalhar no Grafana versão 9.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Trabalhar no Grafana versão 8.
As transformações são uma forma eficaz de manipular dados retornados por uma consulta antes que o sistema aplique uma visualização. Ao usar transformações, você pode:
-
Renomear campos
-
Juntar dados de séries temporais
-
Executar operações matemáticas em todas as consultas
-
Usar a saída de uma transformação como a entrada para outra transformação
Para usuários que dependem de várias visualizações do mesmo conjunto de dados, as transformações oferecem um método eficiente de criar e manter vários dashboards.
Você também pode usar a saída de uma transformação como entrada para outra transformação, o que resulta em um ganho de performance.
nota
Às vezes, o sistema não consegue representar graficamente os dados transformados. Quando isso acontecer, clique no botão de alternância Visualização de tabela acima da visualização para alternar para uma visualização de tabela dos dados. Ela pode ajudar você a entender o resultado final das transformações.
Tipos de transformação
O Grafana fornece várias maneiras de transformar dados. Há uma lista completa das funções de transformação abaixo.
Ordem das transformações
Quando há várias transformações, o Grafana as aplica na ordem em que estão listadas. Cada transformação cria um conjunto de resultados que, em seguida, passa para a próxima transformação no pipeline de processamento.
A ordem na qual o Grafana aplica as transformações afeta diretamente os resultados. Por exemplo, se você usar uma transformação de redução para condensar todos os resultados de uma coluna em um único valor, só poderá aplicar transformações a esse valor único.
Adicionar uma função de transformação aos dados
As etapas a seguir orientam você a adicionar uma transformação aos dados. Esta documentação não inclui as etapas para cada tipo de transformação.
Para adicionar uma transformação a um painel
-
Navegue até o painel em que você deseja adicionar uma ou mais transformações.
-
Passe o mouse sobre qualquer parte do painel para exibir o menu de ações no canto superior direito.
-
No menu de ações, escolha Editar.
-
Selecione a guia Transformar.
-
Selecione uma transformação. Uma linha de transformação aparece onde você configura as opções de transformação.
-
Para aplicar outra transformação, escolha Adicionar transformação. Essa transformação atua no conjunto de resultados retornado pela transformação anterior.
Depurar uma transformação
Para ver os conjuntos de resultados de entrada e saída da transformação, escolha o ícone de depuração (bug) no lado direito da linha de transformação. Isso exibirá os dados de entrada e o resultado da transformação como saída.
Os conjuntos de resultados de entrada e saída podem ajudar a depurar uma transformação.
Desabilitar uma transformação
Você pode desabilitar ou ocultar uma transformação escolhendo o ícone de mostrar (olho) no canto superior direito da linha de transformação. Isso desabilita as ações aplicadas dessa transformação específica e pode ajudar a identificar problemas quando você altera várias transformações uma após a outra.
Filtrar uma transformação
Se a transformação usar mais de uma consulta, você poderá filtrá-las e aplicar a transformação selecionada a somente uma das consultas. Para isso, selecione o ícone de filtro localizado no canto superior direito da linha de transformação. Isso abre uma lista suspensa com uma lista de consultas usadas no painel. Nela, você poderá selecionar a consulta que deseja transformar.
Você também pode filtrar por anotações (o que inclui exemplares) para aplicar transformações nelas. Ao fazer isso, a lista de campos muda para refleti-las na anotação ou na dica de ferramenta do exemplar.
O ícone do filtro sempre será exibido se o painel tiver mais de uma consulta ou fonte de dados (ou seja, dados de painel ou anotação), mas poderá não funcionar se as transformações anteriores para mesclar as saídas das consultas forem aplicadas. Isso ocorre porque uma transformação obtém a saída da anterior.
Excluir uma transformação
Recomendamos que você remova transformações que não sejam necessárias. Ao excluir uma transformação, você remove os dados da visualização.
Pré-requisitos:
Identifique todos os dashboards que dependem da transformação e informe seus usuários afetados.
Para excluir uma transformação
-
Abra um painel para edição.
-
Selecione a guia Transformar.
-
Selecione o ícone de lixeira ao lado da transformação que você deseja excluir.
