Editor de correlações no Explore - Amazon Managed Grafana
Criando uma correlaçãoTransformaçõesExemplos de correlações

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

Editor de correlações no Explore

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

As correlações permitem que os usuários criem um link entre quaisquer duas fontes de dados. Para obter mais informações, incluindo uma visão geral das correlações, consulteCorrelações na versão 10 da Grafana.

Criando uma correlação

Você pode criar correlações na página Explorar.

Para criar uma correlação

  1. Em seu espaço de trabalho Amazon Managed Grafana, navegue até a página Explore.

  2. Selecione uma fonte de dados que você gostaria que fosse a fonte de uma nova correlação.

  3. Execute uma consulta produzindo dados em uma visualização compatível.

    nota

    As visualizações suportadas são registros e tabelas.

  4. Escolha + Adicionar na barra de ferramentas superior e selecione Adicionar correlação (você também pode selecionar Editor de correlações na Paleta de comandos).

    O Explore agora está no modo Editor de Correlações indicado por uma borda azul e uma barra superior. Você pode sair do Editor de Correlações escolhendo Sair na barra superior.

  5. Agora você pode criar as seguintes novas correlações para a visualização com links anexados aos dados que você pode usar para criar uma nova consulta:

    • Registros — os links são exibidos ao lado dos valores dos campos dentro dos detalhes do registro de cada linha do registro.

    • Tabela — cada célula da tabela é um link.

  6. Escolha um link para adicionar uma nova correlação. Os links são associados a um campo que é usado como campo de resultado de uma correlação. Para obter mais detalhes, consulte Configuração de correlação.

  7. Na exibição dividida que se abre, use o painel direito para configurar a origem da consulta de destino da correlação. Para obter mais detalhes, consulte Consulta de destino.

  8. Crie uma consulta de destino usando a sintaxe de variáveis com variáveis da lista fornecida na parte superior do painel. A lista contém valores de amostra da linha de dados selecionada.

  9. Forneça uma etiqueta e uma descrição (opcional). Um rótulo será usado como o nome do link dentro da visualização e pode conter variáveis.

  10. Forneça transformações (opcional; veja detalhes abaixo).

  11. Escolha Salvar na barra de ferramentas superior para salvar a correlação e sair do modo Editor de correlações. O link usado para criar a correlação é substituído por um link de dados em cada linha. Quando o link for selecionado, a consulta que você definiu será executada em outro painel, com as variáveis substituídas dinamicamente pelos valores da linha selecionada.

Transformações

As transformações permitem extrair valores que existem em um campo com outros dados. Por exemplo, usando uma transformação, você pode extrair uma parte de uma linha de log para usar em uma correlação. Para obter mais detalhes sobre as transformações nas correlações, consulte. Transformações de correlação

Depois de escolher um dos links gerados no modo editor, você pode adicionar transformações selecionando Adicionar transformação no menu suspenso Transformações.

Para usar uma transformação em uma correlação

  1. Selecione um campo ao qual aplicar a transformação. Selecione a parte do campo que você deseja usar para a transformação. Por exemplo, uma linha de registro. Depois de selecionado, o valor desse campo será usado para ajudá-lo a criar a transformação.

  2. Selecione o tipo da transformação. Consulte Transformações de correlação as opções e configurações relevantes.

  3. Com base na sua seleção, talvez você veja uma ou mais variáveis serem preenchidas ou talvez precise fornecer mais especificações nas opções exibidas.

  4. Selecione Adicionar transformação à correlação para adicionar as variáveis especificadas à lista de variáveis disponíveis.

nota

Para expressões regulares nessa caixa de diálogo, a mapValue mencionada em outra documentação é chamada Variable Name aqui. Grafana destaca qualquer texto que corresponda à expressão no valor do campo. Use grupos de captura de expressão regular para selecionar qual parte da correspondência deve ser extraída. Quando uma expressão regular válida é fornecida, a variável e o valor dessa variável aparecem abaixo do Variable Name campo.

Exemplos de correlações

Os exemplos a seguir mostram como criar correlações usando o Editor de correlações no Explore. Se você quiser seguir esses exemplos, certifique-se de configurar uma fonte de dados de teste.

Criando uma correlação de texto para representar graficamente

Este exemplo mostra como criar uma correlação usando o Editor de correlações no Explore.

As correlações permitem que você use os resultados de uma consulta para executar uma nova consulta em qualquer fonte de dados. Neste exemplo, você executará uma consulta que renderiza dados tabulares. Os dados serão usados para executar uma consulta diferente que produz um resultado gráfico.

Para seguir esse exemplo, verifique se você configurou uma fonte de dados de teste.

Para criar uma correlação de texto para representar graficamente

  1. Em Grafana, navegue até Explorar.

  2. Selecione a fonte de dados de teste no menu suspenso no canto superior esquerdo da página.

  3. Escolha + Adicionar no menu suspenso à direita e selecione Adicionar correlação.

  4. O Explore agora está no modo Editor de Correlações, indicado por uma borda azul.

  5. Selecione o seguinte cenário no menu suspenso do cenário: Arquivo CSV.

  6. Selecione o arquivo population_by_state.csv. Cada célula é um link no qual você pode clicar para começar a criar uma nova correlação.

  7. Clique em qualquer célula na State coluna para criar uma nova correlação que anexa um link de dados a essa entrada. Por exemplo, consulte California.

  8. Na exibição dividida, selecione a mesma fonte de dados selecionada no painel esquerdo. O auxiliar acima do editor de consultas contém todas as variáveis disponíveis que você pode usar na consulta de destino. As variáveis contêm todos os campos de dados (colunas da tabela) da linha selecionada.

  9. No menu Cenário, selecione Valores métricos CSV. O String Input campo no editor de consultas fornece variáveis com valores populacionais para cada ano:${1980},${2000},${2020}. Isso gerará um gráfico usando valores variáveis.

  10. No campo Alias do Editor de Consultas, insira${State}.

    Execute uma consulta para ver se ela produz um gráfico usando valores de amostra das variáveis.

  11. Escolha Salvar para salvar a correlação e sair do Editor de correlações.

    Depois que a correlação for salva, o Explore executará novamente a consulta no painel esquerdo. Ao clicar no nome do estado, a consulta à direita é executada novamente com os valores da linha sendo inseridos no CSV, alterando assim o gráfico. A consulta é executada novamente com valores atualizados sempre que você clica no nome de um estado.

Você pode aplicar as mesmas etapas a qualquer fonte de dados. As correlações permitem criar links em visualizações para executar consultas dinâmicas com base nos dados selecionados. Neste exemplo, usamos dados retornados por uma consulta para criar uma nova consulta gerando visualizações diferentes usando a mesma fonte de dados. No entanto, você pode criar correlações entre qualquer fonte de dados para criar fluxos de exploração personalizados.

Criação de uma correlação entre registros e tabelas

Neste exemplo, você criará uma correlação para demonstrar como usar transformações para extrair valores da linha de registro e de outro campo.

Para seguir esse exemplo, verifique se você configurou uma fonte de dados de teste.

Para criar uma correlação entre registros e tabelas

  1. Em Grafana, navegue até Explorar.

  2. Selecione a fonte de dados de teste no menu suspenso no canto superior esquerdo da página.

  3. Escolha + Adicionar no menu suspenso à direita e selecione Adicionar correlação.

  4. O Explore agora está no modo Editor de Correlações, indicado por uma borda azul.

  5. No menu Cenário, selecione Registros.

  6. Expanda uma linha de registro para ver os links de correlação. Selecione Correlate with hostname.

  7. O Explore abre em visualização dividida. Selecione a mesma fonte de dados selecionada no painel esquerdo. O auxiliar acima do editor de consultas contém todas as variáveis disponíveis que você pode usar na consulta de destino.

  8. Expanda a seção de transformações e clique em Adicionar transformação.

  9. No menu suspenso Campo, selecione mensagem. A linha de registro aparece como dados de exemplo.

  10. Em Tipo, selecione Logfmt. Isso preenche a lista de variáveis.

  11. Escolha Adicionar transformação à correlação.

  12. Escolha Adicionar transformação novamente e, em Campo, selecione nome do host.

  13. Em Tipo, selecione Expressão regular.

  14. Em Expressão, insira o seguinte:-([0-9]\*). Isso seleciona qualquer número à direita do traço.

  15. Em Nome da variável, insira o seguinte:hostNumber. Isso preenche a lista de variáveis.

  16. Escolha Adicionar transformação à correlação para adicioná-la às outras variáveis.

  17. No editor da fonte de dados, abra o menu suspenso Cenário e selecione Conteúdo CSV.

  18. Na caixa de texto abaixo, forneça o seguinte e salve a correlação:

    time,msg,hostNumber,status
${time},${msg},${hostNumber},${status}

    Isso fecha a visualização dividida e executa novamente a consulta à esquerda. Expanda qualquer linha de registro para ver o botão de correlação. Escolher o botão de correlação abre a visualização dividida com time (um campo), msg (extraído com logfmt da linha de log), host number (extraído com regex da) e o (extraído com logfmt da linha de loghostname). status