新增 Prometheus 湊集目標的教學課程：Amazon EKS 和 Kubernetes 叢集上的 Redis OSS

設定範例 Redis OSS 工作負載的命名空間。

REDIS_NAMESPACE=redis-sample

如果您在具有 Fargate 啟動類型的叢集上執行 Redis OSS，則需要設定 Fargate 設定檔。若要設定描述檔，請輸入下列命令。將 MyCluster 取代為您的叢集名稱。

eksctl create fargateprofile --cluster MyCluster \
--namespace $REDIS_NAMESPACE --name $REDIS_NAMESPACE

輸入下列命令來安裝範例 Redis OSS 工作負載。

curl https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/k8s-deployment-manifest-templates/deployment-mode/service/cwagent-prometheus/sample_traffic/redis/redis-traffic-sample.yaml \
| sed "s/{{namespace}}/$REDIS_NAMESPACE/g" \
| kubectl apply -f -

安裝包含名為 的服務my-redis-metrics，可在連接埠 9121 上公開 Redis OSS Prometheus 指標。輸入下列命令以取得服務的詳細資訊：

kubectl describe service/my-redis-metrics  -n $REDIS_NAMESPACE

在結果的 Annotations 區段中，您會看到兩個符合 CloudWatch 代理程式 Prometheus 刮取組態的註釋，以便它可以自動探索工作負載：

prometheus.io/port: 9121
prometheus.io/scrape: true

相關的 Prometheus 湊集組態可以在 kubernetes-eks.yaml 或 kubernetes-k8s.yaml 的 - job_name: kubernetes-service-endpoints 區段找到。

輸入下列其中一個命令，以下載最新版本的 kubernetes-eks.yaml 或 kubernetes-k8s.yaml 檔案。對於具有 EC2 啟動類型的 Amazon EKS 叢集，請輸入此命令。

curl -O https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/k8s-deployment-manifest-templates/deployment-mode/service/cwagent-prometheus/prometheus-eks.yaml

對於具有 Fargate 啟動類型的 Amazon EKS 叢集，請輸入此命令。

curl -O https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/k8s-deployment-manifest-templates/deployment-mode/service/cwagent-prometheus/prometheus-eks-fargate.yaml

對於在 Amazon EC2 執行個體上執行的 Kubernetes 叢集，請輸入下列命令。

curl -O https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/k8s-deployment-manifest-templates/deployment-mode/service/cwagent-prometheus/prometheus-k8s.yaml

使用文字編輯器開啟檔案，然後找出 cwagentconfig.json 區段。新增下列子區段並儲存變更。請務必遵循現有的縮排模式。

{
  "source_labels": ["pod_name"],
  "label_matcher": "^redis-instance$",
  "dimensions": [["Namespace","ClusterName"]],
  "metric_selectors": [
    "^redis_net_(in|out)put_bytes_total$",
    "^redis_(expired|evicted)_keys_total$",
    "^redis_keyspace_(hits|misses)_total$",
    "^redis_memory_used_bytes$",
    "^redis_connected_clients$"
  ]
},
{
  "source_labels": ["pod_name"],
  "label_matcher": "^redis-instance$",
  "dimensions": [["Namespace","ClusterName","cmd"]],
  "metric_selectors": [
    "^redis_commands_total$"
  ]
},
{
  "source_labels": ["pod_name"],
  "label_matcher": "^redis-instance$",
  "dimensions": [["Namespace","ClusterName","db"]],
  "metric_selectors": [
    "^redis_db_keys$"
  ]
},

您新增的 區段會將 Redis OSS 指標放入 CloudWatch 代理程式允許清單。如需了解這些指標的清單，請參閱下列章節。

如果您已在此叢集中部署具有 Prometheus 支援的 CloudWatch 代理程式，則必須輸入下列命令來刪除它。

kubectl delete deployment cwagent-prometheus -n amazon-cloudwatch

輸入下列其中一個命令，以更新的組態來部署 CloudWatch 代理程式：將 MyCluster 和 region 取代為可比對設定的數值。

對於具有 EC2 啟動類型的 Amazon EKS 叢集，請輸入此命令。

kubectl apply -f prometheus-eks.yaml

對於具有 Fargate 啟動類型的 Amazon EKS 叢集，請輸入此命令。

cat prometheus-eks-fargate.yaml \
| sed "s/{{cluster_name}}/MyCluster/;s/{{region_name}}/region/" \
| kubectl apply -f -

對於 Kubernetes 叢集，請輸入此命令。

cat prometheus-k8s.yaml \
| sed "s/{{cluster_name}}/MyCluster/;s/{{region_name}}/region/" \
| kubectl apply -f -

建立環境變數，取代下面的數值，以符合您的部署。

DASHBOARD_NAME=your_cw_dashboard_name
REGION_NAME=your_metric_region_such_as_us-east-1
CLUSTER_NAME=your_k8s_cluster_name_here
NAMESPACE=your_redis_service_namespace_here

輸入下列命令建立儀表板。

curl https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/k8s-deployment-manifest-templates/deployment-mode/service/cwagent-prometheus/sample_cloudwatch_dashboards/redis/cw_dashboard_redis.json \
| sed "s/{{YOUR_AWS_REGION}}/${REGION_NAME}/g" \
| sed "s/{{YOUR_CLUSTER_NAME}}/${CLUSTER_NAME}/g" \
| sed "s/{{YOUR_NAMESPACE}}/${NAMESPACE}/g" \