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 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.
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 de origem
-
A origem 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 resultados
Os links são mostrados nas visualizações do Explore para os resultados da fonte de dados de origem da correlação. Um link é atribuído a um dos campos do resultado fornecido na configuração da 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 na consulta de destino com variáveis.
Variáveis de correlação
Você pode usar variáveis na consulta de destino para acessar os dados de origem relacionados à consulta. As correlações usam a sintaxe da variável do Grafana. As variáveis são preenchidas com os valores dos resultados de origem 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 de origem contiverem um campo chamado employee, 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 a campos existentes.
A correlação criará um link 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 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 que contém texto formatado com pares de chave/valor logfmt
A transformação logfmt só vai exigir a especificação do nome do campo de entrada se você quiser que a transformação seja aplicada em um campo diferente do campo de resultados. Exemplo de variáveis de saída para field = "host=srv001 endpoint=/test
app=foo":
| name | valor |
|---|---|
| host | srv001 |
| endpoint | /test |
| aplicativo | foo |
Transformação de expressão regular
A transformação de 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 com base na primeira correspondência. O valor substituirá a variável correspondente ao campo de entrada ou uma nova variável será criada se mapValue for fornecido (veja exemplos na tabela a seguir).
- mapValue
-
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 variável. Isso poderá ser útil se a 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 seja John Doe.
Várias variáveis de saída com base nas opções de expressão e mapValue:
| expressão | mapValue | 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 denominada name. |
/(?\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 |
