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á.
Configuração de correlaçã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
Cada correlação é configurada com as seguintes opções:
- Rótulo
-
Rótulo do link, mostrado na visualização.
- Descrição
-
Descrição opcional.
- Fonte de dados
-
A fonte dos resultados que têm links exibidos.
- Campo de resultados
-
Define onde o link é mostrado em uma visualização.
- Consulta de destino
-
A consulta de destino é executada quando um link é clicado.
- Transformações
-
Manipulações opcionais nos dados de origem incluídos são passadas para a consulta de destino.
Para obter detalhes sobre como criar uma correlação, consulte Criar uma correlação.
Fonte de dados de origem e campo de resultado
Os links são mostrados nas visualizações do Explore para os resultados da fonte de dados da correlação. Um link é atribuído a um dos campos a partir do resultado fornecido na configuração de correlação (o campo de resultados). Cada visualização exibe campos com links de uma forma diferente.
Consulta de destino
A consulta de destino é executada quando um link é clicado na visualização. Você pode usar o editor de consultas da fonte de dados de destino selecionada para especificar a consulta de destino. Os resultados dos dados de origem podem ser acessados dentro da consulta de destino com variáveis.
Variáveis de correlação
Você pode usar variáveis dentro da consulta de destino para acessar os dados de origem relacionados à consulta. As correlações usam a sintaxe da variável Grafana. As variáveis são preenchidas com valores dos resultados da fonte quando o link é escolhido. Há dois tipos de variáveis que você pode usar:
-
Variáveis de campo (para acessar valores e rótulos de campo).
-
Variáveis de correlação (para acessar valores e transformações de campo).
Exemplo: Se os resultados da fonte contiverem um campo chamadoemployee, o valor do campo poderá ser acessado com:
-
Uma variável de campo
${__data.fields.employee}. -
Uma variável de correlação que mapeia o valor do campo acima para
${employee}.
Além de mapear valores de campo para nomes de variáveis mais curtos, mais variáveis de correlação podem ser criadas aplicando transformações aos campos existentes.
A correlação cria um vínculo de dados somente se todas as variáveis tiverem valores na linha de dados selecionada. As variáveis globais são a exceção a essa regra e não precisam ser preenchidas a partir dos dados retornados. Essas variáveis são interpoladas automaticamente pelas fontes de dados.
Transformações de correlação
As transformações fornecem uma maneira de extrair mais variáveis dos valores de campo. A saída das transformações é um conjunto de novas variáveis que podem ser acessadas como qualquer outra variável.
Há dois tipos de transformações: logfmt e expressão regular.
Cada transformação usa um valor de campo selecionado como entrada. A saída de uma transformação é um conjunto de novas variáveis com base no tipo e nas opções da transformação.
Transformação Logfmt
A transformação logfmt desconstrói um valor de campo contendo texto formatado com pares de chave/valor logfmt.
A transformação logfmt só requer a especificação do nome do campo de entrada se você quiser que a transformação se aplique a um campo diferente do campo de resultados. Exemplo de variáveis de saída parafield = "host=srv001 endpoint=/test
app=foo":
| name | valor |
|---|---|
| host | srv001 |
| endpoint | /teste |
| aplicativo | comida |
Transformação de expressão regular
A transformação da expressão regular desconstrói um valor de campo com base na expressão regular fornecida.
Opções de transformação de expressão regular:
- Campo
Nome do campo de entrada
- expressão
-
Expressão regular. Os grupos de captura nomeados são mapeados para variáveis que correspondem ao nome do grupo. Se grupos de correspondência não nomeados forem usados, uma variável será criada a partir da primeira correspondência. O valor substitui a variável correspondente ao campo de entrada ou uma nova variável é criada se mapValue for fornecido (veja exemplos na tabela a seguir).
- Valor do mapa
-
Usado com grupos regex simples sem grupos correspondentes nomeados. Por padrão, a primeira correspondência substitui a variável pelo nome do campo usado como entrada. Para alterar esse comportamento padrão, você pode especificar a propriedade mapValue. O nome fornecido é usado para criar uma nova variável. Isso pode ser útil se sua consulta de destino exigir o valor exato e uma parte do valor extraído com a transformação.
Exemplo: supondo que o nome do campo selecionado seja employee e o valor do campo sejaJohn Doe.
Várias variáveis de saída com base nas opções de expressão e mapValue:
| expressão | Valor do mapa | variáveis de saída | comentário |
|---|---|---|---|
/\w+ (\w+)/ |
- | employee=Doe |
Nenhum mapValue fornecido. A primeira correspondência é mapeada para a variável de nome de campo existente (employee). |
/(\w+) (\w+)/ |
name | name=John |
A primeira correspondência é mapeada para uma nova variável chamadaname. |
/(?\w+) (?\w+)/ |
- | firstName=John, lastName=Doe |
Quando grupos nomeados são usados, eles são os nomes das variáveis de saída e mapValue é ignorado. |
/(?\w+) (?\w+)/ |
name | firstName=John, lastName=Doe |
O mesmo que acima |
