# Como o CloudWatch localiza a telemetria relacionada?
<a name="how-does-related-telemetry-work"></a>

O painel **Analisar dados relacionados** do CloudWatch mostra métricas e logs relacionados entre si. Mas como isso funciona?

As métricas e os logs enviados ao CloudWatch podem incluir uma *entidade* opcional à qual estão relacionados. Normalmente, a entidade será uma representação sobre o que é a telemetria. Por exemplo, uma métrica sobre o uso da CPU é sobre uma instância do Amazon EC2 e usará essa instância como sua entidade. Quando você visualiza essa métrica no painel **Analisar dados relacionados**, ele mostra outra telemetria para a mesma instância.

O *mapa de topologia* (mapa) no painel **Analisar dados relacionados** exibe o recurso atualmente selecionado, junto com os *recursos relacionados*. Em recursos da AWS, o CloudWatch exibe automaticamente outros recursos que ele sabe que estão relacionados. Por exemplo, se você estiver visualizando uma instância do Amazon EC2, o mapa também exibirá todos os volumes do Amazon EBS que estão anexados à instância. A seleção de um volume mostra a telemetria do volume, e o mapa é atualizado para exibir recursos relacionados ao volume. Ele também exibe recursos que fazem parte do mesmo *serviço*.

As informações da entidade associadas à telemetria definem o recurso ao qual a telemetria está associada, como a instância do Amazon EC2. No entanto, também pode incluir dados contextuais sobre o recurso. Por exemplo, se você tiver uma aplicação de site que inclua recursos como um banco de dados e uma instância do Amazon EC2, as informações da entidade poderão incluir a aplicação do site como um serviço. Nesse caso, o mapa de topologia mostra o serviço como uma entidade relacionada, e, quando você o seleciona, ele exibe as instâncias e o banco de dados. Isso pode simplificar a localização de toda a telemetria de um serviço.

**nota**  
O CloudWatch deve ter recebido telemetria com informações da entidade nas últimas três horas para poder localizar os recursos e a telemetria relacionados.

## Qual é a origem dos dados da entidade?
<a name="how-does-related-telemetry-work-entity"></a>

Há diferentes maneiras pelas quais o CloudWatch obtém entidades da telemetria:
+ A maior parte da telemetria enviada ao CloudWatch dos serviços da AWS está associada automaticamente aos recursos. Para obter uma lista completa de recursos compatíveis, consulte [Serviços da AWS compatíveis com a telemetria relacionada](services-with-related-telemetry.md).
+ O agente do CloudWatch adiciona automaticamente as informações da entidade à telemetria que ele envia para o CloudWatch.
**nota**  
Pode ser necessário atualizar o agente do CloudWatch para a versão mais recente para incluir os dados da entidade. Para ter mais informações, consulte [Coleta de métricas, logs e rastreamentos usando o agente do CloudWatch](Install-CloudWatch-Agent.md) e [Configurar nomes de serviços e ambientes do agente do CloudWatch para entidades relacionadas](CloudWatch-Agent-configure-related-telemetry.md).
+ Ao enviar sua própria telemetria, você pode adicionar informações da entidade aos dados. Para obter mais informações, consulte [Como adicionar informações relacionadas à telemetria personalizada enviada ao CloudWatch](adding-your-own-related-telemetry.md).
+ O CloudWatch se esforça ao máximo para reconhecer as informações da entidade associadas a outra telemetria (por exemplo, telemetria personalizada que você envia para o CloudWatch sem nenhuma informação da entidade).

## Qual a origem dos dados do serviço?
<a name="how-does-related-telemetry-work-service"></a>

Além de reconhecer as conexões naturais entre recursos, como um recurso de instância e um recurso de volume anexado, o CloudWatch também pode agrupar recursos por *serviço*. Por exemplo, um serviço pode ser uma aplicação de site. Uma instância do Amazon EC2 com um servidor Web e outra com um banco de dados podem fazer parte do mesmo serviço e estar conectadas no mapa de topologia com base nesse serviço.

Há diferentes maneiras pelas quais o CloudWatch obtém um nome de serviço de telemetria, incluindo:
+ Os sinais da aplicação ou a telemetria instrumentada pelo OTel usam a variável `OTEL_SERVICE_NAME` de ambiente usada pelas bibliotecas de instrumentação do OpenTelemetry compatíveis para definir o nome do serviço.
+ A configuração do agente do CloudWatch permite definir um nome de serviço. Para obter mais informações, consulte [Configurar nomes de serviços e ambientes do agente do CloudWatch para entidades relacionadas](CloudWatch-Agent-configure-related-telemetry.md).
+ As workloads do Kubernetes usam um nome correspondente do cluster, como Deployment, ReplicaSet, Pod ou Container, para o nome do serviço.
+ Para workloads do Amazon EC2, o serviço pode vir de tags (as tags `service`, `application` ou `app`).
**nota**  
Para usar tags para gerar nomes de serviços, você deve primeiro [configurar os metadados da instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-tags-in-IMDS.html#allow-access-to-tags-in-IMDS) para a instância do Amazon EC2.
+ Ao enviar sua própria telemetria, você pode adicionar informações do serviço aos dados. Para obter mais informações, consulte [Como adicionar informações relacionadas à telemetria personalizada enviada ao CloudWatch](adding-your-own-related-telemetry.md).
+ Quando não puder usar o especificado acima, o CloudWatch usará o nome do perfil do IAM que envia as métricas como nome do serviço. Isso, por exemplo, pode fornecer um nome de serviço para a telemetria do Amazon ECS.