本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 搭配相關遙測使用 CloudWatch 代理程式
<a name="CloudWatch-Agent-RelatedEntities"></a>

傳送至 CloudWatch 的指標和日誌可以包含選用實體，用於關聯遙測。實體在[探索相關](ExploreRelated.md)窗格中使用。CloudWatch 代理程式會傳送包含服務名稱與環境名稱的實體。

代理程式會從下列資料中選擇服務名稱和環境名稱。

**服務名稱**

代理程式會依優先順序從下列選項中選擇服務名稱：
+ **Application Signals 檢測**：代理程式會傳送 Application Signals 使用的服務名稱。可以變更受支援 OpenTelemetry 檢測程式庫使用的 `OTEL_SERVICE_NAME` 環境變數，以覆寫此選項。
+ **CloudWatch 代理程式組態**：您可以[設定代理程式](CloudWatch-Agent-configure-related-telemetry.md)以使用特定服務名稱。可在代理程式、外掛程式、指標、日誌或日誌檔案層級設定此選項。
+ **Kubernetes 工作負載名稱**：對於 Kubernetes 工作負載，代理程式會依下列優先順序傳送對應 Pod 之工作負載的名稱。
  + 部署名稱
  + ReplicaSet 名稱
  + StatefulSet 名稱
  + DaemonSet 名稱
  + CronJob 名稱
  + 任務名稱
  + Pod 名稱
  + 容器名稱
+ **來自執行個體中繼資料的資源標籤**：對於 Amazon EC2 工作負載，代理程式會依下列順序從標籤傳送名稱。
  + 服務
  + 應用程式
  + app

  您必須[設定執行個體中繼資料](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-tags-in-IMDS.html#allow-access-to-tags-in-IMDS)，代理程式才能存取標籤。
+ **預設**：如果找不到其他服務名稱，代理程式會傳送名稱 `Unknown`。

**環境名稱**

代理程式會依優先順序從下列選項中選擇環境名稱：
+ **Application Signals 檢測**：代理程式會傳送 Application Signals 使用的環境名稱。可以設定受支援 OpenTelemetry 檢測程式庫使用的 `deployment.environment` 環境變數，以覆寫此選項。例如，應用程式可設定環境變數 `OTEL_RESOURCE_ATTRIBUTES=deployment.environment=MyEnvironment`。
+ **CloudWatch 代理程式組態**：您可以[設定代理程式](CloudWatch-Agent-configure-related-telemetry.md)以使用特定環境名稱。可在代理程式、外掛程式、指標、日誌或日誌檔案層級設定此選項。
+ **叢集名稱和工作空間**：對於 Amazon EKS，`eks:cluster-name/Namespace`。對於在 Amazon EC2 上執行的原生 Kubernetes，`k8s:cluster-name/Namespace`。
+ **來自執行個體中繼資料的資源標籤**：對於 Amazon EC2 工作負載，代理程式可以使用 `AutoScalingGroup` 標籤。

  您必須[設定執行個體中繼資料](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-tags-in-IMDS.html#allow-access-to-tags-in-IMDS)，代理程式才能存取標籤。
+ 根據預設，未執行 Kubernetes 的 Amazon EC2 執行個體會取得環境名稱 `ec2:default`。