管理 Amazon Distro for OpenTelemetry Operator - Amazon EKS
安装 ADOT Operator更新 ADOT Operator删除 ADOT Operator
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

管理 Amazon Distro for OpenTelemetry Operator

Amazon Distro for OpenTelemetry (ADOT) Operator 作为 Amazon EKS 附加组件提供。安装 ADOT Operator 后，您可以将 ADOT 收集器配置为指定部署类型和接收应用程序指标或跟踪数据的服务。本主题介绍如何管理 ADOT 附加组件。

要安装 ADOT 收集器，请参阅 部署 Amazon Distro for OpenTelemetry 收集器。

安装 Amazon Distro for OpenTelemetry (ADOT) Operator

安装 ADOT 附加组件包括 ADOT Operator，该组件反过来会部署 ADOT 收集器。ADOT Operator 是一个自定义控制器，它通过 CustomResourceDefinition（CRD） 引入了一种名为 OpenTelemetryCollector 的新对象类型。当 ADOT Operator 检测到存在 OpenTelemetryCollector 资源时，将会安装 ADOT 收集器。

先决条件

Amazon Web Services Management Console

使用以下步骤将 ADOT Amazon EKS 附加组件安装到 Amazon EKS 集群中：

  1. 从以下位置打开 Amazon EKS 控制台：https://console.aws.amazon.com/eks/home#/clusters。

  2. 在左侧窗格中，选择 Clusters（集群），然后在 Clusters（集群）页面上选择集群的名称。

  3. 选择 Add-ons（附加组件）选项卡。

  4. 单击 Add new（新增），然后从下拉列表中选择 Amazon Distro for OpenTelemetry。

  5. 默认版本将在 Version（版本）下拉列表中选择。如果已在没有 IAM 角色的集群中创建服务账户，则单击 Override existing configuration for this add-on on the cluster（覆盖集群上此附加组件的现有配置）。

  6. 单击 Add (添加)。

Amazon CLI

  1. 使用命令将 ADOT Amazon EKS 附加组件安装到 Amazon EKS 集群中：

    aws eks create-addon --addon-name adot --cluster-name my-cluster

    在完成前，status 字段值将为 CREATING。

  2. 使用命令验证 ADOT 是否已安装并运行：

    aws eks describe-addon --addon-name adot --cluster-name my-cluster

    当创建完成时，您将看到 "status": "ACTIVE"。

更新 Amazon Distro for OpenTelemetry (ADOT) Operator

Amazon EKS 不会自动更新您的集群上的 ADOT。您必须启动更新，然后 Amazon EKS 会为您更新 Amazon EKS 附加组件。

使用 Amazon CLI 更新 ADOT Amazon EKS 附加组件

  1. 检查 ADOT 附加组件的当前版本。将 my-cluster 替换为您的集群名称。

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

  2. 确定集群版本支持的 ADOT 版本是否可用。

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

    输出示例如下。

    1.8.0
True
1.7.0
False

    下面带有 True 的版本是使用新集群部署的默认版本。如有必要，可以返回和更新以后的版本。

  3. 要更新 ADOT 版本，请使用以下命令并将 addon-version 值替换为所需版本。

    aws eks update-addon \
    --cluster-name my-cluster \
    --addon-name adot \
    --addon-version 1.8.0 \
    --resolve-conflicts OVERWRITE
注意

--resolve-conflicts OVERWRITE 选项将通过覆盖您的设置来解决与 Amazon EKS 附加组件设置的任何冲突。确保您的设置不需要管理。如果没有此选项，必须手动解决冲突。有关更多信息，请参阅Amazon EKS 附加组件配置。

删除 Amazon Distro for OpenTelemetry (ADOT) Operator

  • 您必须将 ADOT 收集器资源与 ADOT 收集器分开删除。在此命令中，指定用于部署 ADOT 收集器的 YAML 文件：

    kubectl delete -f collector-config.yaml

  • 您可以通过 Amazon CLI 或 eksctl 删除 ADOT Operator。如果删除 ADOT Operator，则必须再次遵循安装说明重新安装：

    CLI

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

    eksctl

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