本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

湊集其他 Prometheus 來源並匯入這些指標

具有 Prometheus 監控的 CloudWatch 代理程式需要兩種組態來抓取 Prometheus 指標。其中一個是 Prometheus 文件的 <scrape_config> 中記錄的標準 Prometheus 湊集組態。另一個用於 CloudWatch 代理程式組態。

對於 Amazon EKS叢集，組態會在 prometheus-eks.yaml（針對EC2啟動類型） 或 prometheus-eks-fargate.yaml（針對 Fargate 啟動類型） 中定義為兩個組態映射：

對於在 Amazon EC2執行個體上執行的 Kubernetes 叢集，檔案中的組態會定義為prometheus-k8s.yamlYAML兩個組態映射：

若要抓取其他 Prometheus 指標來源，並將這些指標匯入 CloudWatch，您可以同時修改 Prometheus 抓取組態和 CloudWatch 代理程式組態，然後使用更新後的組態重新部署代理程式。

VPC 安全群組需求

Prometheus 工作負載安全群組的傳入規則必須開啟 CloudWatch 代理程式的 Prometheus 連接埠，以便透過私有 IP 來抓取 Prometheus 指標。

CloudWatch 代理程式安全群組的輸出規則必須允許 CloudWatch 代理程式透過私有 IP 連線至 Prometheus 工作負載的連接埠。

Prometheus 湊集組態

CloudWatch 代理程式支援標準 Prometheus 抓取組態，如 Prometheus 文件 <scrape_config> 中所記錄。您可以編輯此區段來更新已存在於此檔案中的組態，並新增其他 Prometheus 湊集目標。根據預設，範例組態檔案包含下列全域組態行：

global:
  scrape_interval: 1m
  scrape_timeout: 10s

您也可以在任務層級為這些設定定義不同的數值，以覆寫全域設定。

Prometheus 湊集任務

CloudWatch 客服人員YAML檔案已設定一些預設的抓取任務。例如，在 prometheus-eks.yaml 中，已在 scrape_configs 區段中的 job_name 行設定預設湊集任務。在此檔案中，下列預設kubernetes-pod-jmx區段會抓取JMX匯出工具指標。

   - job_name: 'kubernetes-pod-jmx'
      sample_limit: 10000
      metrics_path: /metrics
      kubernetes_sd_configs:
      - role: pod
      relabel_configs:
      - source_labels: [__address__]
        action: keep
        regex: '.*:9404$'
      - action: labelmap
        regex: __meta_kubernetes_pod_label_(.+)
      - action: replace
        source_labels:
        - __meta_kubernetes_namespace
        target_label: Namespace
      - source_labels: [__meta_kubernetes_pod_name]
        action: replace
        target_label: pod_name
      - action: replace
        source_labels:
        - __meta_kubernetes_pod_container_name
        target_label: container_name
      - action: replace
        source_labels:
        - __meta_kubernetes_pod_controller_name
        target_label: pod_controller_name
      - action: replace
        source_labels:
        - __meta_kubernetes_pod_controller_kind
        target_label: pod_controller_kind
      - action: replace
        source_labels:
        - __meta_kubernetes_pod_phase
        target_label: pod_phase

每個預設目標都會被抓取，而指標會使用內嵌指標格式 CloudWatch ，以日誌事件傳送至 。如需詳細資訊，請參閱在日誌中內嵌指標。

來自 Amazon EKS和 Kubernetes 叢集的日誌事件儲存在 /aws/containerinsights/ 中cluster_nameLogs 中的 /prometheus CloudWatch 日誌群組。來自 Amazon ECS叢集的日誌事件會儲存在 /aws/ecs/containerinsights/ 中cluster_name/prometheus 日誌群組。

每個湊集任務都包含在此日誌群組的不同日誌串流中。例如，Prometheus 湊集任務 kubernetes-pod-appmesh-envoy 是針對 App Mesh 所定義。所有來自 Amazon EKS和 Kubernetes 叢集的應用程式 Mesh Prometheus 指標都會傳送至名為 /aws/containerinsights/ 的日誌串流cluster_name>prometheus/kubernetes-pod-appmesh-envoy/。

若要新增抓取目標，您可以將新job_name區段新增至 YAML 檔案的 scrape_configs區段，然後重新啟動代理程式。如需此程序的範例，請參閱新增 Prometheus 抓取目標的教學課程：Prometheus API Server 指標。

CloudWatch Prometheus 的代理程式組態

CloudWatch 代理程式組態檔案在 下有一個prometheus區段metrics_collected，用於 Prometheus 抓取組態。其包含下列組態選項：

請參閱以下 metric_declaration 範例。

"metric_declaration": [
  {
     "source_labels":[ "Service", "Namespace"],
     "label_matcher":"(.*node-exporter.*|.*kube-dns.*);kube-system",
     "dimensions":[
        ["Service", "Namespace"]
     ],
     "metric_selectors":[
        "^coredns_dns_request_type_count_total$"
     ]
  }
]

此範例會在符合下列條件時，設定內嵌指標格式區段，以作為日誌事件傳送：

傳送的日誌事件包含下列反白顯示的區段：

{
   "CloudWatchMetrics":[
      {
         "Metrics":[
            {
               "Name":"coredns_dns_request_type_count_total"
            }
         ],
         "Dimensions":[
            [
               "Namespace",
               "Service"
            ]
         ],
         "Namespace":"ContainerInsights/Prometheus"
      }
   ],
   "Namespace":"kube-system",
   "Service":"kube-dns",
   "coredns_dns_request_type_count_total":2562,
   "eks_amazonaws_com_component":"kube-dns",
   "instance":"192.168.61.254:9153",
   "job":"kubernetes-service-endpoints",
   ...
}

新增 Prometheus 抓取目標的教學課程：Prometheus API Server 指標

Kubernetes API Server 預設會在端點上公開 Prometheus 指標。Kubernetes API Server 抓取組態的正式範例可在 Github 上取得。

下列教學課程示範如何執行下列步驟，開始將 Kubernetes API Server 指標匯入 CloudWatch：

完成此操作後，您應該會在 /aws/containerinsights/ 中看到名為 kubernetes-apiservers 的新日誌串流cluster_name/prometheus 日誌群組。此日誌串流應該包含具有內嵌指標格式定義的日誌事件，如下所示：

{
   "CloudWatchMetrics":[
      {
         "Metrics":[
            {
               "Name":"apiserver_request_total"
            }
         ],
         "Dimensions":[
            [
               "ClusterName",
               "Service"
            ]
         ],
         "Namespace":"ContainerInsights/Prometheus"
      }
   ],
   "ClusterName":"my-cluster-name",
   "Namespace":"default",
   "Service":"kubernetes",
   "Timestamp":"1592267020339",
   "Version":"0",
   "apiserver_request_count":0,
   "apiserver_request_total":0,
   "code":"0",
   "component":"apiserver",
   "contentType":"application/json",
   "instance":"192.0.2.0:443",
   "job":"kubernetes-apiservers",
   "prom_metric_type":"counter",
   "resource":"pods",
   "scope":"namespace",
   "verb":"WATCH",
   "version":"v1"
}

您可以在 ContainerInsights/Prometheus 命名空間的 CloudWatch 主控台中檢視指標。您也可以選擇性地為您的 Prometheus Kubernetes API Server 指標建立 CloudWatch 儀表板。

（選用） 為 Kubernetes API Server 指標建立儀表板

若要在儀表板中查看 Kubernetes API Server 指標，您必須先完成前幾節中的步驟，才能開始在 中收集這些指標 CloudWatch。