Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# 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 générer des métriques dans Amazon EKS, telles que Kubernetes ou des métriques au niveau des nœuds, vous pouvez utiliser les modules complémentaires de la communauté Amazon EKS. Pour plus d'informations, consultez la section [Extensions communautaires disponibles](https://docs.aws.amazon.com/eks/latest/userguide/community-addons.html#_available_community_add_ons) dans le *guide de l'utilisateur Amazon EKS*.
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](AMP-ingest-methods.md).
**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. Vous pouvez ajuster la période de rétention en configurant votre espace de travail jusqu'à un maximum de 1 095 jours (trois ans). Pour plus d'informations, consultez [Configurer votre espace de travail](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-workspace-configuration.html).
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](AMP-onboard-create-workspace.md). 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](https://docs.aws.amazon.com/eks/latest/userguide/ebs-csi.html) (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](https://helm.sh/docs/helm/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-namespace*Remplacez-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 AWS autorisations aux conteneurs de n'importe quel pod utilisant ce compte de service. Pour plus d’informations, consultez la section [Rôles IAM pour les comptes de service](https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts.html).
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](set-up-irsa.md#set-up-irsa-ingest) 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`](https://docs.aws.amazon.com/eks/latest/userguide/getting-started-eksctl.html).
**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.
+ *IAM\$1PROXY\$1PROMETHEUS\$1ROLE\$1ARN*Remplacez-le par l'ARN du **amp-iamproxy-ingest-role**que vous avez créé dans[Configuration de rôles de service pour l’ingestion de métriques à partir de clusters Amazon EKS](set-up-irsa.md#set-up-irsa-ingest).
+ *WORKSPACE\$1ID*Remplacez-le 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
```
1. Saisissez la commande suivante pour créer le serveur Prometheus.
+ Remplacez *prometheus-chart-name* par le nom de votre version de Prometheus.
+ *prometheus-agent-namespace*Remplacez-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
```