在 Kubernetes 上啟用您的應用程式

建立用於提供許可給現場部署主機的 IAM 使用者：

1. 前往 https://console.aws.amazon.com/iam/ 開啟 IAM 主控台。

2. 選擇使用者、建立使用者。

3. 在使用者詳細資訊的使用者名稱中，輸入新 IAM 使用者的名稱。這是 的登入名稱 AWS ，將用於驗證您的主機。然後選擇 Next (下一步)

4. 在設定許可頁面的許可選項下，選取直接連接政策。

5. 從許可政策清單中，選取要新增至使用者的 CloudWatchAgentServerPolicy 政策。然後選擇下一步。

6. 在檢閱和建立頁面上，請確定您對使用者名稱感到滿意，且 CloudWatchAgentServerPolicy 政策位於許可摘要中。

7. 選擇建立使用者

建立和擷取您的 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

編輯 CloudWatch 代理程式使用 Helm Chart 安裝的自訂資源，以新增新建立的 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， Services。這會開啟儀表板，您可以在其中查看 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_DEPLOYMENT_NAME、 OTEL_RESOURCE_ATTRIBUTES_NODE_NAMEPOD_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 叢集。