Transformações

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

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 Amazon Managed Grafana.

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

nota

Às vezes, as transformações resultam em dados que não podem ser representados graficamente. Quando isso acontece, o Amazon Managed Grafana exibe uma sugestão sobre a visualização. Escolha a sugestão para mudar para a visualização da tabela. Isso geralmente ajuda você a entender melhor o que a transformação está fazendo com seus dados.

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.

O pedido pode fazer uma grande diferença na aparência dos resultados. Por exemplo, se você usar reduzir transformação para condensar todos os resultados de uma coluna em um único valor, poderá aplicar transformações somente a esse valor único.

Pré-requisitos

Antes de aplicar transformações, todos os itens a seguir devem ser verdadeiros:

• Você inseriu uma consulta e retornou dados de uma fonte de dados. Para obter mais informações sobre consultas, consulte Consultas.

• Você aplicou uma visualização que suporta consultas, como uma das seguintes visualizações:

  • Medidor de barras

  • Medidor

  • Gráfico

  • Mapa de calor

  • Logs

  • Stat

  • Tabela

Aplicando uma transformação

As transformações estão disponíveis na guia Transformar, no painel inferior do editor de painéis, ao lado da guia Consultas.

Para aplicar uma transformação

1. No painel ao qual você deseja adicionar transformações, escolha o título do painel e, em seguida, escolha Editar.

2. Escolha a guia Transform (Transformação).

3. Selecione uma transformação.

   Na linha de transformação exibida, você pode configurar as opções de transformação.

4. Para aplicar outra transformação, escolha Adicionar transformação. Lembre-se de que a próxima transformação atua no conjunto de resultados retornado pela transformação anterior.

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

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

Tipos e opções de transformação

Os espaços de trabalho da Grafana incluem as seguintes transformações.

Reduzir

Aplique uma transformação Reduce quando quiser simplificar seus resultados em um único valor. Reduzir basicamente remove o componente de tempo. Se visualizado como uma tabela, ele reduz uma coluna para uma linha (valor).

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

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

Mesclar

Use essa 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 podem ser mesclados se os campos compartilhados contiverem os mesmos dados.

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

Consulta A

Time	Trabalho	Tempo de atividade
2020-07-07 11:34:20	nó	25260122
2020-07-07 11:24:20	postger	123001233

Consulta B

Time	Trabalho	Erros
2020-07-07 11:34:20	nó	15
2020-07-07 11:24:20	postger	5

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

Time	Trabalho	Erros	Tempo de atividade
2020-07-07 11:34:20	nó	15	25260122
2020-07-07 11:24:20	postger	5	123001233

Filtrar por nome

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

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

Você pode aplicar filtros de duas maneiras:

• Insira uma expressão regex.

• Escolha um campo para alternar a filtragem nesse campo. Os campos filtrados são exibidos com texto cinza escuro, os campos não filtrados têm texto branco.

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.

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 estiver escura, os resultados serão ocultados.

Organize campos

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

nota

Essa transformação funciona somente em painéis que têm uma única consulta. Se seu painel tiver várias consultas, você deverá aplicar uma transformação Unir por campo (junção externa) ou remover as consultas extras.

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

• Altere a ordem dos campos fazendo uma pausa sobre um campo. O cursor se transforma em uma mão e, em seguida, você pode arrastar o campo para o novo local.

• Oculte ou mostre um campo escolhendo o ícone de olho ao lado do nome do campo.

• Renomeie os campos digitando um novo nome na caixa Renomear.

Unir por campo (junção externa)

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

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

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.

• Modo — Selecione um modo:

  • Reduzir linha — Aplique o cálculo selecionado em cada linha dos campos selecionados de forma independente.

  • Opção binária — aplique uma operação matemática básica (summultiply,, etc.) em valores em uma única linha a partir de dois campos selecionados.

• Nome do campo — Selecione os nomes dos campos que você deseja usar no cálculo do novo campo.

• Cálculo - Selecione um cálculo para usar quando o Amazon Managed Grafana criar o novo campo. Escolha o campo para ver uma lista de opções de cálculo. Para obter informações sobre os cálculos disponíveis, consulteLista de cálculos.

• Alias — (Opcional) Digite o nome do seu novo campo. Se você deixar isso em branco, o campo será nomeado de acordo com o cálculo.

• Substituir todos os campos — (Opcional) Use essa opção se quiser ocultar todos os outros campos e exibir somente o campo calculado na visualização.

Rótulos para campos

nota

Para aplicar essa transformação, sua consulta precisa retornar campos rotulados.

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

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

1: rótulos Servidor = Servidor A, Centro de Dados = UE 2: rótulos Servidor = Servidor B, Centro de Dados = UE

Essa transformação resultaria na tabela a seguir.

Time	Servidor	Datacenter	Valor
2020-07-07 11:34:20	Servidor A	UE	1
2020-07-07 11:34:20	Servidor B	UE	2

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

Time	Datacenter	Servidor A	Servidor B
2020-07-07 11:34:20	UE	1	2

Agrupar por

Essa transformação classifica cada quadro pelo campo configurado. Quando reverse está marcada, os valores são retornados na ordem oposta.

Agrupar por

Essa 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 Reduce.

Aqui está um exemplo de dados originais.

Time	ID do servidor	Temperatura da CPU	Status do servidor
2020-07-07 11:34:20	servidor 1	80	Desligamento
2020-07-07 11:34:20	servidor 3	62	OK
2020-07-07 10:32:20	servidor 2	90	Sobrecarga
2020-07-07 10:31:22	servidor 3	55	OK
2020-07-07 09:30:57	servidor 3	62	Rebooting
2020-07-07 09:30:05	servidor 2	88	OK
2020-07-07 09:28:06	servidor 1	80	OK
2020-07-07 09:25:05	servidor 2	88	OK
2020-07-07 09:23:07	servidor 1	86	OK

Essa transformação requer 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 Server ID campo, ele agrupará os dados desta forma:

Time	ID do servidor	Temperatura da CPU	Status do servidor
2020-07-07 11:34:20	servidor 1	80	Desligamento
2020-07-07 09:28:06	servidor 1	80	OK
2020-07-07 09:23:07	servidor 1	86	OK

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 você 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 CPU temperature de cada um desses servidores. Você pode adicionar o cálculo da média aplicado no CPU Temperature campo para obter o seguinte.

ID do servidor	Temperatura da CPU (média)
servidor 1	82
servidor 2	88,6
servidor 3	59,6

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

• Para o campoTime, você pode calcular o último valor, para saber quando o último ponto de dados foi recebido para cada servidor.

• Para o campoServer Status, você pode calcular o último valor para saber o último valor do estado de cada servidor.

• Para o campoTemperature, você também pode calcular o último valor para saber a última temperatura monitorada para cada servidor.

A transformação Group By produz os seguintes resultados.

ID do servidor	Temperatura da CPU (média)	Temperatura da CPU (última)	Hora (última)	Status do servidor (último)
servidor 1	82	80	2020-07-07 11:34:20	Desligamento
servidor 2	88,6	90	2020-07-07 10:32:20	Sobrecarga
servidor 3	59,6	62	2020-07-07 11:34:20	OK

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

Série para linhas

Use essa 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: TimeMetric, Value e. A Metric coluna é adicionada para que você possa ver de qual consulta a métrica se origina. Personalize esse valor definindo Label na consulta de origem.

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

Consulta A

Time	Temperatura
2020-07-07 11:34:20	25
2020-07-07 10:31:22	22
2020-07-07 09:30:05	19

Consulta B

Time	Umidade
2020-07-07 11:34:20	24
2020-07-07 10:32:20	29
2020-07-07 09:30:57	33

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

Time	Métrica	Valor
2020-07-07 11:34:20	Temperatura	25
2020-07-07 11:34:20	Umidade	22
2020-07-07 10:32:20	Umidade	29
2020-07-07 10:31:22	Temperatura	22
2020-07-07 09:30:57	Umidade	33
2020-07-07 09:30:05	Temperatura	19

Filtrar dados por valor

Essa transformação permite filtrar seus 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 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 seguintes:

• Regex — Corresponde a uma expressão regex.

• É nulo — Combine se o valor for nulo.

• Não é nulo — Combine se o valor não for nulo.

• Igual — Combine se o valor for igual ao valor especificado.

• Diferente — Combine se o valor for diferente do valor especificado.

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

• Maior — Combine se o valor for maior que o valor especificado.

• Inferior — Combine se o valor for menor que o valor especificado.

• Maior ou igual — Combine se o valor for maior ou igual ao valor especificado.

• Menor ou igual — Combine se o valor for menor ou igual ao valor especificado.

• Intervalo — Combine um intervalo entre um mínimo e um máximo especificados. O mínimo e o máximo estão incluídos na faixa.

Você pode adicionar mais de uma condição ao filtro. Quando você tem mais de uma condição, pode 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 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 de depuração da transformação abaixo da linha de transformação.