更新至必要版本的代理程式或 Amazon EKS 附加元件 - Amazon CloudWatch
更新 Amazon CloudWatch 可觀測性 EKS 附加元件更新 CloudWatch 代理程式和 ADOT 代理程式

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

更新至必要版本的代理程式或 Amazon EKS 附加元件

2024 年 8 月 9 日之後，CloudWatch Application Signals 將不再支援舊版的 Amazon CloudWatch 可觀測性 EKS 附加元件、CloudWatch 代理程式和 AWS Distro for OpenTelemetry 自動檢測代理程式。

  • 對於 Amazon CloudWatch 可觀測性 EKS 附加元件，v1.7.0-eksbuild.1不支援早於 的版本。

  • 對於 CloudWatch 代理程式，不支援早於 1.300040.0 的版本。

  • 對於 AWS Distro for OpenTelemetry 自動檢測代理程式：

    • 對於 Java，不支援早於 1.32.2 的版本。

    • 對於 Python，不支援早於 0.2.0 的版本。

    • 對於 .NET，1.3.2不支援早於 的版本。

    • 對於 Node.js，0.3.0不支援早於 的版本。

重要

最新版的代理程式包含 Application Signals 指標結構描述的更新。這些更新無法回溯相容，如果使用不相容的版本，可能會導致資料問題。若要協助確保無縫轉換至新功能，請執行下列動作：

  • 如果您的應用程式在 Amazon EKS 上執行，請務必在更新 Amazon CloudWatch Observability 附加元件後重新啟動所有檢測的應用程式。

  • 對於在其他平台上執行的應用程式，請務必將 CloudWatch 代理程式和 AWS OpenTelemetry 自動檢測代理程式升級至最新版本。

以下各節中的指示可協助您更新到支援的版本。

更新 Amazon CloudWatch 可觀測性 EKS 附加元件

前往 Amazon CloudWatch 可觀測性 EKS 附加元件，您可以使用 AWS Management Console 或 AWS CLI。

使用主控台

使用主控台升級附加元件

  1. 在以下網址開啟 Amazon EKS 主控台：https://console.aws.amazon.com/eks/home#/clusters。

  2. 選擇要更新的 Amazon EKS 叢集名稱。

  3. 選擇附加元件索引標籤，然後選擇 Amazon CloudWatch 可觀測性。

  4. 選擇編輯，選取您要更新的版本，然後選擇儲存變更。

    請務必選擇 v1.7.0-eksbuild.1 或更新版本。

  5. 輸入下列其中一個 AWS CLI 命令以重新啟動您的 服務。

      # Restart a deployment
  kubectl rollout restart deployment/name
  # Restart a daemonset
  kubectl rollout restart daemonset/name
  # Restart a statefulset
  kubectl rollout restart statefulset/name

使用 AWS CLI

使用 升級附加元件 AWS CLI

  1. 輸入下列命令以尋找最新版本。

    aws eks describe-addon-versions \
--addon-name amazon-cloudwatch-observability

  2. 輸入下列命令以更新附加元件。將 $VERSION 取代為 v1.7.0-eksbuild.1或更新版本。將 $AWS_REGION 和 $CLUSTER 取代為您的區域和叢集名稱。

    aws eks update-addon \
--region $AWS_REGION \
--cluster-name $CLUSTER \
--addon-name amazon-cloudwatch-observability \
--addon-version $VERSION \
# required only if the advanced configuration is used.
--configuration-values $JSON_CONFIG
    注意

    如果您使用 附加元件的自訂組態，您可以在 中找到用於 $JSON_CONFIG 的組態範例啟用 CloudWatch Application Signals。

  3. 輸入下列其中一個 AWS CLI 命令以重新啟動您的 服務。

      # Restart a deployment
  kubectl rollout restart deployment/name
  # Restart a daemonset
  kubectl rollout restart daemonset/name
  # Restart a statefulset
  kubectl rollout restart statefulset/name

更新 CloudWatch 代理程式和 ADOT 代理程式

如果您的服務在 Amazon EKS 以外的架構上執行，您將需要升級 CloudWatch 代理程式和 ADOT 自動檢測代理程式，才能使用最新的 Application Signals 功能。

Amazon ECS 上的更新

升級在 Amazon ECS 上執行之服務的代理程式

  1. 建立新的任務定義修訂。如需詳細資訊，請參閱使用主控台更新任務定義。

  2. 將ecs-cwagent容器$IMAGE的 取代為 Amazon ECR 上 cloudwatch-agent 的最新映像標籤。

    如果您升級至固定版本，請務必使用等於或大於 的版本1.300040.0。

  3. 將init容器$IMAGE的 取代為來自下列位置的最新映像標籤：

  4. 遵循 中的指示，更新應用程式容器中的 Application Signals 環境變數步驟 4：使用 CloudWatch 代理程式檢測您的應用程式。

  5. 使用新的任務定義部署您的服務。

Amazon EC2 或其他架構的更新

升級在 Amazon EC2 或其他架構上執行之服務的代理程式

  1. 請遵循 中的指示，並將 CloudWatch 代理程式下載 CloudWatch 代理程式套件升級至最新版本。請務必選取版本 1.300040.0 或更新版本。

  2. 從下列其中一個位置下載最新版本的 AWS Distro for OpenTelemetry 自動檢測代理程式：

  3. 將更新的 Application Signals 環境變數套用至您的應用程式，然後啟動您的應用程式。如需詳細資訊，請參閱步驟 3：檢測您的應用程式並啟動它。