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

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:

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.

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.

Depurar uma transformação

Para ver os conjuntos de resultados de entrada e saída da transformação, escolha o ícone de bug no lado direito da linha de transformação.

Os conjuntos de resultados de entrada e saída podem ajudá-lo a depurar uma transformação.

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.

Funções de transformação

Você pode realizar as seguintes transformações em seus dados.

Adicionar campo do cálculo

Use essa transformação para adicionar um novo campo calculado a partir de dois outros campos. Cada transformação permite que você adicione um novo campo.

Concatenar campos

Essa transformação combina todos os campos de todos os quadros em um único resultado. Considere essas duas perguntas.

Consulta A:

Consulta B:

Depois de concatenar os campos, o quadro de dados seria:

Config a partir dos resultados da consulta

Essa transformação permite selecionar uma consulta e dela extrair opções padrão, como Mínimo, Máximo, Unidade e Limites, e aplicá-la a outros resultados da consulta. Isso permite a configuração dinâmica da visualização orientada por consultas.

Se você quiser extrair uma configuração exclusiva para cada linha no resultado da consulta de configuração, tente a transformação de linhas em campos.

Opções

Converter tipo de campo

Essa transformação altera o tipo de campo do campo especificado.

Por exemplo, a consulta a seguir pode ser modificada selecionando o campo de hora, como Hora, e o Formato de Data, como AAAA.

O resultado:

Filtrar dados por nome

Use essa transformação para remover partes dos resultados da consulta.

Grafana exibe o campo Identificador, seguido pelos campos retornados pela sua consulta.

Você pode aplicar filtros de duas maneiras:

Filtrar dados por consulta

Use essa transformação em painéis que tenham várias consultas, se você quiser ocultar uma ou mais das consultas.

Grafana exibe as letras de identificação da consulta em texto cinza escuro. Clique em um identificador de consulta para alternar a filtragem. Se a letra da consulta for branca, os resultados serão exibidos. Se a letra da consulta estiver escura, os resultados serão ocultados.

Filtrar dados por valor

Essa transformação permite filtrar seus dados diretamente no Grafana e remover alguns pontos de dados do resultado da consulta. Você tem a opção de incluir ou excluir dados que correspondam a uma ou mais condições definidas por você. As condições são aplicadas em um campo selecionado.

Essa transformação é útil se sua fonte de dados não for filtrada nativamente por valores. Você também pode usar isso para restringir os valores a serem exibidos se estiver usando uma consulta compartilhada.

As condições disponíveis para todos os campos são:

As condições disponíveis para campos numéricos são:

Considere o seguinte conjunto de dados:

Se você incluir os pontos de dados que têm uma temperatura abaixo de 30°C, a configuração terá a seguinte aparência:

E você obterá o seguinte resultado, onde somente as temperaturas abaixo de 30°C estão incluídas:

Você pode adicionar mais de uma condição ao filtro. Por exemplo, talvez você queira incluir os dados somente se a altitude for maior que 100. Para fazer isso, adicione essa condição à seguinte configuração:

Quando você tem mais de uma condição, pode escolher se deseja que a ação (incluir/excluir) seja aplicada em linhas que correspondam a todas as condições ou correspondam a qualquer uma das condições adicionadas.

No exemplo acima, escolhemos Match all porque queríamos incluir as linhas que têm uma temperatura inferior a 30 E uma altitude superior a 100. Se quiséssemos incluir as linhas que têm uma temperatura inferior a 30 OU uma altitude superior a 100, selecionaríamos Match any. Isso incluiria a primeira linha nos dados originais, que tem uma temperatura de 32°C (não corresponde à primeira condição), mas uma altitude de 101 (que corresponde à segunda condição), portanto, está incluída.

As condições inválidas ou configuradas de forma incompleta são ignoradas.

Group by (Agrupar por)

Essa transformação agrupa os dados por um valor de campo (coluna) especificado e processa os cálculos em cada grupo. Clique para ver uma lista das opções de cálculo.

Aqui está um exemplo de dados originais.

Essa transformação ocorre em duas etapas. Primeiro, você especifica um ou vários campos pelos quais agrupar os dados. Isso agrupará todos os mesmos valores desses campos, como se você os tivesse classificado. Por exemplo, se agruparmos pelo campo ID do servidor, os dados serão agrupados desta forma:

Todas as linhas com o mesmo valor de ID do servidor são agrupadas.

Depois de escolher o campo pelo qual deseja agrupar seus dados, você pode adicionar vários cálculos nos outros campos e aplicar o cálculo a cada grupo de linhas. Por exemplo, podemos querer calcular a temperatura média da CPU para cada um desses servidores. Assim, podemos adicionar o cálculo médio aplicado no campo Temperatura da CPU para obter o seguinte:

E podemos adicionar mais de um cálculo. Por exemplo:

Em seguida, obteríamos:

Essa transformação permite que você extraia informações importantes de sua série temporal e as exiba de forma conveniente.

Participe por campo

Use essa transformação para unir vários resultados em uma única tabela. Isso é especialmente útil para converter vários resultados de séries temporais em uma única tabela ampla com um campo de tempo compartilhado.

Junção interna

Uma junção interna mescla dados de várias tabelas em que todas as tabelas compartilham o mesmo valor do campo selecionado. Esse tipo de junção exclui dados em que os valores não coincidem em todos os resultados.

Use essa transformação para combinar os resultados de várias consultas (combinando em um campo de junção aprovado ou na coluna da primeira vez) em um resultado e descartar linhas onde uma junção bem-sucedida não pode ocorrer.

No exemplo a seguir, duas consultas retornam dados da tabela. Ela é visualizada como duas tabelas separadas antes de aplicar a transformação da junção interna.

Consulta A:

Consulta B:

O resultado após a aplicação da transformação da junção interna é semelhante ao seguinte:

Junção externa

Uma junção externa inclui todos os dados de uma junção interna e linhas em que os valores não coincidem em todas as entradas. Enquanto a junção interna une a Consulta A e a Consulta B no campo de hora, a junção externa inclui todas as linhas que não coincidem no campo de hora.

No exemplo a seguir, duas consultas retornam dados da tabela. Ela é visualizada como duas tabelas antes de aplicar a transformação da junção externa.

Consulta A:

Consulta B:

O resultado após a aplicação da transformação de junção externa é semelhante ao seguinte:

Rótulos para campos

Essa transformação altera os resultados da série temporal que incluem rótulos ou tags em uma tabela em que cada chave e valor do rótulo são incluídos no resultado da tabela. Os rótulos podem ser exibidos como colunas ou valores de linha.

Dado um resultado de consulta de duas séries temporais:

No modo Colunas, o resultado fica assim:

No modo “Linhas”, o resultado tem uma tabela para cada série e mostra o valor de cada rótulo da seguinte forma:

Nome do campo de valor

Se você selecionou Servidor como nome do campo Valor, obteria um campo para cada valor do rótulo Servidor.

Comportamento de mesclagem

O transformador de rótulos para campos é, internamente, duas transformações separadas. O primeiro atua em uma única série e extrai rótulos para campos. A segunda é a transformação de mesclagem que une todos os resultados em uma única tabela. A transformação de mesclagem tenta unir todos os campos correspondentes. Essa etapa de mesclagem é obrigatória e não pode ser desativada.

Para ilustrar isso, veja um exemplo em que você tem duas consultas que retornam séries temporais sem rótulos sobrepostos.

Isso resultará primeiro nessas duas tabelas:

Após a fusão:

Merge

Use essa transformação para combinar o resultado de várias consultas em um único resultado. Isso é útil ao usar a visualização do painel de tabela. Os valores que podem ser mesclados são combinados na mesma linha. Os valores podem ser mesclados se os campos compartilhados contiverem os mesmos dados.

No exemplo abaixo, temos duas consultas retornando dados da tabela. Ela é visualizada como duas tabelas separadas antes de aplicar a transformação.

Consulta A:

Consulta B:

Aqui está o resultado depois de aplicar a transformação Merge:

Organize campos

Use essa transformação para renomear, reordenar ou ocultar campos retornados pela consulta.

Grafana exibe uma lista de campos retornados pela consulta. É possível:

Partição por valores

Essa transformação pode ajudar a eliminar a necessidade de várias consultas à mesma fonte de dados com WHERE cláusulas diferentes ao representar graficamente várias séries. Considere uma tabela SQL de métricas com os seguintes dados:

Antes da versão 9.3, se você quisesse traçar uma linha de tendência vermelha para os EUA e uma azul para a UE no mesmo TimeSeries painel, provavelmente precisaria dividi-la em duas consultas:

SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='US'
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='EU'

Isso também exige que você saiba com antecedência quais regiões realmente existem na tabela de métricas.

Com o transformador Partition by values, agora você pode emitir uma única consulta e dividir os resultados por valores exclusivos em uma ou mais colunas (fields) de sua escolha. O exemplo a seguir usa Region.

SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'

Reduzir

A transformação Reduce aplica um cálculo a cada campo no quadro e retorna um único valor. Os campos de hora são removidos ao aplicar essa transformação.

Considere a entrada:

Consulta A:

Consulta B:

O transformador de redução tem dois modos:

Por exemplo, se você usasse o Primeiro e o Último cálculo com uma transformação de série em linhas, o resultado seria:

Os campos Reduzir com o último cálculo resultam em dois quadros, cada um com uma linha:

Consulta A:

Consulta B:

Renomear por regex

Use essa transformação para renomear partes dos resultados da consulta usando uma expressão regular e um padrão de substituição.

Você pode especificar uma expressão regular, que só é aplicada às correspondências, junto com um padrão de substituição que suporte referências anteriores. Por exemplo, vamos imaginar que você esteja visualizando o uso da CPU por host e queira remover o nome do domínio. Você poderia definir o regex como ([^\.]+)\..+ e o padrão de substituição como$1, se web-01.example.com web-01 tornaria.

Linhas para campos

A transformação de linhas em campos converte linhas em campos separados. Isso pode ser útil, pois os campos podem ser estilizados e configurados individualmente. Ele também pode usar campos adicionais como fontes para configuração dinâmica de campos ou mapeá-los para rótulos de campo. Os rótulos adicionais podem então ser usados para definir melhores nomes de exibição para os campos resultantes.

Essa transformação inclui uma tabela de campos que lista todos os campos nos dados retornados pela consulta de configuração. Essa tabela fornece controle sobre qual campo deve ser mapeado para cada propriedade de configuração (a opção *Usar como**). Você também pode escolher qual valor selecionar se houver várias linhas nos dados retornados.

Essa transformação requer:

Útil ao visualizar dados em:

Mapeie campos extras para rótulos

Se um campo não for mapeado para a propriedade de configuração, o Grafana o usará automaticamente como fonte para um rótulo no campo de saída-

Exemplo:

Saída:

Agora, os rótulos extras podem ser usados no nome de exibição do campo para fornecer nomes de campo mais completos.

Se você quiser extrair a configuração de uma consulta e aplicá-la a outra, use a configuração da transformação dos resultados da consulta.

Exemplo

Entrada:

Saída:

Como você pode ver, cada linha nos dados de origem se torna um campo separado. Cada campo agora também tem uma opção de configuração máxima definida. Opções como Mínimo, Máximo, Unidade e Limites fazem parte da configuração do campo e, se definidas dessa forma, serão usadas pela visualização em vez de qualquer opção configurada manualmente no painel de opções do editor de painéis.

Prepare séries temporais

Preparar a transformação de séries temporais é útil quando uma fonte de dados retorna dados de séries temporais em um formato que não é suportado pelo painel que você deseja usar.

Essa transformação ajuda você a resolver esse problema convertendo os dados da série temporal do formato amplo para o formato longo ou vice-versa.

Selecione a opção Série temporal de vários quadros para transformar o quadro de dados da série temporal do formato amplo para o longo.

Selecione a opção Série temporal ampla para transformar o quadro de dados da série temporal do formato longo para o formato amplo.

Série para linhas

Use essa transformação para combinar o resultado de várias consultas de dados de séries temporais em um único resultado. Isso é útil ao usar a visualização do painel de tabela.

O resultado dessa transformação conterá três colunas: Tempo, Métrica e Valor. A coluna Métrica é adicionada para que você possa ver facilmente de qual consulta a métrica se origina. Personalize esse valor definindo Label na consulta de origem.

No exemplo abaixo, temos duas consultas retornando dados de séries temporais. Ela é visualizada como duas tabelas separadas antes de aplicar a transformação.

Consulta A:

Consulta B:

Aqui está o resultado depois de aplicar a transformação da série às linhas.

Ordenar por

Essa transformação classificará cada quadro pelo campo configurado. Quando reverse estiver marcada, os valores retornarão na ordem oposta.

Limite

Use essa transformação para limitar o número de linhas exibidas.

No exemplo abaixo, temos a seguinte resposta da fonte de dados:

Aqui está o resultado depois de adicionar uma transformação Limit com um valor de '3':