# Usar o agente do CloudWatch com a telemetria relacionada
<a name="CloudWatch-Agent-RelatedEntities"></a>

As métricas e os logs enviados ao CloudWatch podem incluir uma entidade opcional para correlacionar a telemetria. As entidades são usadas no painel [Analisar dados relacionados](ExploreRelated.md). O agente do CloudWatch envia entidades com um nome de serviço e um nome de ambiente incluídos.

O agente escolhe o nome do serviço e o nome do ambiente dos dados a seguir.

**Nome de serviço**

O agente escolhe o nome do serviço nas seguintes opções, em ordem de prioridade:
+ **Instrumentação do Application Signals**: o agente envia o nome do serviço usado pelo Application Signals. Isso pode ser sobrescrito alterando a variável `OTEL_SERVICE_NAME` de ambiente usada pelas bibliotecas de instrumentação compatíveis do OpenTelemetry.
+ **Configuração do agente do CloudWatch**: você pode [configurar o agente](CloudWatch-Agent-configure-related-telemetry.md) para usar um nome de serviço específico. Isso pode ser configurado no nível do agente, do plug-in, de métricas, logs ou de arquivo de logs.
+ **Nome da workload do Kubernetes**: em workloads do Kubernetes, o agente envia o nome da workload para o pod correspondente, na ordem de prioridade a seguir.
  + Nome da implantação
  + Nome de ReplicaSet
  + Nome de StatefulSet
  + Nome de DaemonSet
  + Nome de CronJob
  + Nome do trabalho
  + Nome do pod
  + Nome do contêiner
+ **Tags de recursos de metadados da instância**: para workloads do Amazon EC2, o agente envia um nome de tags, na ordem a seguir.
  + serviço
  + aplicação
  + aplicação

  Você deve [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 que o agente possa acessar as tags.
+ **Padrão**: se nenhum outro nome de serviço for encontrado, o agente enviará o nome `Unknown`.

**Nome do ambiente**

O agente escolhe o nome do ambiente entre as seguintes opções, em ordem de prioridade:
+ **Instrumentação do Application Signals**: o agente envia o nome do ambiente usado pelo Application Signals. Isso pode ser sobrescrito definindo uma variável `deployment.environment` de ambiente usada pelas bibliotecas de instrumentação compatíveis do OpenTelemetry. Por exemplo, as aplicações podem definir a variável `OTEL_RESOURCE_ATTRIBUTES=deployment.environment=MyEnvironment` de ambiente.
+ **Configuração do agente CloudWatch**: você pode [configurar o agente](CloudWatch-Agent-configure-related-telemetry.md) para usar um nome de ambiente específico. Isso pode ser configurado no nível do agente, do plug-in, de métricas, logs ou de arquivo de logs.
+ **Espaço de trabalho e nome do cluster**: para o Amazon EKS, `eks:{{cluster-name}}/{{Namespace}}`. Para o Kubernetes nativo em execução no Amazon EC2, `k8s:{{cluster-name}}/{{Namespace}}`.
+ **Tags de recursos dos metadados da instância**: para workloads do Amazon EC2, o agente pode usar a tag `AutoScalingGroup`.

  Você deve [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 que o agente possa acessar as tags.
+ Por padrão, as instâncias do Amazon EC2 que não estão executando o Kubernetes receberão o nome de ambiente `ec2:default`.