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á.
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte Trabalhar no Grafana versão 9.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Trabalhar no Grafana versão 8.
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, consulte Correlações na versão 10 do Grafana.
Criar uma correlação
Você pode criar correlações na página do Explore.
Para criar uma correlação
-
No espaço de trabalho do Amazon Managed Grafana, navegue até a página do Explore.
-
Selecione uma fonte de dados que você gostaria que fosse a fonte de uma nova correlação.
-
Execute uma consulta produzindo dados em uma visualização compatível.
-
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.
-
Agora você pode criar as seguintes correlações para a visualização com links anexados aos dados que você pode usar para criar uma consulta:
-
Logs: os links são exibidos ao lado dos valores dos campos dentro dos detalhes do log de cada linha de log.
-
Tabela : cada célula da tabela é um link.
-
-
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. Consulte mais detalhes em Configuração de correlação.
-
Na visualização dividida que se abre, use o painel direito para configurar a origem da consulta de destino da correlação. Consulte mais detalhes em Consulta de destino.
-
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 exemplo da linha de dados selecionada.
-
Forneça um rótulo e uma descrição (opcional). Um rótulo será usado como o nome do link dentro da visualização e pode conter variáveis.
-
Forneça transformações (opcional; veja abaixo para obter detalhes).
-
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
-
Selecione um campo ao qual a transformação será aplicada. Selecione a parte do campo que você deseja usar para a transformação. Por exemplo, uma linha de log. Depois de selecionado, o valor desse campo será usado para ajudar no desenvolvimento da transformação.
-
Selecione o tipo da transformação. Consulte Transformações de correlação para ver as opções e configurações relevantes.
-
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.
-
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, o mapValue mencionado em outra documentação é chamado aqui de Variable Name. O 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 campo Variable
Name.
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.
Criar uma correlação de texto para grafo
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 de grafo.
Para seguir este exemplo, verifique se você configurou uma fonte de dados de teste.
Para criar uma correlação de texto para grafo
-
No Grafana, navegue até Explore.
-
Selecione a fonte de dados de teste no menu suspenso no canto superior esquerdo da página.
-
Escolha + Adicionar no menu suspenso à direita e selecione Adicionar correlação.
-
O Explore agora está no modo Editor de correlações, indicado por uma borda azul.
-
Selecione o seguinte cenário no seu menu suspenso: Arquivo CSV.
-
Selecione o arquivo population_by_state.csv. Cada célula é um link no qual você pode clicar para começar a criar uma correlação.
-
Clique em qualquer célula na coluna
Statepara criar uma correlação que anexa um link de dados a essa entrada. Por exemplo, consulteCalifornia. -
Na visualização dividida, selecione a mesma fonte de dados selecionada no painel esquerdo. O assistente 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.
-
No menu Cenário, selecione Valores de métricas CSV. O campo
String Inputno editor de consultas fornece variáveis com valores populacionais para cada ano:${1980},${2000},${2020}. Isso vai gerar um grafo usando valores de variáveis. -
No campo Alias do editor de consultas, insira
${State}.Execute uma consulta para ver se ela produz um grafo usando valores de exemplo das variáveis.
-
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 de um estado, a consulta à direita será executada novamente com os valores da linha sendo inseridos no CSV, alterando assim o grafo. 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.
Criar uma correlação entre logs e tabelas
Neste exemplo, você criará uma correlação para demonstrar como usar transformações para extrair valores da linha de log e de outro campo.
Para seguir este exemplo, verifique se você configurou uma fonte de dados de teste.
Para criar uma correlação entre logs e tabelas
-
No Grafana, navegue até Explore.
-
Selecione a fonte de dados de teste no menu suspenso no canto superior esquerdo da página.
-
Escolha + Adicionar no menu suspenso à direita e selecione Adicionar correlação.
-
O Explore agora está no modo Editor de correlações, indicado por uma borda azul.
-
No menu Cenário, selecione Logs.
-
Expanda uma linha de log para ver os links de correlação. Selecione
Correlate with hostname. -
O Explore abre em visualização dividida. Selecione a mesma fonte de dados selecionada no painel esquerdo. O assistente acima do editor de consultas contém todas as variáveis disponíveis que você pode usar na consulta de destino.
-
Expanda a seção de transformações e clique em Adicionar transformação.
-
No menu suspenso Campo, selecione mensagem. A linha de log aparece como dados de exemplo.
-
Em Tipo, selecione Logfmt. Isso preenche a lista de variáveis.
-
Escolha Adicionar transformação à correlação.
-
Escolha Adicionar transformação novamente e, em Campo, selecione nome do host.
-
Em Tipo, selecione Expressão regular.
-
Em Expressão, insira o seguinte:
-([0-9]\*). Isso seleciona qualquer número à direita do traço. -
Em Nome da variável, insira o seguinte:
hostNumber. Isso preenche a lista de variáveis. -
Escolha Adicionar transformação à correlação para adicioná-la às outras variáveis.
-
No editor da fonte de dados, abra o menu suspenso Cenário e selecione Conteúdo CSV.
-
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 log para ver o botão de correlação. Escolher o botão de correlação abre a visualização dividida com o
time(um campo), amsg(extraída com logfmt da linha de log), ohost number(extraído com regex dohostname) e ostatus(extraído com logfmt da linha de log).
