Intégration de métriques Prometheus dans l’espace de travail

L’un des moyens d’ingérer des métriques consiste à utiliser agent Prometheus autonome (une instance Prometheus exécutée en mode agent) pour extraire des métriques de votre cluster et les transmettre à Amazon Managed Service for Prometheus à des fins de stockage et de surveillance. Cette section explique comment configurer l’ingestion de métriques dans votre espace de travail Amazon Managed Service for Prometheus à partir d’Amazon EKS en configurant une nouvelle instance de l’agent Prometheus à l’aide de Helm.

Pour plus d’informations sur les autres méthodes d’ingestion de données dans Amazon Managed Service for Prometheus, notamment sur la manière de sécuriser les métriques et de créer des métriques haute disponibilité, consultez la section Ingérez les statistiques dans votre espace de travail Amazon Managed Service for Prometheus.

Note

Les métriques ingérées dans un espace de travail sont stockées pendant 150 jours par défaut, puis sont automatiquement supprimées. Cette longueur est un quota ajustable.

Les instructions de cette section vous permettent d’être rapidement opérationnel avec Amazon Managed Service for Prometheus. Cela suppose que vous avez déjà créé un espace de travail. Dans cette section, vous configurez un nouveau serveur Prometheus dans un cluster Amazon EKS, et le nouveau serveur utilise une configuration par défaut pour agir en tant qu'agent chargé d'envoyer des métriques à Amazon Managed Service for Prometheus. Voici les prérequis pour cette méthode :

• Vous devez disposer d'un cluster Amazon EKS à partir duquel le nouveau serveur Prometheus collectera les métriques.

• Un pilote Amazon EBS CSI doit être installé sur votre cluster Amazon EKS (requis par Helm).

• Vous devez utiliser Helm CLI 3.0 ou version ultérieure.

• Vous devez utiliser un ordinateur Linux ou macOS pour effectuer les étapes décrites dans les sections suivantes.

Étape 1 : Ajouter de nouveaux référentiels de Charts Helm

Pour ajouter de nouveaux référentiels de Charts de Helm, entrez les commandes suivantes. Pour plus d’informations sur l’utilisation de ces commandes, consultez la section Helm Repo.

helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo add kube-state-metrics https://kubernetes.github.io/kube-state-metrics
helm repo update

Étape 2 : Créer un espace de noms Prometheus

Entrez la commande suivante pour créer un espace de noms Prometheus pour le serveur Prometheus et les autres composants de surveillance. prometheus-agent-namespaceRemplacez-le par le nom que vous souhaitez pour cet espace de noms.

kubectl create namespace prometheus-agent-namespace

Étape 3 : Configurer des rôles IAM pour les comptes de service

Pour cette méthode d’ingestion, vous devez utiliser des rôles IAM pour les comptes de service du cluster Amazon EKS où l’agent Prometheus est exécuté.

Avec les rôles IAM pour les comptes de service, vous pouvez associer un rôle IAM à un compte de service Kubernetes. Ce compte de service peut ensuite fournir des autorisations AWS aux pods de n’importe quel pod qui utilise ce compte de service. Pour plus d’informations, consultez la section Rôles IAM pour les comptes de service.

Si vous n’avez pas encore configuré ces rôles, suivez les instructions de la section Configuration de rôles de service pour l'ingestion de métriques à partir de clusters Amazon EKS pour les configurer. Les instructions de cette section nécessitent l’utilisation de eksctl. Pour plus d’informations, consultez la section Démarrer avec Amazon Elastic Kubernetes Service – eksctl.

Note

Lorsque vous n'êtes pas sur EKS ou AWS que vous utilisez simplement une clé d'accès et une clé secrète pour accéder à Amazon Managed Service for Prometheus, vous ne pouvez pas utiliser EKS-IAM-ROLE le SigV4 basé.

Étape 4 : Configurer le nouveau serveur et commencer à ingérer des métriques

Pour installer le nouvel agent Prometheus et envoyer des métriques à votre espace de travail Amazon Managed Service for Prometheus, procédez comme suit.

Pour installer un nouvel agent Prometheus et envoyer des métriques à votre espace de travail Amazon Managed Service for Prometheus

1. À l’aide d’un éditeur de texte, créez un fichier nommé my_prometheus_values_yaml avec le contenu suivant.

   • Remplacez IAM_PROXY_PROMETHEUS_ROLE_ARN par l'ARN que vous avez créé dans. amp-iamproxy-ingest-roleConfiguration de rôles de service pour l'ingestion de métriques à partir de clusters Amazon EKS

   • Remplacez WORKSPACE_ID par l’ID de votre espace de travail Amazon Managed Service for Prometheus.

   • Remplacez REGION par la Région de votre espace de travail Amazon Managed Service for Prometheus.

   ## The following is a set of default values for prometheus server helm chart which enable remoteWrite to AMP
   ## For the rest of prometheus helm chart values see: https://github.com/prometheus-community/helm-charts/blob/main/charts/prometheus/values.yaml
   ##
   serviceAccounts:
     server:
       name: amp-iamproxy-ingest-service-account
       annotations: 
         eks.amazonaws.com/role-arn: ${IAM_PROXY_PROMETHEUS_ROLE_ARN}
   server:
     remoteWrite:
       - url: https://aps-workspaces.${REGION}.amazonaws.com/workspaces/${WORKSPACE_ID}/api/v1/remote_write
         sigv4:
           region: ${REGION}
         queue_config:
           max_samples_per_send: 1000
           max_shards: 200
           capacity: 2500

2. Saisissez la commande suivante pour créer le serveur Prometheus.

   • Remplacez-le prometheus-chart-namepar le nom de votre version de Prometheus.

   • prometheus-agent-namespaceRemplacez-le par le nom de votre espace de noms Prometheus.

   helm install prometheus-chart-name prometheus-community/prometheus -n prometheus-agent-namespace \
   -f my_prometheus_values_yaml