Transformações

As transformações processam o conjunto de resultados antes de passá-lo para a visualização. Você acessa as transformações na guia Transformar do editor de painéis do Amazon Managed Grafana.

Você pode usar as transformações para renomear campos, unir séries temporais separadas, fazer cálculos em consultas e muito mais. Se você tiver dashboards grandes ou consultas pesadas, poder reutilizar o resultado da consulta de um painel para outro pode proporcionar um grande ganho de performance.

O Amazon Managed Grafana aplica transformações na sequência em que elas são listadas na tela. Cada transformação cria um novo conjunto de resultados que é passado para a próxima transformação no pipeline.

A ordem pode fazer uma grande diferença em com os resultados são exibidos. Por exemplo, caso use a transformação de redução para condensar todos os resultados de uma coluna em um único valor, você poderá aplicar transformações somente a esse valor único.

Pré-requisitos

Antes de aplicar transformações, todas as seguintes opções devem ser verdadeiras:

Aplicar uma transformação

As transformações estão disponíveis na guia Transformar, no painel inferior do editor de painéis, próximo à guia Consultas.

Se você tiver problemas, escolha o ícone de bug para depurar as transformações.

Para remover uma transformação, escolha o ícone de lixeira.

Tipos e opções de transformação

Os espaços de trabalho do Grafana incluem as transformações a seguir.

Reduzir

Aplique uma transformação Reduzir quando quiser simplificar os resultados em um único valor. Reduzir basicamente remove o componente de tempo. Se visualizada como uma tabela, reduz uma coluna a uma linha (valor).

No campo Cálculos, insira um ou mais tipos de cálculos. Escolha para ver uma lista de opções de cálculos. Para obter informações sobre os cálculos disponíveis, consulte Lista de cálculos.

Depois de selecionar pelo menos um cálculo, o Amazon Managed Grafana exibe um valor usando o cálculo selecionado. Se você selecionar mais de um cálculo, mais de um valor será exibido.

Mesclar

Use esta transformação para combinar os resultados 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 poderão ser mesclados se os campos compartilhados contiverem os mesmos dados.

No exemplo a seguir, duas consultas retornam dados de tabela. Os dados são visualizados como duas tabelas separadas antes de aplicar a transformação.

Consulta A

Consulta B

Veja abaixo o resultado depois de aplicar a transformação de mesclagem.

Filtrar por nome

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

O Amazon Managed Grafana exibe o campo Identificador, seguido pelos campos retornados pela consulta.

Você pode aplicar filtros de duas formas:

Filtrar dados por consulta

Use esta transformação em painéis que tenham várias consultas, caso queira ocultar uma ou mais das consultas.

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

Organizar campos

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

O Amazon Managed Grafana exibe uma lista de campos retornados pela consulta. Você pode fazer as seguintes alterações:

Unir por campo (junção externa)

Use esta transformação para unir várias séries temporais de um conjunto de resultados por campo.

Esta transformação será útil se você quiser combinar consultas para poder calcular os resultados dos campos.

Adicionar campo do cálculo

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

Rótulos para campos

Quando você seleciona esta transformação, o Amazon Managed Grafana transforma automaticamente todos os dados rotulados em campos.

Por exemplo, considere o resultado da consulta de duas séries temporais.

1: rótulos Servidor = Servidor A, Data center = UE 2: rótulos Servidor = Servidor B, Data center = UE

Essa transformação vai resultar na seguinte tabela:

Nome do campo de valor; se você selecionou Server como o nome do campo Valor, vai obter um campo para cada valor do rótulo Server.

Agrupar por

Esta transformação classifica cada quadro pelo campo configurado. Quando reverse está marcado, os valores são retornados na ordem inversa.

Agrupar por

Esta transformação agrupa os dados por um valor de campo (coluna) especificado e processa os cálculos em cada grupo. Os cálculos disponíveis são os mesmos da transformação Reduzir.

Veja a seguir um exemplo de dados originais.

Esta transformação tem 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 você Agrupar por o campo Server ID, ele agrupará os dados desta forma:

2020-07-07 10:32:20 | server 2 | 90 | Overload
2020-07-07 09:30:05 | server 2 | 88 | OK
2020-07-07 09:25:05 | server 2 | 88 | OK

2020-07-07 11:34:20 | server 3 | 62 | OK
2020-07-07 10:31:22 | server 3 | 55 | OK
2020-07-07 09:30:57 | server 3 | 62 | Rebooting

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

Depois de escolher em qual campo deseja agrupar seus dados, você pode adicionar vários cálculos nos outros campos, e o cálculo será aplicado em cada grupo de linhas. Por exemplo, talvez você queira calcular a média de CPU temperature para cada um desses servidores. Você pode adicionar o cálculo da média aplicado no campo CPU Temperature para obter o seguinte:

E você pode adicionar mais de um desses cálculos. Por exemplo, você pode usar os cálculos a seguir.

A transformação Agrupar por produz os resultados a seguir.

Usando esta transformação, você pode extrair algumas informações importantes da série temporal e exibi-las de forma conveniente.

Séries para linhas

Use esta transformação para combinar os resultados 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: Time, Metric e Value. A coluna Metric é adicionada para que você possa ver de qual consulta a métrica se origina. Personalize esse valor definindo o Label na consulta de origem.

No exemplo abaixo, duas consultas retornam dados de séries temporais. Elas são visualizadas como duas tabelas separadas antes da aplicação da transformação.

Consulta A

Consulta B

A aplicação da transformação Series to rows produz os resultados a seguir.

Filtrar dados por valor

Esta transformação permite filtrar os dados diretamente no espaço de trabalho da 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 a um campo selecionado.

Esta transformação será útil se a fonte de dados não filtrar nativamente por valores. Você também pode usá-la 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 seguintes:

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

Você pode adicionar mais de uma condição ao filtro. Quando você tem mais de uma condição, é possível escolher se deseja que a ação de inclusão ou exclusão seja aplicada às linhas que correspondam a todas ou a qualquer uma das condições adicionadas.

As condições que não são válidas ou estão configuradas de forma incompleta são ignoradas.

Depurar transformações

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.

O Amazon Managed Grafana exibe a visualização da depuração da transformação abaixo da linha de transformação.