使用您的服务在 Amazon EKS 集群上启用 Application Signals

为现有 Amazon EKS 集群上的应用程序启用 Application Signals

1. 通过 https://console.aws.amazon.com/cloudwatch/ 打开 CloudWatch 控制台。

2. 在导航窗格中，选择服务。

3. 如果您尚未在此账户中启用 Application Signals，则必须向 Application Signals 授予发现您的服务所需的权限。为此，请执行以下操作：您的账户只需执行一次该操作。

   1. 选择开始发现您的服务。

   2. 选中该复选框并选择开始发现服务。

      首次在您的账户中完成此步骤会创建 AWSServiceRoleForCloudWatchApplicationSignals 服务相关角色。此角色授予 Application Signals 以下权限：

      • xray:GetServiceGraph

      • logs:StartQuery

      • logs:GetQueryResults

      • cloudwatch:GetMetricData

      • cloudwatch:ListMetrics

      • tag:GetResources

      有关该角色的更多信息，请参阅 CloudWatch Application Signals 的服务相关角色权限。

4. 选择启用 Application Signals。

5. 在指定平台中，选择 EKS。

6. 在选择 EKS 集群中，选择要在其中启用 Application Signals 的集群。

7. 如果此集群尚未启用 Amazon CloudWatch Observability EKS 附加组件，则系统会提示您将其启用。在这种情况下，请执行以下操作：

   1. 选择添加 CloudWatch Observability EKS 附加组件。Amazon EKS 控制台出现。

   2. 选中 Amazon CloudWatch Observability 对应的复选框，然后选择下一步。

      CloudWatch Observability EKS 附加组件启用 Application Signals 和 CloudWatch Container Insights，从而增强 Amazon EKS 的可观测性。有关安装 Container Insights 的更多信息，请参阅 Container Insights。

   3. 选择要安装的最新版本的附加组件。

   4. 选择要用于附加组件的 IAM 角色。如果您选择从节点继承，请将正确的权限附加到您的 Worker 节点使用的 IAM 角色。将 my-worker-node-role 替换为您的 Kubernetes Worker 节点使用的 IAM 角色。

      aws iam attach-role-policy \
      --role-name my-worker-node-role \
      --policy-arn arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy \
      --policy-arn arn:aws:iam::aws:policy/AWSXRayWriteOnlyAccess

   5. 如果您想要创建服务角色以使用附加组件，请参阅 使用 Amazon CloudWatch Observability EKS 附加组件安装 CloudWatch 代理。

   6. 选择下一步，确认屏幕上的信息，然后选择创建。

   7. 在下一个屏幕中，选择启用 CloudWatch Application Signals 以返回 CloudWatch 控制台并完成该过程。

8. 有两个选项可以为您的应用程序启用 Application Signals。为保持一致性，建议您为每个集群选择一个选项。

   • 控制台选项更简单。使用此方法会导致您的容器组（pod）立即重启。

   • 注释清单文件方法可以让您更好地控制容器组（pod）何时重启；如果您不想集中监控，还可以帮助您以更分散的方式管理监控。

   Console

   控制台选项使用 Amazon CloudWatch Observability EKS 附加组件的高级配置，为您的服务设置 Application Signals。有关附加组件的更多信息，请参阅 （可选）其他配置。

   如果没有看到工作负载和命名空间列表，则请确保您拥有查看该集群工作负载和命名空间的适当权限。有关更多信息，请参阅所需权限。

   您可以监控单个工作负载或整个命名空间。

   要监控单个工作负载，请执行以下操作：

   1. 选中要监控的工作负载旁的复选框。

   2. 选择工作负载的语言。对于 Python 应用程序，请确保您的应用程序符合所需的先决条件，然后再继续。有关更多信息，请参阅 启用 Application Signals 后，Python 应用程序无法启动。

   3. 选择完成。Amazon CloudWatch Observability EKS 附加组件会立即将 Amazon Distro for OpenTelemetry 自动检测（ADOT）SDK 注入到您的容器组（pod）中，并触发容器组（pod）重启以允许收集应用程序指标和跟踪。

   要监控整个命名空间，请执行以下操作：

   1. 选中要监控的命名空间旁的复选框。

   2. 选择工作负载的语言。此操作将该语言应用到此命名空间中的所有工作负载，无论其当前已部署还是将在未来部署。对于 Python 应用程序，请确保您的应用程序符合所需的先决条件，然后再继续。有关更多信息，请参阅 启用 Application Signals 后，Python 应用程序无法启动。

   3. 选择完成。Amazon CloudWatch Observability EKS 附加组件会立即将 Amazon Distro for OpenTelemetry 自动检测（ADOT）SDK 注入到您的容器组（pod）中，并触发容器组（pod）重启以允许收集应用程序指标和跟踪。

   要在另一个 Amazon EKS 集群中启用 Application Signals，请从服务屏幕中选择启用 Application Signals。

   Annotate manifest file

   在 CloudWatch 控制台中，监控服务部分说明了您必须向集群中的清单 YAML 添加注释。添加此注释会自动检测应用程序以向 Application Signals 发送指标、跟踪和日志。

   您有两种注释选项：

   • 注释工作负载会自动检测集群中的单个工作负载。

   • 注释命名空间会自动检测所选命名空间中部署的所有工作负载。

   选择其中一个选项，然后按照相应的步骤操作：

   • 要为单个工作负载添加注释，请执行以下操作：

     1. 选择注释工作负载。

     2. 将以下行之一粘贴到工作负载清单文件的 PodTemplate 部分。

        • 对于 Java 工作负载：annotations: instrumentation.opentelemetry.io/inject-java: "true"

        • 对于 Python 工作负载：annotations: instrumentation.opentelemetry.io/inject-python: "true"

          对于 Python 应用程序，还需要额外的配置。有关更多信息，请参阅 启用 Application Signals 后，Python 应用程序无法启动。

     3. 在您的终端中，输入 kubectl apply -f your_deployment_yaml 以应用更改。

   • 要为命名空间中的所有工作负载添加注释，请执行以下操作：

     1. 选择注释命名空间。

     2. 将以下行之一粘贴到命名空间清单文件的元数据部分。如果命名空间同时包含 Java 和 Python 工作负载，则请将这两行都粘贴到命名空间清单文件中。

        • 如果命名空间中有 Java 工作负载：annotations: instrumentation.opentelemetry.io/inject-java: "true"

        • 如果命名空间中有 Python 工作负载：annotations: instrumentation.opentelemetry.io/inject-python: "true"

          对于 Python 应用程序，还需要额外的配置。有关更多信息，请参阅 启用 Application Signals 后，Python 应用程序无法启动。

     3. 在您的终端中，输入 kubectl apply -f your_namespace_yaml 以应用更改。

     4. 在您的终端中，输入命令以重启命名空间中的所有容器组（pod）。重启部署工作负载的命令示例是 kubectl rollout restart deployment -n namespace_name

9. 选择完成后查看服务。这将带您进入 Application Signals 服务视图，您可以在其中查看 Application Signals 正在收集的数据。可能需要几分钟才会显示数据。

   要在另一个 Amazon EKS 集群中启用 Application Signals，请从服务屏幕中选择启用 Application Signals。

   有关服务视图的更多信息，请参阅 使用 Application Signals 监控应用程序的运行状况。