Didacticiel pour ajouter une nouvelle cible de récupération Prometheus : Redis OSS sur les clusters Amazon EKS et Kubernetes

Définissez l’espace de noms pour l’exemple de charge de travail Redis OSS.

REDIS_NAMESPACE=redis-sample

Si vous exécutez Redis OSS sur un cluster avec le type de lancement Fargate, vous devez configurer un profil Fargate. Pour configurer le profil, saisissez la commande suivante. Remplacez MyCluster par le nom de votre cluster.

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

Saisissez la commande suivante pour installer l’exemple de charge de travail 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 -

L’installation comprend un service nommé my-redis-metrics qui expose les métriques Redis OSS Prometheus sur le port 9121. Saisissez la commande suivante pour obtenir les détails du service :

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

Dans la section Annotations des résultats, vous verrez deux annotations correspondant à la configuration de récupération Prometheus de l'agent CloudWatch, afin qu'il puisse détecter automatiquement les applications :

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

La configuration de récupération Prometheus associée est disponible dans la section - job_name: kubernetes-service-endpoints de kubernetes-eks.yaml ou kubernetes-k8s.yaml.

Téléchargez la dernière version du fichier kubernetes-eks.yaml ou kubernetes-k8s.yaml en saisissant l'une des commandes suivantes. Pour un cluster Amazon EKS avec le type de lancement EC2, saisissez cette commande.

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

Pour un cluster Amazon EKS avec le type de lancement Fargate, saisissez cette commande.

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

Pour un cluster Kubernetes s'exécutant sur une instance Amazon EC2, saisissez cette commande :

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

Ouvrez le fichier avec un éditeur de texte et trouvez la section cwagentconfig.json. Ajoutez la sous-section suivante et enregistrez les modifications. Assurez-vous que l'indentation suive le modèle existant.

{
  "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$"
  ]
},

La section que vous avez ajoutée place les métriques Redis OSS dans la liste d’autorisations de l’agent CloudWatch. Pour une liste de ces métriques, reportez-vous à la section suivante.

Si vous avez déjà déployé l'agent CloudWatch avec prise en charge de Prometheus dans ce cluster, vous devez le supprimer en saisissant la commande suivante.

kubectl delete deployment cwagent-prometheus -n amazon-cloudwatch

Déployez l'agent CloudWatch avec votre configuration mise à jour en saisissant l'une des commandes suivantes : Remplacez MyCluster (MonCluster) et region (région) pour correspondre à vos paramètres.

Pour un cluster Amazon EKS avec le type de lancement EC2, saisissez cette commande.

kubectl apply -f prometheus-eks.yaml

Pour un cluster Amazon EKS avec le type de lancement Fargate, saisissez cette commande.

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

Pour un cluster Kubernetes, saisissez cette commande.

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

Créez des variables d'environnement, en remplaçant les valeurs ci-dessous pour correspondre à votre déploiement.

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

Saisissez la commande suivante pour créer le tableau de bord.

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" \