搭配相關遙測使用 CloudWatch 代理程式 - Amazon CloudWatch

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

搭配相關遙測使用 CloudWatch 代理程式

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

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

服務名稱

代理程式會依優先順序從下列選項中選擇服務名稱：

  • Application Signals 檢測：代理程式會傳送 Application Signals 使用的服務名稱。可以變更受支援 OpenTelemetry 檢測程式庫使用的 OTEL_SERVICE_NAME 環境變數，以覆寫此選項。

  • CloudWatch 代理程式組態：您可以設定代理程式以使用特定服務名稱。可在代理程式、外掛程式、指標、日誌或日誌檔案層級設定此選項。

  • Kubernetes 工作負載名稱：對於 Kubernetes 工作負載，代理程式會依下列優先順序傳送對應 Pod 之工作負載的名稱。

    • 部署名稱

    • ReplicaSet 名稱

    • StatefulSet 名稱

    • DaemonSet 名稱

    • CronJob 名稱

    • 任務名稱

    • Pod 名稱

    • 容器名稱

  • 來自執行個體中繼資料的資源標籤：對於 Amazon EC2 工作負載，代理程式會依下列順序從標籤傳送名稱。

    • 服務

    • 應用程式

    • app

    您必須設定執行個體中繼資料，代理程式才能存取標籤。

  • 預設：如果找不到其他服務名稱，代理程式會傳送名稱 Unknown。

環境名稱

代理程式會依優先順序從下列選項中選擇環境名稱：

  • Application Signals 檢測：代理程式會傳送 Application Signals 使用的環境名稱。可以設定受支援 OpenTelemetry 檢測程式庫使用的 deployment.environment 環境變數，以覆寫此選項。例如，應用程式可設定環境變數 OTEL_RESOURCE_ATTRIBUTES=deployment.environment=MyEnvironment。

  • CloudWatch 代理程式組態：您可以設定代理程式以使用特定環境名稱。可在代理程式、外掛程式、指標、日誌或日誌檔案層級設定此選項。

  • 叢集名稱和工作空間：對於 Amazon EKS，eks:cluster-name/Namespace。對於在 Amazon EC2 上執行的原生 Kubernetes，k8s:cluster-name/Namespace。

  • 來自執行個體中繼資料的資源標籤：對於 Amazon EC2 工作負載，代理程式可以使用 AutoScalingGroup 標籤。

    您必須設定執行個體中繼資料，代理程式才能存取標籤。

  • 根據預設，未執行 Kubernetes 的 Amazon EC2 執行個體會取得環境名稱 ec2:default。