

# Uso del agente de CloudWatch con la telemetría relacionada
<a name="CloudWatch-Agent-RelatedEntities"></a>

Las métricas y los registros que se envían a CloudWatch pueden incluir una entidad opcional para correlacionar la telemetría. Las entidades se utilizan en el panel [Explorar lo relacionado](ExploreRelated.md). El agente de CloudWatch envía las entidades con un nombre de servicio y un nombre de entorno incluidos.

El agente elige el nombre del servicio y el nombre del entorno entre los siguientes datos.

**Nombre del servicio**

El agente elige el nombre del servicio entre las siguientes opciones, en orden de prioridad:
+ **Instrumentación de Application Signals**: el agente envía el nombre del servicio utilizado por Application Signals. Esto se puede sobrescribir al cambiar la variable de entorno `OTEL_SERVICE_NAME` utilizada por las bibliotecas de instrumentación de OpenTelemetry admitidas.
+ **Configuración del agente de CloudWatch**: puede [configurar el agente](CloudWatch-Agent-configure-related-telemetry.md) para que utilice un nombre de servicio específico. Esto se puede configurar en el nivel del agente, del complemento, de las métricas, de los registros o del archivo de registro.
+ **Nombre de la carga de trabajo de Kubernetes**: en el caso de las cargas de trabajo de Kubernetes, el agente envía el nombre de la carga de trabajo del pod correspondiente, en el siguiente orden de prioridad.
  + Nombre de implementación
  + Nombre de ReplicaSet
  + Nombre de StatefulSet
  + Nombre de DaemOnset
  + Nombre de CronJob
  + Nombre del trabajo
  + Nombre de pod
  + Nombre de contenedor
+ **Etiquetas de recursos de los metadatos de la instancia**: en el caso de las cargas de trabajo de Amazon EC2, el agente envía el nombre a partir de las etiquetas, en el siguiente orden.
  + servicio
  + aplicación
  + aplicación

  Debe [configurar los metadatos de la instancia](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-tags-in-IMDS.html#allow-access-to-tags-in-IMDS) para que el agente pueda acceder a las etiquetas.
+ **Predeterminado**: si no se encuentra ningún otro nombre de servicio, el agente enviará el nombre `Unknown`.

**Nombre del entorno**

El agente elige el nombre del entorno entre las siguientes opciones, en orden de prioridad:
+ **Instrumentación de Application Signals**: el agente envía el nombre del entorno utilizado por Application Signals. Esto se puede sobrescribir al establecer una variable de entorno `deployment.environment` utilizada por las bibliotecas de instrumentación de OpenTelemetry admitidas. Por ejemplo, las aplicaciones pueden establecer la variable de entorno `OTEL_RESOURCE_ATTRIBUTES=deployment.environment=MyEnvironment`.
+ **Configuración del agente de CloudWatch**: puede [configurar el agente](CloudWatch-Agent-configure-related-telemetry.md) para que utilice un nombre de entorno específico. Esto se puede configurar en el nivel del agente, del complemento, de las métricas, de los registros o del archivo de registro.
+ **Nombre y espacio de trabajo del clúster**: para Amazon EKS, `eks:{{cluster-name}}/{{Namespace}}`. Para Kubernetes nativo que se ejecuta en Amazon EC2, `k8s:{{cluster-name}}/{{Namespace}}`.
+ **Etiquetas de recursos de los metadatos de la instancia**: en el caso de las cargas de trabajo de Amazon EC2, el agente puede utilizar la etiqueta `AutoScalingGroup`.

  Debe [configurar los metadatos de la instancia](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-tags-in-IMDS.html#allow-access-to-tags-in-IMDS) para que el agente pueda acceder a las etiquetas.
+ De forma predeterminada, las instancias de Amazon EC2 que no ejecutan Kubernetes recibirán el nombre de entorno `ec2:default`.