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á.
# Transformações
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 8.x**.
Para espaços de trabalho do Grafana que suportam a versão 12.x do Grafana, consulte. [Trabalhando na versão 12 do Grafana](using-grafana-v12.md)
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).
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.
**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 de tabela. Isso geralmente ajuda você a entender melhor o que a transformação está fazendo com os 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.
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:
+ Você inseriu uma consulta e retornou dados de uma fonte de dados. Para obter mais informações sobre consultas, confira [Consultas](panel-queries.md).
+ Você aplicou uma visualização compatível com consultas, como uma das seguintes visualizações:
+ Medidor em barras
+ Medidor
+ Gráfico
+ Mapa de calor
+ Logs
+ Stat
+ Tabela
## 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**.
**Para aplicar uma transformação**
1. No painel ao qual você deseja adicionar transformações, escolha o título do painel e depois **Editar**.
1. Escolha a guia **Transform** (Transformação).
1. Selecione uma transformação.
Na linha de transformação exibida, você pode configurar as opções de transformação.
1. 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 as transformações](#debug-transformations).
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.
**Topics**
+ [Reduzir](#reduce)
+ [Mesclar](#merge)
+ [Filtrar por nome](#filter-by-name)
+ [Filtrar dados por consulta](#filter-data-by-query)
+ [Organizar campos](#organize-fields)
+ [Unir por campo (junção externa)](#join-by-field-outer-join)
+ [Adicionar campo do cálculo](#add-field-from-calculation)
+ [Rótulos para campos](#labels-to-fields)
+ [Agrupar por](#sort-by)
+ [Agrupar por](#group-by)
+ [Séries para linhas](#series-to-rows)
+ [Filtrar dados por valor](#filter-data-by-value)
+ [Depurar transformações](#debug-transformations)
### 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](list-of-calculations.md).
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
| Hora | Trabalho | Tempo de atividade |
| --- | --- | --- |
| 2020-07-07 11:34:20 | nó | 25260122 |
| 2020-07-07 11:24:20 | postgre | 123001233 |
Consulta B
| Hora | Trabalho | Erros |
| --- | --- | --- |
| 2020-07-07 11:34:20 | nó | 15 |
| 2020-07-07 11:24:20 | postgre | 5 |
Veja abaixo o resultado depois de aplicar a transformação de **mesclagem**.
| Hora | Trabalho | Erros | Tempo de atividade |
| --- | --- | --- | --- |
| 2020-07-07 11:34:20 | nó | 15 | 25260122 |
| 2020-07-07 11:24:20 | postgre | 5 | 123001233 |
### 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:
+ Insira uma expressão regex.
+ Escolha um campo para alternar a filtragem nesse campo. Os campos filtrados são exibidos com texto na cor cinza escuro, e os campos não filtrados têm texto na cor branca.
### 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.
**nota**
Esta transformação funciona somente em painéis que têm uma única consulta. Se o 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 as seguintes alterações:
+ Altere a ordem dos campos ao pausar sobre um campo. O cursor vira uma mão e, em seguida, você pode arrastar o campo para o novo local.
+ Ocultar ou mostrar um campo ao selecionar o ícone do olho próximo do nome do campo.
+ Renomeie os campos digitando um novo nome na caixa **Renomear**.
### 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.
+ **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 (`sum`, `multiply` etc.) em valores em uma única linha 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 campo. Escolha o campo para ver uma lista de opções de cálculo. Para obter informações sobre os cálculos disponíveis, consulte [Lista de cálculos](list-of-calculations.md).
+ **Alias**: (opcional) insira o nome do novo campo. Se estiver em branco, o campo será nomeado para corresponder ao cálculo.
+ **Substituir todos os campos**: (opcional) use esta 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 esta transformação, a consulta precisa retornar campos rotulados.
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:
| Hora | 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 o **nome do campo Valor**, vai obter um campo para cada valor do rótulo `Server`.
| Hora | Datacenter | Servidor A | Servidor B |
| --- | --- | --- | --- |
| 2020-07-07 11:34:20 | UE | 1 | 2 |
### 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.
| Hora | ID do servidor | Temperatura da CPU | Status do servidor |
| --- | --- | --- | --- |
| 2020-07-07 11:34:20 | servidor 1 | 80 | Desligado |
| 2020-07-07 11:34:20 | servidor 3 | 62 | OK |
| 2020-07-07 10:32:20 | servidor 2 | 90 | Sobrecarregado |
| 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 |
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:
| Hora | ID do servidor | Temperatura da CPU | Status do servidor |
| --- | --- | --- | --- |
| 2020-07-07 11:34:20 | servidor 1 | 80 | Desligado |
| 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 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:
| 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 cálculos a seguir.
+ Para o campo `Time`, você pode calcular o *Último* valor para saber quando o último ponto de dados foi recebido de cada servidor.
+ Para o campo `Server Status`, você pode calcular o *Último* valor para saber o último valor do estado de cada servidor.
+ Para o campo `Temperature`, você também pode calcular o *Último* valor para saber a última temperatura monitorada de cada servidor.
A transformação Agrupar por produz os resultados a seguir.
| ID do servidor | Temperatura da CPU (média) | Temperatura da CPU (última) | Tempo (último) | Status do servidor (último) |
| --- | --- | --- | --- | --- |
| servidor 1 | 82 | 80 | 2020-07-07 11:34:20 | Desligado |
| servidor 2 | 88,6 | 90 | 2020-07-07 10:32:20 | Sobrecarregado |
| servidor 3 | 59,6 | 62 | 2020-07-07 11:34:20 | OK |
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
| Hora | Temperatura |
| --- | --- |
| 2020-07-07 11:34:20 | 25 |
| 2020-07-07 10:31:22 | 22 |
| 2020-07-07 09:30:05 | 19 |
Consulta B
| Hora | 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 transformação `Series to rows` produz os resultados a seguir.
| Hora | 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
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:
+ **Regex**: corresponde a uma expressão regex.
+ **É nulo**: corresponde se o valor for nulo.
+ **Não é nulo**: corresponde se o valor não for nulo.
+ **Igual**: corresponde se o valor for igual ao valor especificado.
+ **Diferente**: corresponde se o valor for diferente do valor especificado.
As condições disponíveis para campos numéricos são as seguintes:
+ **Maior**: corresponde se o valor for maior que o valor especificado.
+ **Inferior**: corresponde se o valor for menor que o valor especificado.
+ **Maior ou igual**: corresponde se o valor for maior que ou igual ao valor especificado.
+ **Menor ou igual**: corresponde se o valor for menor que ou igual ao valor especificado.
+ **Intervalo**: corresponda um intervalo entre um mínimo e um máximo especificados. O mínimo e o máximo estão incluídos no intervalo.
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.