在 Kubernetes 平台上启用 Application Signals

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

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

选择开始发现您的服务。

选中该复选框并选择开始发现您的服务。

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

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

创建用于向本地主机提供权限的 IAM 用户：

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

2. 依次选择用户、创建用户。

3. 在用户详情中，为用户名输入新 IAM 用户的名称。这是 AWS 的登录名，将用于对您的主机进行身份验证。然后选择下一个

4. 在设置权限页面的权限选项下，选择直接附加策略。

5. 从权限策略列表中，选择要添加到您的用户的 CloudWatchAgentServerPolicy 策略。然后选择下一步。

6. 在查看并创建页面上，确保您对用户名满意，并且 CloudWatchAgentServerPolicy 策略位于权限摘要中。

7. 选择 Create user。

创建和检索您的 AWS 访问密钥和秘密密钥：

1. 在 IAM 控制台的导航窗格中，选择用户，然后选择您在上一步中所创建用户的用户名。

2. 在用户的页面上，选择安全凭证选项卡。然后，在访问密钥部分，选择创建访问密钥。

3. 对于创建访问密钥步骤 1，选择命令行界面 (CLI)。

4. 对于创建访问密钥步骤 2，（可选）输入标记，然后选择下一步。

5. 对于创建访问密钥步骤 3，选择下载.csv 文件以保存包含您的 IAM 用户访问密钥和秘密访问密钥的 .csv 文件。您在后续步骤中需要此信息。

6. 选择完成。

通过输入以下命令，在本地主机中配置 AWS 凭证。将 ACCESS_KEY_ID 和 SECRET_ACCESS_ID 替换为您在上一步中下载的 .csv 文件中新生成的访问密钥和秘密访问密钥。默认情况下，凭证文件保存在 /home/user/.aws/credentials. 中

$ aws configure --profile AmazonCloudWatchAgent
AWS Access Key ID [None]: ACCESS_KEY_ID
AWS Secret Access Key [None]: SECRET_ACCESS_ID
Default region name [None]: MY_REGION
Default output format [None]: json

使用 Helm 图表编辑 CloudWatch 代理安装的自定义资源，以添加新创建的 AWS 凭证密钥。

kubectl edit amazoncloudwatchagent cloudwatch-agent -n amazon-cloudwatch

当您的文件编辑器处于打开状态时，通过将以下配置添加到部署顶部，将 AWS 凭证挂载到 CloudWatch 代理容器中。将路径 /home/user/.aws/credentials 替换为本地 AWS 凭证文件的位置。

apiVersion: cloudwatch.aws.amazon.com/v1alpha1
kind: AmazonCloudWatchAgent
metadata:
  name: cloudwatch-agent
  namespace: amazon-cloudwatch
spec:
  volumeMounts:
  - mountPath: /rootfs
    volumeMounts:
    - name: aws-credentials
      mountPath: /root/.aws
      readOnly: true
    volumes:
    - hostPath:
      path: /home/user/.aws/credentials
    name: aws-credentials
---

您有两种注释选项：

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

要注释单个工作负载，请输入以下命令之一。将 $WORKLOAD_TYPE 和 $WORKLOAD_NAME 替换为工作负载的值。

要注释命名空间中的所有工作负载，请输入以下命令之一。将 $NAMESPACE 替换为您的命名空间的名称。

如果命名空间同时包含 Java、Python 和 .NET 工作负载，请将所有注释都添加到命名空间。

添加注释后，通过输入以下命令重新启动命名空间中的所有容器组（pod）：

kubectl rollout restart

完成上述步骤后，在 CloudWatch 控制台中，依次选择 Application Signals、服务。这将打开控制面板，您可以在其中查看 Application Signals 收集的数据。可能需要几分钟才会显示数据。

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

将相关依赖项安装到您的 Node.js 应用程序中以进行自动检测：

npm install @aws/aws-distro-opentelemetry-node-autoinstrumentation
npm install @opentelemetry/instrumentation@0.54.0

将以下环境变量添加到应用程序的 Dockerfile 中并构建映像。

...
ENV OTEL_AWS_APPLICATION_SIGNALS_ENABLED=true
ENV OTEL_TRACES_SAMPLER_ARG='endpoint=http://cloudwatch-agent.amazon-cloudwatch:2000'
ENV OTEL_TRACES_SAMPLER='xray'
ENV OTEL_EXPORTER_OTLP_PROTOCOL='http/protobuf'
ENV OTEL_EXPORTER_OTLP_TRACES_ENDPOINT='http://cloudwatch-agent.amazon-cloudwatch:4316/v1/traces'
ENV OTEL_AWS_APPLICATION_SIGNALS_EXPORTER_ENDPOINT='http://cloudwatch-agent.amazon-cloudwatch:4316/v1/metrics'
ENV OTEL_METRICS_EXPORTER='none'
ENV OTEL_LOGS_EXPORTER='none'
ENV NODE_OPTIONS='--import @aws/aws-distro-opentelemetry-node-autoinstrumentation/register --experimental-loader=@opentelemetry/instrumentation/hook.mjs'
ENV OTEL_SERVICE_NAME='YOUR_SERVICE_NAME' #replace with a proper service name
ENV OTEL_PROPAGATORS='tracecontext,baggage,b3,xray'
...

# command to start the application
# for example
# CMD ["node", "index.mjs"]

将环境变量 OTEL_RESOURCE_ATTRIBUTES_POD_NAME、OTEL_RESOURCE_ATTRIBUTES_NODE_NAME、OTEL_RESOURCE_ATTRIBUTES_DEPLOYMENT_NAME、POD_NAMESPACE 和 OTEL_RESOURCE_ATTRIBUTES 添加到应用程序的部署 yaml 文件中。例如：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nodejs-app
  labels:
    app: nodejs-app
spec:
  replicas: 2
  selector:
    matchLabels:
      app: nodejs-app
  template:
    metadata:
      labels:
        app: nodejs-app
      # annotations:
      # make sure this annotation doesn't exit
      #   instrumentation.opentelemetry.io/inject-nodejs: 'true'
    spec:
      containers:
      - name: nodejs-app
        image:your-nodejs-application-image #replace it with a proper image uri
        imagePullPolicy: Always
        ports:
        - containerPort: 8000
        env:
          - name: OTEL_RESOURCE_ATTRIBUTES_POD_NAME
            valueFrom:
              fieldRef:
                fieldPath: metadata.name
          - name: OTEL_RESOURCE_ATTRIBUTES_NODE_NAME
            valueFrom:
              fieldRef:
                fieldPath: spec.nodeName
          - name: OTEL_RESOURCE_ATTRIBUTES_DEPLOYMENT_NAME
            valueFrom:
              fieldRef:
                fieldPath: metadata.labels['app'] # Assuming 'app' label is set to the deployment name
          - name: POD_NAMESPACE
            valueFrom:
              fieldRef:
                fieldPath: metadata.namespace
          - name: OTEL_RESOURCE_ATTRIBUTES
            value: "k8s.deployment.name=$(OTEL_RESOURCE_ATTRIBUTES_DEPLOYMENT_NAME),k8s.namespace.name=$(POD_NAMESPACE),k8s.node.name=$(OTEL_RESOURCE_ATTRIBUTES_NODE_NAME),k8s.pod.name=$(OTEL_RESOURCE_ATTRIBUTES_POD_NAME)"

将 Node.js 应用程序部署到 Kubernetes 集群。