Update and Cleanup for ADOT using EKS Add-Ons

Update the AWS Distro for OpenTelemetry (ADOT) Operator

Amazon EKS does not automatically update ADOT on your cluster. You must initiate the update and then Amazon EKS updates the Amazon EKS add-on for you.

To update the ADOT Amazon EKS add-on using the AWS CLI

1. Check the current version of your ADOT add-on. Replace my-cluster with your cluster name.

   Copy
   aws eks describe-addon --cluster-name my-cluster --addon-name adot --query "addon.addonVersion" --output text

2. Determine the ADOT versions are available that are supported by your cluster's version.

   Copy
   aws eks describe-addon-versions --addon-name adot --kubernetes-version 1.23 \
       --query "addons[].addonVersions[].[addonVersion, compatibilities[].defaultVersion]" --output text

   An example output is as follows.

   Copy
   v0.58.0-eksbuild.1
   True
   v0.56.0-eksbuild.2
   False

   The version with True underneath is the default version deployed when the add-on is created. The version deployed when the add-on is created might not be the latest available version. In the previous output, the latest version is deployed when the add-on is created.

3. Update the ADOT version. Replace my-cluster with the name of your cluster and v0.58.0-eksbuild.1 with the desired version. Optionally, the --configuration-values flag can be added to deploy an ADOT Collector during add-on installation. You may also configure other available values with this flag.

   Copy
   aws eks update-addon --cluster-name my-cluster --addon-name adot --addon-version v0.58.0-eksbuild.1 --resolve-conflicts PRESERVE --configuration-values my-configuration-values

   The PRESERVE option preserves any custom settings that you've set for the add-on. For more information about other options for this setting, see update-addon in the Amazon EKS Command Line Reference. For more information about Amazon EKS add-on configuration management, see Kubernetes field management.

Remove the AWS Distro for OpenTelemetry (ADOT) Operator

• You must delete the ADOT Collector resource separately from the ADOT Collector. In this command, specify the YAML file that you used to deploy the ADOT Collector:

  Copy
  kubectl delete -f collector-config-(amp|cloudwatch|xray|advanced).yaml

• You can remove the ADOT Operator through either the AWS CLI or eksctl. If you remove the ADOT Operator, you must follow the installation instructions again to reinstall:

  CLI

  Copy
  aws eks delete-addon --addon-name adot --cluster-name my-cluster

  eksctl

  Copy
  eksctl delete addon --cluster my-cluster --name adot

Uninstall cert-manager

Uninstall the cert-manager by following the instructions here.

Questions or bugs?

Technical documentation is available on the AWS Distro for OpenTelemetry developer site, and you can download the distribution from GitHub. You can also download the latest ADOT Collector image from the Amazon Elastic Container Registry (Amazon ECR) Public Gallery.

To learn more about how you can use ADOT to collect data for your observability solution, check out the hands-on AWS Observability workshop. If you have questions about the distribution, features, or components, file an issue.

Troubleshooting Guide

The troubleshooting guide can be found here.

Previous Topics:

Add-on Advanced Configuration

Collector Configuration Introduction

Next Topic: Return to the Beginning of the Guide