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á.
Transforme dados
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 transformações são uma forma poderosa de manipular dados retornados por uma consulta antes que o sistema aplique uma visualização. Usando transformações, você pode:
-
Renomear campos
-
Junte dados de séries temporais
-
Execute operações matemáticas em todas as consultas
-
Use a saída de uma transformação como 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 painéis.
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 desempenho.
nota
Às vezes, o sistema não consegue representar graficamente os dados transformados. Quando isso acontecer, clique no botão Exibição em tabela acima da visualização para alternar para uma exibição em tabela dos dados. Isso pode ajudar você a entender o resultado final de suas transformações.
Tipos de transformação
A 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, a 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 a Grafana aplica as transformações afeta diretamente os resultados. Por exemplo, se você usar uma transformação Reduce 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. Essa documentação não inclui 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 ajudá-lo a depurar uma transformação.
Desativar uma transformação
Você pode desativar ou ocultar uma transformação escolhendo o ícone mostrar (olho) no canto superior direito da linha de transformação. Isso desativa 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 sua transformação usar mais de uma consulta, você poderá filtrá-las e aplicar a transformação selecionada a somente uma das consultas. Para fazer isso, escolha o ícone de filtro no canto superior direito da linha de transformação. Isso abre uma lista suspensa com uma lista de consultas usadas no painel. A partir daqui, você pode selecionar a consulta que deseja transformar.
Você também pode filtrar por anotações (o que inclui exemplares) para aplicar transformações a elas. Quando você faz isso, a lista de campos muda para refletir aqueles 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 pode 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 as transformações desnecessárias. Ao excluir uma transformação, você remove os dados da visualização.
Pré-requisitos:
Identifique todos os painéis que dependem da transformação e informe os usuários afetados.
Para excluir uma transformação
-
Abra um painel para edição.
-
Selecione a guia Transformar.
-
Escolha o ícone da lixeira ao lado da transformação que você deseja excluir.