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
<a name="observability-correlations"></a>

As correlações vinculam um conjunto de dados de rastreamentos a um conjunto de dados de registros para que você possa visualizar as entradas de registro relacionadas ao investigar extensões de rastreamento. Ao definir uma correlação, você ativa a página Discover Traces para exibir registros que ocorreram durante a execução de um período, ajudando você a diagnosticar problemas mais rapidamente sem alternar entre as páginas.

## Requisitos de correlação
<a name="observability-correlations-requirements"></a>

Para criar uma correlação, seus dados de registro e rastreamento devem conter campos correspondentes. A tabela a seguir descreve os campos que a correlação usa para unir dados de rastreamento e registro.


| Campo | Description | Obrigatório | 
| --- | --- | --- | 
| ID de rastreamento | O identificador exclusivo do rastreamento. Deve existir tanto no índice de extensão de rastreamento quanto no índice de log. | Sim | 
| ID do período | O identificador exclusivo do período. Usado para combinar os registros com um intervalo específico em um rastreamento. | Não | 
| Nome do serviço | O nome do serviço que gerou a telemetria. Usado para filtrar registros relacionados por serviço. | Não | 
| Timestamp | O campo de hora usado para definir o escopo dos registros relacionados ao intervalo de tempo do período. | Sim | 

## Para criar uma trace-to-logs correlação
<a name="observability-correlations-create"></a>

Conclua as etapas a seguir para criar uma correlação entre um conjunto de dados de rastreamentos e um conjunto de dados de registros.

1. **Em seu espaço de trabalho de observabilidade, expanda **Discover** no painel de navegação à esquerda e escolha Traços.**

1. Selecione o conjunto de dados de rastreamentos que você deseja correlacionar.

1. Escolha a guia **Correlações** no painel de configuração do conjunto de dados.  
![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/opensearch-service/latest/developerguide/images/datasets/correlations-trace-dataset-tab.png)

1. Escolha **Criar correlação**.

1. Na caixa de diálogo de configuração, selecione o conjunto de dados de registros de destino e mapeie os campos de correlação necessários (ID de rastreamento e registro de data e hora). Opcionalmente, mapeie o ID do período e o nome do serviço para obter uma correspondência mais precisa.  
![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/opensearch-service/latest/developerguide/images/datasets/correlations-configure-dialog.png)

1. Escolha **Criar** para salvar a correlação.

1. Verifique se a correlação aparece na tabela de correlações.  
![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/opensearch-service/latest/developerguide/images/datasets/correlations-created-table.png)

## Visualização de correlações em conjuntos de dados de registros
<a name="observability-correlations-view-logs"></a>

Depois de criar uma correlação, você também pode visualizá-la do lado do conjunto de dados de registros. Navegue até a página Descobrir registros, selecione o conjunto de dados de registros correlacionados e escolha a guia **Correlações** para ver o conjunto de dados de rastreamentos vinculados.

![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/opensearch-service/latest/developerguide/images/datasets/correlations-logs-dataset-tab.png)


## Usando correlações na página Traces
<a name="observability-correlations-use-traces"></a>

Quando existe uma correlação, a página Discover Traces exibe registros relacionados na visualização de detalhes do intervalo. Escolha um intervalo na tabela de intervalos para abrir o menu suspenso de detalhes e, em seguida, escolha a guia **Registros relacionados** para visualizar as entradas de registro correlacionadas.

![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/opensearch-service/latest/developerguide/images/datasets/correlations-span-details-logs.png)


## Gerenciando correlações
<a name="observability-correlations-manage"></a>

Você pode editar ou remover correlações da guia **Correlações** do conjunto de dados de rastreamentos ou registros.
+ **Edição** — Escolha a correlação na tabela e escolha **Editar** para atualizar os mapeamentos de campo ou o conjunto de dados de destino.
+ **Removendo** — Escolha a correlação na tabela e escolha **Excluir** para remover a correlação. A remoção de uma correlação não exclui nenhum dado.