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á. # Correlações na versão 10 do Grafana **** 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](using-grafana-v9.md). Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md). Você pode criar links interativos para visualizações do Explore para executar consultas relacionadas aos dados apresentados ao configurar Correlações. Uma correlação define como os dados em uma fonte de dados são usados para consultar dados em outra fonte de dados. Alguns exemplos: + Um nome de aplicação retornado em uma fonte de dados de logs pode ser usado para consultar métricas relacionadas a essa aplicação em uma fonte de dados de métricas. + Um nome de usuário retornado por uma fonte de dados SQL pode ser usado para consultar logs relacionados a esse usuário específico em uma fonte de dados de logs. O Explore usa correlações definidas pelo usuário para exibir links nas visualizações. Você pode clicar em um link para executar a consulta relacionada e ver os resultados no Explore Split View. Explore visualizações que atualmente são compatíveis com a exibição de links com base em correlações: + [Logs](v10-panels-logs.md) + [Tabela](v10-panels-table.md) Você pode configurar correlações usando a página **Administração > Plug-ins e dados > Correlações** no Grafana ou diretamente no [Explore](v10-explore-correlations.md). **Topics** + [Configuração de correlação](v10-correlations-config.md) + [Criar uma correlação](v10-correlations-create.md) # 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](using-grafana-v9.md). Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md). 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](v10-correlations-create.md). ## 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](v10-dash-variable-syntax.md). 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](v10-panels-configure-data-links.md#v10-panels-data-link-variables) (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](v10-dash-variable-add.md#v10-dash-variable-add-global) 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](https://brandur.org/logfmt). Cada par torna-se uma variável com a chave sendo o nome da variável. 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 | | aplicação | 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 | comment | | --- | --- | --- | --- | | /\$1w\$1 (\$1w\$1)/ | - | employee=Doe | Nenhum mapValue fornecido. A primeira correspondência é mapeada para a variável de nome de campo existente (employee). | | /(\$1w\$1) (\$1w\$1)/ | name | name=John | A primeira correspondência é mapeada para uma nova variável denominada name. | | /(?\$1w\$1) (?\$1w\$1)/ | - | firstName=John, lastName=Doe | Quando grupos nomeados são usados, eles são os nomes das variáveis de saída e mapValue é ignorado. | | /(?\$1w\$1) (?\$1w\$1)/ | name | firstName=John, lastName=Doe | O mesmo que acima | # Criar uma 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](using-grafana-v9.md). Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md). Você pode criar correlações no editor de correlações do Explore ou usando a página de **administração** do Grafana no espaço de trabalho do Amazon Managed Grafana. **Pré-requisitos** Você deve ter permissão para adicionar novas correlações. Somente usuários com permissões de gravação em fontes de dados podem definir novas correlações. ## Criar uma correlação no editor de correlações do Explore Você pode criar uma correlação no editor de correlações do Explore. Consulte mais detalhes em [Criar uma correlação](v10-explore-correlations.md#v10-explore-corr-create-a-correlation). ## Criar uma correlação na página Administração Você pode usar a página **Administração** do console do Grafana para criar uma correlação. **Para criar uma correlação na página Administração** 1. Vá para a seção **Administração** no Grafana. 1. Em **Plug-ins e dados**, abra a página **Correlações**. 1. Escolha o botão **Adicionar** no canto superior direito. 1. Forneça um **rótulo** para a correlação. 1. (Opcional) Forneça uma **descrição**. 1. Vá para a próxima página. 1. Forneça a **fonte de dados de destino**. 1. Forneça a **consulta de destino** usando variáveis. 1. Vá para a próxima página. 1. Forneça a **fonte de dados de origem**. 1. Forneça o **campo de resultados**. 1. Adicione transformações se precisar de variáveis que não sejam campos na fonte de dados da origem. 1. Escolha **Adicionar** para adicionar uma nova transformação. 1. Selecione o tipo de transformação. 1. Configure a transformação de acordo com o tipo selecionado. 1. Salve a correlação. Você pode editar uma correlação da mesma forma, mas ao editar, não é possível alterar as fontes de dados selecionadas.