Funções de transformação - Amazon Managed Grafana

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á.

Funções de transformação

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

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.

  • Modo - Selecione um modo:

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

    • Operação binária — aplique operações binárias básicas (por exemplo, soma ou multiplicação) em valores em uma única linha a partir de dois campos selecionados.

    • Operação unária — aplique operações unárias básicas em valores em uma única linha a partir de um campo selecionado. As operações disponíveis são:

      • Valor absoluto (abs) — Retorna o valor absoluto de uma determinada expressão. Ele representa a distância de zero como um número positivo.

      • Exponencial natural (exp) — Retorna e elevado à potência de uma determinada expressão.

      • Logaritmo natural (ln) — Retorna o logaritmo natural de uma determinada expressão.

      • Floor (floor) — Retorna o maior número inteiro menor ou igual a uma determinada expressão.

      • Teto (teto) — retorna o menor número inteiro maior ou igual a uma determinada expressão.

    • Funções cumulativas — aplique funções na linha atual e em todas as linhas anteriores.

      • Total — Calcula o total cumulativo até e incluindo a linha atual.

      • Média — Calcula a média até e incluindo a linha atual.

    • Funções da janela — Aplique as funções da janela. A janela pode estar à direita ou centralizada. Com uma janela à direita, a linha atual será a última linha na janela. Com uma janela centralizada, a janela será centralizada na linha atual. Para tamanhos de janelas uniformes, a janela será centralizada entre a linha atual e a linha anterior.

      • Média — Calcula a média móvel ou média corrente.

      • — Calcula o desvio padrão móvel.

      • Variância — Calcule a variância móvel.

    • Índice da linha — insira um campo com o índice da linha.

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

  • Cálculo — Se você selecionar o modo Reduzir linha, o campo Cálculo será exibido. Selecione o campo para ver uma lista das opções de cálculo que você pode usar para criar o novo campo. Para obter informações sobre os cálculos disponíveis, consulte Tipos de cálculo.

  • Operação — Se você selecionar o modo Operação binária ou Operação unária, os campos Operação aparecerão. Esses campos permitem que você faça operações matemáticas básicas em valores em uma única linha a partir de dois campos selecionados. Você também pode usar valores numéricos para operações binárias.

  • Como percentil — Se você selecionar o modo Índice de linha, a opção Como percentil será exibida. Essa opção permite transformar o índice da linha como uma porcentagem do número total de linhas.

  • 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) Selecione essa opção se quiser ocultar todos os outros campos e exibir somente o campo calculado na visualização.

nota

As funções cumulativas e as funções de janela estão atualizadas na visualização pública. A Grafana Labs oferece suporte limitado, e mudanças significativas podem ocorrer antes que o recurso seja disponibilizado ao público em geral.

Concatenar campos

Concatenar campos

Use essa transformação para combinar todos os campos de todos os quadros em um único resultado.

Por exemplo, se você tiver consultas separadas recuperando dados de temperatura e tempo de atividade (consulta A) e informações de índice de qualidade do ar e de erro (consulta b), a aplicação da transformação concatenada produz um quadro de dados consolidado com todas as informações relevantes em uma única visualização.

Considere os dois a seguir.

Consulta A:

Temporário Tempo de atividade

15.4

1230233

Consulta B:

AQI Erros

3.2

5

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

Temporário Tempo de atividade AQI Erros

15.4

1230233

3.2

5

Essa transformação simplifica o processo de mesclar dados de diferentes fontes, fornecendo uma visão abrangente para análise e visualização.

Config a partir dos resultados da consulta

Config a partir dos resultados da consulta

Use essa transformação para selecionar uma consulta e extrair opções padrão, como Mínimo, Máximo, Unidade e Limites, e aplicá-las a outros resultados da consulta. Isso permite a configuração dinâmica da visualização, com base nos dados retornados por uma consulta específica.

Opções

  • Consulta de configuração — Selecione a consulta que retorna os dados que você deseja usar como configuração.

  • Aplicar a — Selecione os campos ou séries aos quais a configuração deve ser aplicada.

  • Aplicar às opções — Especifique um tipo de campo ou use um nome de campo regex, dependendo da sua seleção em Aplicar a.

Tabela de mapeamento de campo

Abaixo das opções de configuração, você encontrará a tabela de mapeamento de campos. Essa tabela lista todos os campos encontrados nos dados retornados pela consulta de configuração, junto com as opções Usar como e Selecionar. Ele fornece controle sobre campos de mapeamento para propriedades de configuração e, para várias linhas, permite que você escolha qual valor selecionar.

O exemplo a seguir mostra uma consulta de entrada e uma consulta usada como configuração de campo.

Consulta de entrada

Tempo Valor

1626178119127

10

1626178119129

30

Consulta de configuração

Tempo Valor

1626178119127

100

1626178119129

100

Consulta de saída (igual à entrada, mas agora com configuração no campo de valor)

Tempo Valor (configuração: Max = 100)

1626178119127

10

1626178119129

30

Cada campo agora tem uma opção máxima de configuração definida. Opções como Mínimo, Máximo, Unidade e Limites fazem parte da configuração do campo. Se definidas, elas são usadas pela visualização em vez de qualquer opção configurada manualmente no painel de opções do editor de painéis.

Mapeamentos de valores

Você também pode transformar o resultado de uma consulta em mapeamentos de valores. Com essa opção, cada linha no resultado da consulta de configuração define uma única linha de mapeamento de valores. Veja o exemplo a seguir.

Resultado da consulta de configuração

Valor Texto Cor

L

Baixo

azul

M

Médio

verde

H

Alta

vermelho

No mapeamento de campo, especifique:

Campo Use como Selecionar

Valor

Mapeamentos de valor/Valor

Todos os valores

Texto

Mapeamentos de valores//Texto

Todos os valores

Cor

Mapeamentos de valores/Cor

Todos os valores

Grafana cria mapeamentos de valor a partir do resultado da consulta e os aplica aos resultados reais da consulta de dados. Você deve ver os valores sendo mapeados e coloridos de acordo com os resultados da consulta de configuração.

Converter tipo de campo

Use essa transformação para modificar o tipo de campo do campo especificado.

Essa transformação tem as seguintes opções:

  • Campo — Selecione entre os campos disponíveis.

  • como — Selecione o FieldType para converter.

    • Numérico — tenta transformar os valores em números.

    • String — fará com que os valores sejam cadeias de caracteres.

    • Tempo — tenta analisar os valores como tempo.

      • Mostrará uma opção para especificar a DateFormat como entrada por uma string, como yyyy-mm-dd ouDD MM YYYY hh:mm:ss.

    • Boolean — tornará os valores booleanos.

    • Enum — fará com que os valores sejam enumerados.

      • Mostrará uma tabela para gerenciar as enumerações.

    • Outro — tenta analisar os valores como json.

Por exemplo, considere a consulta a seguir, que pode ser modificada selecionando o campo de hora, como Hora, e Formato de data comoYYYY.

Tempo Mark Valor

2017-07-01

acima

25

2018-08-02

abaixo

22

02/09/2019

abaixo

29

2020-10-04

acima

22

O resultado:

Tempo Mark Valor

2017-01-01 00:00:00

acima

25

2018-01-01 00:00:00

abaixo

22

2019-01-01 00:00:00

abaixo

29

2020-01-01 00:00:00

acima

22

Essa transformação permite que você adapte com flexibilidade seus tipos de dados, garantindo compatibilidade e consistência em suas visualizações.

Extrair campos

Use essa transformação para selecionar uma fonte de dados e extrair conteúdo dela em diferentes formatos. Essa transformação tem os seguintes campos:

  • Fonte — Selecione o campo para a fonte dos dados.

  • Formato — Escolha uma das seguintes opções:

    • JSON — Analise o conteúdo JSON da fonte.

    • Pares de chave+valor — Analise o conteúdo no formato a=b ou c:d na fonte.

    • Automático — Descubra campos automaticamente.

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

  • Mantenha a hora - (opcional) disponível somente se a opção Substituir todos os campos for verdadeira. Mantém o campo de hora na saída.

Considere o seguinte conjunto de dados:

Exemplo de conjunto de dados

Timestamp dados_json

1636678740000000000

{"valor”: 1}

1636678680000000000

{"valor”: 5}

1636678620000000000

{"valor”: 12}

Você pode preparar os dados para serem usados por um painel de séries temporais com esta configuração:

  • Fonte: json_data

  • Formato: JSON

    • Campo: valor

    • Pseudônimo: my_value

  • Substitua todos os campos: verdadeiro

  • Mantenha o tempo: verdadeiro

Isso gerará a seguinte saída:

Dados transformados

Timestamp meu_valor

1636678740000000000

1

1636678680000000000

5

1636678620000000000

12

Com essa transformação, você pode extrair e formatar dados de várias maneiras. Você pode personalizar o formato de extração com base em suas necessidades específicas de dados.

Campos de pesquisa do recurso

Use essa transformação para enriquecer um valor de campo pesquisando campos adicionais de uma fonte externa.

Essa transformação tem os seguintes campos:

  • Campo — Selecione um campo de texto do seu conjunto de dados.

  • Pesquisa — Escolha entre países, estados dos EUA e aeroportos.

nota

Essa transformação só oferece suporte a dados espaciais.

Por exemplo, se você tiver esses dados:

Exemplo de conjunto de dados

Local Valores

AL

0

AK

10

Arizona

5

Arkansas

1

Em algum lugar

5

Com essa configuração:

  • Campo: localização

  • Pesquisa: Estados dos EUA

Você obterá o seguinte resultado:

Dados transformados

Local ID Nome Lng Lat Valores
AL AL Alabama -80,89 1064 12.448457 0
AK AK Arkansas -100,89 1064 24.448457 10
Arizona 5
Arkansas 1
Em algum lugar 5

Essa transformação permite ampliar seus dados buscando informações adicionais de fontes externas, fornecendo um conjunto de dados mais abrangente para análise e visualização.

Filtrar dados por consulta RefID

Use essa transformação para ocultar uma ou mais consultas em painéis com várias consultas.

Grafana exibe as letras de identificação da consulta em texto cinza escuro. Escolha 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.

nota

Essa transformação não está disponível para o Graphite porque essa fonte de dados não oferece suporte à correlação de dados retornados com consultas.

Filtrar dados por valores

Use essa transformação para filtrar seletivamente os pontos de dados diretamente na sua visualização. Essa transformação fornece opções para incluir ou excluir dados com base em uma ou mais condições aplicadas a um campo selecionado.

Essa transformação é muito ú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:

  • 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 adicionais disponíveis para campos numéricos são:

  • 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.

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

  • Intervalo — Combine um intervalo entre um mínimo e um máximo especificados, incluindo mínimo e máximo.

Considere o seguinte conjunto de dados:

Tempo Temperatura Altitude
2020-07-07 11:34:23 32 101
2020-07-07 11:34:22 28 125
2020-07-07 11:34:21 26 110
2020-07-07 11:34:20 23 98
2020-07-07 10:32:24 31 95
2020-07-07 10:31:22 20 85
2020-07-07 09:30:57 19 101

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

  • Tipo de filtro: 'Incluir'

  • Condição: linhas em que 'Temperatura' corresponde a 'Menor que' '' 30 '

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

Dados transformados

Tempo Temperatura Altitude
2020-07-07 11:34:22 28 125
2020-07-07 11:34:21 26 110
2020-07-07 11:34:20 23 98
2020-07-07 10:31:22 20 85
2020-07-07 09:30:57 19 101

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:

  • Tipo de filtro: 'Incluir' linhas que 'correspondem a todas' condições

  • Condição 1: linhas em que 'Temperatura' corresponde a 'Menor' que '30'

  • Condição 2: Linhas em que 'Altitude' corresponde a 'Maior' que '100'

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°C e uma altitude superior a 100. Se quiséssemos incluir as linhas que têm uma temperatura inferior a 30°C OU uma altitude superior a 100 em vez disso, 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.

Essa transformação versátil de filtragem de dados permite que você inclua ou exclua pontos de dados seletivamente com base em condições específicas. Personalize os critérios para adaptar sua apresentação de dados para atender às suas necessidades analíticas exclusivas.

Filtrar campos por nome

Use essa transformação para remover partes dos resultados da consulta. Há três maneiras de filtrar nomes de campo:

  • Insira uma expressão regular.

  • Selecione manualmente os campos incluídos.

  • Use uma variável do painel.

Use uma expressão regular

Quando você filtra usando uma expressão regular, os nomes de campo que correspondem à expressão regular são incluídos. Por exemplo, usar a expressão regular 'prod.*' retornaria somente os campos que começam com prod

A expressão regular pode incluir uma variável de painel interpolada usando a ${variableName} sintaxe.

Selecione manualmente os campos incluídos

Selecione ou desmarque os nomes dos campos para removê-los do resultado. Se uma expressão regular também for incluída, os campos que corresponderem à expressão serão incluídos, mesmo que não estejam marcados.

Use uma variável do painel

Selecione Da variável para permitir que você selecione uma variável do painel usada para incluir campos. Ao configurar uma variável de painel com várias opções, os mesmos campos podem ser exibidos em várias visualizações.

Essa transformação fornece flexibilidade na adaptação dos resultados da consulta para se concentrar nos campos específicos de que você precisa para uma análise e visualização eficazes.

Formatar string

Use essa transformação para personalizar a saída de um campo de string. Essa transformação tem os seguintes campos:

  • Maiúsculas — formata a string inteira em caracteres maiúsculos.

  • Minúsculas — formata a string inteira em caracteres minúsculos.

  • Maiúsculas e minúsculas da frase — formata o primeiro caractere da string em maiúsculas.

  • Letra maiúscula do título — Formata o primeiro caractere de cada palavra na string em maiúsculas.

  • Maiúsculas e minúsculas — formata o primeiro caractere de cada palavra na string em maiúsculas e não inclui espaços entre as palavras.

  • Camel case — Formata o primeiro caractere de cada palavra na string em maiúsculas, exceto a primeira palavra, e não inclui espaços entre as palavras.

  • Snake case — formata todos os caracteres da string em minúsculas e usa sublinhados em vez de espaços entre as palavras.

  • Letras maiúsculas e minúsculas — formata todos os caracteres da string em letras minúsculas e usa traços em vez de espaços entre as palavras.

  • Aparar — Remove todos os espaços à esquerda e à direita da string.

  • Substring — Retorna uma substring da string, usando as posições inicial e final especificadas.

Essa transformação fornece uma maneira conveniente de padronizar e adaptar a apresentação de dados de sequência de caracteres para melhor visualização e análise.

nota

Essa transformação está atualmente em pré-visualização pública. A Grafana Labs oferece suporte limitado, e mudanças significativas podem ocorrer antes que o recurso seja disponibilizado ao público em geral.

Formatar hora

Use essa transformação para personalizar a saída de um campo de hora. A saída pode ser formatada usando cadeias de caracteres no formato Moment.js. Por exemplo, se você quiser exibir somente o ano de um campo de hora, a string de formato 'YYYY' pode ser usada para mostrar o ano civil (por exemplo, 1999 ou 2012).

Antes da transformação:

Timestamp Evento
1636678740000000000 Início do sistema
1636678680000000000 Login de usuário
1636678620000000000 Dados atualizados

Depois de aplicar “AAAA-MM-DD HH:mm:SS”:

Timestamp Evento
2021-11-12 14:25:40 Início do sistema
2021-11-12 14:24:40 Login de usuário
2021-11-12 14:23:40 Dados atualizados

Essa transformação permite que você personalize a representação do tempo em suas visualizações, fornecendo flexibilidade e precisão na exibição de dados temporais.

nota

Essa transformação está disponível em espaços de trabalho compatíveis com o Grafana v10 como um recurso alfa.

Agrupar por

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

Aqui está um exemplo de dados originais.

Tempo ID do servidor Temperatura da CPU Status do servidor

07/07/2020 11:34:20

servidor 1

80

Desligamento

07/07/2020 11:34:20

servidor 3

62

OK

07/07/2020 10:32:20

servidor 2

90

Sobrecarga

07/07/2020 10:31:22

servidor 3

55

OK

07/07/2020 09:30:57

servidor 3

62

Rebooting

07/07/2020 09:30:05

servidor 2

88

OK

07/07/2020 09:28:06

servidor 1

80

OK

07/07/2020 09:25:05

servidor 2

88

OK

07/07/2020 09:23:07

servidor 1

86

OK

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:

Tempo ID do servidor Temperatura da CPU Status do servidor

07/07/2020 11:34:20

servidor 1

80

Desligamento

07/07/2020 09:28:06

servidor 1

80

OK

07/07/2020 09:23:07

servidor 1

86

OK

07/07/2020 10:32:20

servidor 2

90

Sobrecarga

07/07/2020 09:30:05

servidor 2

88

OK

07/07/2020 09:25:05

servidor 2

88

OK

07/07/2020 11:34:20

servidor 3

62

OK

07/07/2020 10:31:22

servidor 3

55

OK

07/07/2020 09:30:57

servidor 3

62

Rebooting

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:

ID do servidor Temperatura da CPU (média)

servidor 1

82

servidor 2

88,6

servidor 3

59,6

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

  • Para o campo Hora, podemos calcular o último valor, para saber quando o último ponto de dados foi recebido para cada servidor

  • Para o campo Status do servidor, podemos calcular o último valor para saber qual é o último valor de estado para cada servidor

  • Para o campo Temperatura, também podemos calcular o último valor para saber qual é a última temperatura monitorada para cada servidor

Em seguida, obteríamos:

ID do servidor Temperatura da CPU (média) Temperatura da CPU (última) Hora (última) Status do servidor (último)

servidor 1

82

80

07/07/2020 11:34:20

Desligamento

servidor 2

88,6

90

07/07/2020 10:32:20

Sobrecarga

servidor 3

59,6

62

07/07/2020 11:34:20

OK

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

Agrupamento em matriz

Use essa transformação para combinar três campos, que são usados como entrada para os campos de valor de coluna, linha e célula a partir da saída da consulta, e gerar uma matriz. A matriz é calculada da seguinte forma:

Dados originais

ID do servidor Temperatura da CPU Status do servidor
servidor 1 82 OK
servidor 2 88,6 OK
servidor 3 59,6 Desligamento

Podemos gerar uma matriz usando os valores de Server Status como nomes de colunas, os Server ID valores como nomes de linhas e o CPU Temperature como conteúdo de cada célula. O conteúdo de cada célula aparecerá para a combinação existente de coluna (Server Status) e linha (Server ID). Para o resto das células, você pode selecionar qual valor exibir entre: Nulo, Verdadeiro, Falso ou Vazio.

Saída

ID do servidor Status do servidor OK Desligamento
servidor 1 82
servidor 2 88,6
servidor 3 59,6

Use essa transformação para criar uma matriz especificando campos dos resultados da consulta. A saída da matriz reflete as relações entre os valores exclusivos nesses campos. Isso ajuda você a apresentar relacionamentos complexos em um formato de matriz claro e estruturado.

Agrupar à tabela aninhada

Use essa transformação para agrupar os dados por um valor de campo (coluna) especificado e processar o cálculo em cada grupo. São gerados registros que compartilham o mesmo valor de campo agrupado, para serem exibidos em uma tabela aninhada.

Para calcular uma estatística para um campo, selecione a caixa ao lado do campo e escolha a opção Calcular. Isso adicionará outra caixa de seleção com estatísticas a serem selecionadas.

A tabela a seguir mostra exemplos de dados.

Tempo ID do servidor Temperatura da CPU Status do servidor

07/07/2020 11:34:20

servidor 1

80

Desligamento

07/07/2020 11:34:20

servidor 3

62

OK

07/07/2020 10:32:20

servidor 2

90

Sobrecarga

07/07/2020 10:31:22

servidor 3

55

OK

07/07/2020 09:30:57

servidor 3

62

Rebooting

07/07/2020 09:30:05

servidor 2

88

OK

07/07/2020 09:28:06

servidor 1

80

OK

07/07/2020 09:25:05

servidor 2

88

OK

07/07/2020 09:23:07

servidor 1

86

OK

Essa transformação tem duas etapas. Primeiro, especifique um ou mais campos pelos quais agrupar os dados. Isso agrupa todos os mesmos valores desses campos, como se você os classificasse. Por exemplo, se você agrupar por Server ID campo, o Grafana agrupa os dados desta forma:

ID do servidor Dados

servidor 1

Tempo Temperatura da CPU Status do servidor

07/07/2020 11:34:20

80

Desligamento

07/07/2020 09:28:06

80

OK

07/07/2020 09:23:07

86

OK

servidor 2

Tempo Temperatura da CPU Status do servidor

07/07/2020 10:32:20

90

Sobrecarga

07/07/2020 09:30:05

88

OK

07/07/2020 09:25:05

88

OK

servidor 3

Tempo Temperatura da CPU Status do servidor

07/07/2020 11:34:20

62

OK

07/07/2020 10:31:22

55

OK

07/07/2020 09:30:57

62

Rebooting

Depois de escolher o campo pelo qual você 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, talvez você queira calcular a temperatura média da CPU para cada um desses servidores. Para fazer isso, adicione o cálculo médio aplicado no campo Temperatura da CPU para obter o seguinte resultado:

ID do servidor Temperatura da CPU (média)

servidor 1

82

Tempo Status do servidor

07/07/2020 11:34:20

Desligamento

07/07/2020 09:28:06

OK

07/07/2020 09:23:07

OK

servidor 2

88,6

Tempo Status do servidor

07/07/2020 10:32:20

Sobrecarga

07/07/2020 09:30:05

OK

07/07/2020 09:25:05

OK

servidor 3

59,6

Tempo Status do servidor

07/07/2020 11:34:20

OK

07/07/2020 10:31:22

OK

07/07/2020 09:30:57

Rebooting

Crie um mapa de calor

Use essa transformação para preparar dados do histograma para visualizar tendências ao longo do tempo. Semelhante à visualização do mapa de calor, essa transformação converte as métricas do histograma em intervalos temporais.

Balde X

Essa configuração determina como o eixo x é dividido em compartimentos.

  • Tamanho — Especifique um intervalo de tempo no campo de entrada. Por exemplo, um intervalo de tempo de 1h cria células com uma hora de largura no eixo x.

  • Contagem — Para non-time-related séries, use essa opção para definir o número de elementos em um bucket.

Balde Y

Essa configuração determina como o eixo y é dividido em compartimentos.

  • Linear

  • Logarítmico — Escolha entre log base 2 ou log base 10.

  • Symlog — Usa uma escala logarítmica simétrica. Escolha entre log base 2 ou log base 10, permitindo valores negativos.

Suponha que você tenha o seguinte conjunto de dados:

Timestamp Valor
2023-01-01 12:00:00 5
2023-01-01 12:15:00 10
2023-01-01 12:30:00 15
2023-01-01 12:45:00 8
  • Com X Bucket definido como Size: 15m e Y Bucket comoLinear, o histograma organiza os valores em intervalos de tempo de 15 minutos no eixo x e linearmente no eixo y.

  • Para X Bucket as Count: 2 e Y Bucket asLogarithmic (base 10), o histograma agrupa valores em compartimentos de dois no eixo x e usa uma escala logarítmica no eixo y.

Histograma

Use essa transformação para gerar um histograma com base nos dados de entrada, permitindo que você visualize a distribuição dos valores.

  • Tamanho do compartimento — O intervalo entre os itens mais baixos e mais altos em um compartimento (xMin a xMax).

  • Deslocamento do balde — O deslocamento dos compartimentos. non-zero-based

  • Combinar séries — Crie um histograma unificado usando todas as séries disponíveis.

Dados originais

Série 1:

A B C
1 3 5
2 4 6
3 5 7
4 6 8
5 7 9

Série 2:

C
5
6
7
8
9

Saída

x min Xmáx A B C C
1 2 1 0 0 0
2 3 1 0 0 0
3 4 1 1 0 0
4 5 1 1 0 0
5 6 1 1 1 1
6 7 0 1 1 1
7 8 0 1 1 1
8 9 0 0 1 1
9 10 0 0 1 1

Visualize a distribuição dos valores usando o histograma gerado, fornecendo informações sobre a dispersão e a densidade dos dados.

Participe por campo

Use essa transformação para mesclar vários resultados em uma única tabela, permitindo a consolidação de dados de diferentes consultas.

É 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:

Tempo Trabalho Tempo de atividade

07/07/2020 11:34:20

25260122

07/07/2020 11:24:20

cartaz

123001233

07/07/2020 11:14:20

cartaz

345001233

Consulta B:

Tempo Servidor Erros

07/07/2020 11:34:20

servidor 1

15

07/07/2020 11:24:20

servidor 2

5

07/07/2020 11:04:20

servidor 3

10

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

Tempo Trabalho Tempo de atividade Servidor Erros

07/07/2020 11:34:20

25260122

servidor 1

15

07/07/2020 11:24:20

cartaz

123001233

servidor 2

5

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:

Tempo Trabalho Tempo de atividade

07/07/2020 11:34:20

25260122

07/07/2020 11:24:20

cartaz

123001233

07/07/2020 11:14:20

cartaz

345001233

Consulta B:

Tempo Servidor Erros

07/07/2020 11:34:20

servidor 1

15

07/07/2020 11:24:20

servidor 2

5

07/07/2020 11:04:20

servidor 3

10

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

Tempo Trabalho Tempo de atividade Servidor Erros

07/07/2020 11:04:20

servidor 3

10

07/07/2020 11:14:20

cartaz

345001233

07/07/2020 11:34:20

25260122

servidor 1

15

07/07/2020 11:24:20

cartaz

123001233

servidor 2

5

Junte-se por rótulos

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 Rótulo compartilhado.

  • Unir — Selecione o rótulo para unir entre os rótulos disponíveis ou comuns em todas as séries temporais.

  • Valor — O nome do resultado de saída.

Exemplo

Entrada 1: series1{what='Temp', cluster='A', job='J1'}

Tempo Valor
1 10
2 200

Entrada 2: series2{what='Temp', cluster='B', job='J1'}

Tempo Valor
1 10
2 200

Entrada 3: series3{what='Speed', cluster='B', job='J1'}

Tempo Valor
22 22
28 77

Config:

value: 'what'

Saída:

cluster trabalho Temporário Velocidade
A J1 10
A J1 200
B J1 10 22
B J1 200 77

Combine e organize dados de séries temporais de forma eficaz com essa transformação para obter insights abrangentes.

Rótulos para campos

Use essa transformação para converter resultados de séries temporais com rótulos ou tags em uma tabela, incluindo as chaves e valores de cada rótulo no resultado. Exiba rótulos como valores de colunas ou linhas para melhorar a visualização de dados.

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

  • Série 1 — rótulosServer=Server A, Datacenter=EU

  • Série 2 — rótulosServer=Server B, Datacenter=EU

No modo Colunas, o resultado fica assim:

Tempo Servidor Datacenter Valor

07/07/2020 11:34:20

Servidor A

UE

1

07/07/2020 11:34:20

Servidor B

UE

2

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

rótulo valor

Servidor

Servidor A

Datacenter

UE

rótulo valor

Servidor

Servidor B

Datacenter

UE

Nome do campo de valor

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

Tempo Datacenter Servidor A Servidor B

07/07/2020 11:34:20

UE

1

2

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.

  • Série 1 — rótulos Server=ServerA

  • Série 2 — rótulos Datacenter=EU

Isso resultará primeiro nessas duas tabelas:

Tempo Servidor Valor

07/07/2020 11:34:20

Servidor A

10

Tempo Datacenter Valor

07/07/2020 11:34:20

UE

20

Após a fusão:

Tempo Servidor Valor Datacenter

07/07/2020 11:34:20

Servidor A

10

07/07/2020 11:34:20

20

UE

Limite

Use essa transformação para restringir o número de linhas exibidas, fornecendo uma visão mais focada dos seus dados. Isso é particularmente útil ao lidar com grandes conjuntos de dados.

Veja a seguir um exemplo que ilustra o impacto da transformação Limit em uma resposta de uma fonte de dados:

Tempo Métrica Valor

07/07/2020 11:34:20

Temperatura

25

07/07/2020 11:34:20

Umidade

22

07/07/2020 10:32:20

Umidade

29

07/07/2020 10:31:22

Temperatura

22

07/07/2020 09:30:57

Umidade

33

07/07/2020 09:30:05

Temperatura

19

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

Tempo Métrica Valor

07/07/2020 11:34:20

Temperatura

25

07/07/2020 11:34:20

Umidade

22

07/07/2020 10:32:20

Umidade

29

Essa transformação ajuda você a personalizar a apresentação visual de seus dados para se concentrar nos dados mais relevantes.

Mesclar séries/tabelas

Use essa transformação para combinar o resultado de várias consultas em um único resultado, o que é particularmente útil ao usar a visualização do painel de tabela. A transformação mescla valores na mesma linha se os campos compartilhados contiverem os mesmos dados.

Aqui está um exemplo de ilustração do impacto da transformação de séries/tabelas do Merge em duas consultas que retornam dados da tabela:

Consulta A:

Tempo Trabalho Tempo de atividade

07/07/2020 11:34:20

25260122

07/07/2020 11:24:20

cartaz

123001233

Consulta B:

Tempo Trabalho Erros

07/07/2020 11:34:20

15

07/07/2020 11:24:20

cartaz

5

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

Tempo Trabalho Erros Tempo de atividade

07/07/2020 11:34:20

15

25260122

07/07/2020 11:24:20

cartaz

5

123001233

Essa transformação combina valores da Consulta A e da Consulta B em uma tabela unificada, aprimorando a apresentação para obter melhores insights.

Organize os campos por nome

Use essa transformação para renomear, reordenar ou ocultar campos retornados por uma única consulta em seu painel. Essa transformação só funciona em painéis com uma única consulta. Se seu painel tiver várias consultas, você deverá aplicar uma transformação de junção externa ou remover as consultas extras.

Transformando campos

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

  • Alterar a ordem dos campos — Arraste um campo para um novo local na lista.

  • Ocultar ou mostrar um campo — Use o ícone de olho ao lado do nome do campo para alternar a visibilidade de um campo.

  • Renomear campos — digite um novo nome na caixa Renomear.

Exemplo

Dado esse resultado inicial da consulta:

Tempo 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

Você pode aplicar uma substituição de campo de renomeação para criar:

Tempo Sensor Leitura
2020-07-07 11:34:20 Temperatura 25
2020-07-07 11:34:20 Umidade 22
2020-07-07 10:32:20 Umidade 29

Essa transformação permite personalizar a exibição dos resultados da consulta, garantindo uma representação clara e perspicaz de seus dados na Grafana.

Partição por valores

Use essa transformação para simplificar o processo de representação gráfica de várias séries sem a necessidade de várias consultas com cláusulas diferentes. WHERE

nota

Essa função está disponível em espaços de trabalho compatíveis com a versão 9 e superior do Grafana.

Isso é particularmente útil ao usar uma tabela SQL de métricas, como neste exemplo:

Tempo Região Valor

20/10/2022 12:00:00

EUA

1520

20/10/2022 12:00:00

UE

2936

20/10/2022 1:00:00 DA MANHÃ

EUA

1327

20/10/2022 1:00:00 DA MANHÃ

UE

912

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

SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'
Tempo Região Valor

20/10/2022 12:00:00

EUA

1520

20/10/2022 1:00:00 DA MANHÃ

EUA

1327

Tempo Região Valor

20/10/2022 12:00:00

UE

2936

20/10/2022 1:00:00 DA MANHÃ

UE

912

Essa transformação simplifica o processo e aumenta a flexibilidade de visualizar várias séries dentro da mesma visualização de séries temporais.

Prepare séries temporais

Use essa transformação para resolver problemas quando uma fonte de dados retorna dados de séries temporais em um formato que não é compatível com a visualização desejada. Essa transformação permite converter dados de séries temporais entre formatos amplos e longos.

Séries temporais de vários quadros

Use essa opção para transformar o quadro de dados da série temporal do formato amplo para o formato longo. Isso é particularmente útil quando sua fonte de dados fornece informações de séries temporais em um formato que precisa ser remodelado para uma compatibilidade ideal com sua visualização.

Exemplo

Essa entrada:

Timestamp Value1 Value2

2023-01-01 00:00:00

10

20

2023-01-01 01:00:00

15

25

Pode ser transformado em:

Timestamp Variável Valor

2023-01-01 00:00:00

Value1

10

2023-01-01 00:00:00

Value2

20

2023-01-01 01:00:00

Value1

15

2023-01-01 01:00:00

Value2

25

Ampla série temporal

Use essa opção para transformar o quadro de dados da série temporal do formato longo para o formato amplo. Isso é particularmente útil quando sua fonte de dados fornece dados de séries temporais em um formato longo e sua visualização exige um formato amplo.

Exemplo

Essa entrada:

Timestamp Variável Valor

2023-01-01 00:00:00

Value1

10

2023-01-01 00:00:00

Value2

20

2023-01-01 01:00:00

Value1

15

2023-01-01 01:00:00

Value2

25

Pode ser transformado em:

Timestamp Value1 Value2

2023-01-01 00:00:00

10

20

2023-01-01 01:00:00

15

25

Reduzir

O uso dessa transformação aplica um cálculo a cada campo no quadro de dados e retorna um único valor. Essa transformação é particularmente útil para consolidar dados de várias séries temporais em um formato mais compacto e resumido. Os campos de hora são removidos ao aplicar essa transformação.

Considere a entrada:

Consulta A:

Tempo Temporário Tempo de atividade

2020-07-07 11:34:20

12.3

25612

2020-07-07 11:24:20

15.4

1230233

Consulta B:

Tempo AQI Erros

2020-07-07 11:34:20

6.5

15

2020-07-07 11:24:20

3.2

5

O transformador de redução tem dois modos:

  • Série para linhas — cria uma linha para cada campo e uma coluna para cada cálculo.

  • Reduzir campos — mantém a estrutura de quadros existente, mas reduz cada campo em um único valor.

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

Campo First Last

Temporário

12.3

15.4

Tempo de atividade

25612

1230233

AQI

6.5

3.2

Erros

15

5

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

Consulta A:

Temporário Tempo de atividade

15.4

1230233

Consulta B:

AQI Erros

3.2

5

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.

Essa transformação permite que você personalize seus dados para atender às suas necessidades de visualização, tornando seus painéis mais informativos e fáceis de usar.

Linhas para campos

Use essa transformação para converter linhas em campos separados. Isso pode ser útil porque 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:

  • Um campo para usar como fonte dos nomes dos campos.

    Por padrão, a transformação usa o primeiro campo de string como fonte. Você pode substituir essa configuração padrão selecionando Nome do campo na coluna Usar como do campo que você deseja usar em vez disso.

  • Um campo para usar como fonte de valores.

    Por padrão, a transformação usa o primeiro campo numérico como fonte. Mas você pode substituir essa configuração padrão selecionando Valor do campo na coluna Usar como do campo que você deseja usar em vez disso.

Útil ao visualizar dados em:

  • Medidor

  • Stat

  • Gráfico de pizza

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:

Nome DataCenter Valor

Servidor A

EUA

100

Servidor B

UE

200

Saída:

ServerA (rótulos DataCenter: EUA) ServerB (rótulos DataCenter: UE)

100

200

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:

Nome Valor Máx

Servidor A

10

100

Servidor B

20

200

Servidor C

30

300

Saída:

servidorA (configuração: max=100) ServerB (configuração: max=200) Servidor C (configuração: máx = 300)

10

20

30

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.

Essa transformação permite a conversão de linhas em campos individuais, facilita a configuração dinâmica do campo e mapeia campos adicionais para rótulos.

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:

Tempo Temperatura

2020-07-07 11:34:20

25

2020-07-07 10:31:22

22

2020-07-07 09:30:05

19

Consulta B:

Tempo Umidade

2020-07-07 11:34:20

24

2020-07-07 10:32:20

29

2020-07-07 09:30:57

33

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

Tempo 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

Essa transformação facilita a consolidação dos resultados de várias consultas de séries temporais, fornecendo um conjunto de dados simplificado e unificado para análise e visualização eficientes em formato tabular.

Classificar por

Use essa transformação para classificar cada quadro em um resultado de consulta com base em um campo especificado, facilitando a compreensão e a análise dos dados. Ao configurar o campo desejado para classificação, você pode controlar a ordem na qual os dados são apresentados na tabela ou na visualização.

Use a opção Inverter para ordenar inversamente os valores dentro do campo especificado. Essa funcionalidade é particularmente útil quando você deseja alternar rapidamente entre a ordem crescente e decrescente para atender às suas necessidades analíticas.

Por exemplo, em um cenário em que dados de séries temporais são recuperados de uma fonte de dados, a transformação Classificar por pode ser aplicada para organizar os quadros de dados com base no registro de data e hora, em ordem crescente ou decrescente, dependendo dos requisitos analíticos. Esse recurso garante que você possa navegar e interpretar facilmente dados de séries temporais, obtendo informações valiosas da apresentação organizada e visualmente coerente.

Espacial

Use essa transformação para aplicar operações espaciais aos resultados da consulta.

  • Ação — Selecione uma ação:

    • Preparar campo espacial — Defina um campo de geometria com base nos resultados de outros campos.

      • Modo de localização — Selecione um modo de localização (essas opções são compartilhadas pelos modos Calcular valor e Transformar):

        • Automático — Identifica automaticamente os dados de localização com base nos nomes de campo padrão.

        • Coordenadas — Especifique os campos de latitude e longitude.

        • Geohash — Especifique um campo de geohash.

        • Pesquisa — Especifique os campos de localização do Gazetteer.

    • Calcular valor — Use a geometria para definir um novo campo (cabeçalho/distância/área).

      • Função — Escolha uma operação matemática para aplicar à geometria:

        • Título — Calcule o rumo (direção) entre dois pontos.

        • Área — Calcule a área delimitada por um polígono definido pela geometria.

        • Distância — Calcule a distância entre dois pontos.

    • Transformar — aplique operações espaciais à geometria.

      • Operação — Escolha uma operação para aplicar à geometria:

        • Como linha — Crie um único recurso de linha com um vértice em cada linha.

        • Construtor de linhas — Crie uma linha entre dois pontos.

Essa transformação permite manipular e analisar dados geoespaciais, possibilitando operações como criar linhas entre pontos, calcular propriedades espaciais e muito mais.

Transformação de séries temporais em tabela

Use essa transformação para converter resultados de séries temporais em uma tabela, transformando um quadro de dados de série temporal em um campo Tendência. O campo Tendência pode então ser renderizado usando o tipo de célula sparkline, gerando um minigráfico embutido para cada linha da tabela. Se houver várias consultas de séries temporais, cada uma resultará em um quadro de dados de tabela separado. Eles podem ser unidos usando transformações de junção ou mesclagem para produzir uma única tabela com vários minigráficos por linha.

Para cada valor do campo Tendência gerado, uma função de cálculo pode ser selecionada. O padrão é Último valor não nulo. Esse valor é exibido ao lado do minigráfico e usado para classificar as linhas da tabela.

Análise de regressão

Use essa transformação para criar um novo quadro de dados contendo valores previstos por um modelo estatístico. Isso é útil para encontrar uma tendência em dados caóticos. Ele funciona ajustando uma função matemática aos dados, usando regressão linear ou polinomial. O quadro de dados pode então ser usado em uma visualização para exibir uma linha de tendência.

Há dois modelos diferentes:

  • Regressão linear — ajusta uma função linear aos dados.

  • Regressão polinomial — ajusta uma função polinomial aos dados.

nota

Essa transformação está atualmente em pré-visualização pública. A Grafana Labs oferece suporte limitado, e mudanças significativas podem ocorrer antes que o recurso seja disponibilizado ao público em geral.