在亚马逊 EKS 或 Kubernetes 上部署 CloudWatch 代理和 X-Ray 守护程序 - Amazon CloudWatch
在亚马逊 EKS 或库贝内特上部署 X-Ray 守护程序
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在亚马逊 EKS 或 Kubernetes 上部署 CloudWatch 代理和 X-Ray 守护程序

这些主题介绍了如何在亚马逊 EKS 或 Kubernetes 上安装 X-Ray 守护程序和 CloudWatch 代理。

在亚马逊 EKS 或库贝内特上部署 X-Ray 守护程序

要在亚马逊 EKS 或 Kubernetes 上安装 CloudWatch 代理和 X-Ray 守护程序，您可以使用快速设置。

在亚马逊 EKS 或 Kubernetes 上安装 CloudWatch 代理和 X-Ray 守护程序

  1. 确保附加到 EC2 实例或 Kubernetes 工作线程节点的 IAM 角色具有CloudWatchAgentServerPolicy和AWSXRayDaemonWriteAccess附加的策略。

  2. 输入以下命令：

    curl https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/master/k8s-deployment-manifest-templates/deployment-mode/daemonset/cwagent-fluentd-xray/cwagent-fluentd-xray-quickstart.yaml | sed "s/{{cluster_name}}/cluster-name/;s/{{region_name}}/region/" | kubectl apply -f -

快速入门的用途

此部分介绍 CloudWatch 代理和 X-Ray 守护程序的快速设置。

  • 快速设置指定入站端口和协议。不必显式打开出站连接。

  • 快速设 X-Ray 通过kubectl apply -f命令与以下文件内容相关。 

    apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: xray-daemon
  namespace: amazon-cloudwatch
spec:
  selector:
    matchLabels:
      name: xray-daemon
  template:
    metadata:
      labels:
        name: xray-daemon
    spec:
      containers:
        - name: xray-daemon
          image: amazon/aws-xray-daemon:latest
          imagePullPolicy: Always
          ports:
            - containerPort: 2000
              hostPort: 2000
              protocol: UDP
          resources:
            limits:
              cpu:  100m
              memory: 256Mi
            requests:
              cpu: 50m
              memory: 50Mi
      terminationGracePeriodSeconds: 60

  • 快速设置使用 Docker 映像版本/标签 1.231221.0 或更高版本或最新版本更新 CloudWatch 代理。您可以在 https://hub.docker.com/r/amazon/cloudwatch-agent 上查找映像。

  • 为了使 X-Ray 软件开发工具包能够读取集群名称和区域信息，快速设置将使用 Docker 映像版本/标签 1.231221.0 或更高版本或最新版本更新 CloudWatch 代理。您可以在 https://hub.docker.com/r/amazon/cloudwatch-agent 上查找映像。

  • 为了使 X-Ray SDK 能够读取集群名称和区域信息，快速设置创建了一个包含以下内容的文件，然后使用kubectl apply -f命令。 

    ---
# create role binding for XRay SDK to read config map
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
name: container-insights-discovery-role
namespace: amazon-cloudwatch
rules:
- apiGroups:
- ""
resourceNames:
- cluster-info
resources:
- configmaps
verbs:
- get
 
---
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
name: service-users-cloudwatch-discovery-role-binding
namespace: amazon-cloudwatch
roleRef:
apiGroup: rbac.authorization.k8s.io
kind: Role
name: container-insights-discovery-role
subjects:
- apiGroup: rbac.authorization.k8s.io
kind: Group
                      
name: system:serviceaccounts

  • 快速设置会显示接收 X-Ray 指标的 CloudWatch 代理端口。默认端口为 UDP 25888。

    ports:
  - containerPort: 25888
    hostPort: 25888
    protocol: UDP

  • 快速设置将代理配置 JSON 与 X-Ray SDK 指标配置与以下 JSON 合并。

    {
  "logs": {
    "metrics_collected": {
      "emf": {}
    }
  }
}