在 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

編輯透過 Helm Chart 安裝的 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 叢集。