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.
# Connexion à une source de données prédéfinie à l’aide d’un assistant
Cette rubrique fournit des instructions relatives à l'utilisation de l'assistant pour se connecter CloudWatch aux sources de données suivantes.
+ Amazon OpenSearch Service
+ Amazon Managed Service for Prometheus
+ Amazon RDS for MySQL
+ Amazon RDS pour PostgreSQL
+ Fichiers CSV Amazon S3
+ Moniteur Microsoft Azure
+ Prometheus
Les sous-sections de cette rubrique contiennent des précisions sur la gestion et l’interrogation de chacune de ces sources de données.
**Pour créer un connecteur à une source de données**
1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres).
1. Choisissez l’onglet **Sources de données de métriques**.
1. Choisissez **Create data source**.
1. Sélectionnez la source de votre choix, puis choisissez **Suivant**.
1. Entrez un nom pour la source de données.
1. Saisissez les autres informations requises, en fonction de la source de données que vous avez choisie. Cela peut inclure des informations d’identification pour accéder à la source de données et des informations d’identification de la source de données telles que le nom de l’espace de travail Prometheus, le nom de la base de données ou le nom du compartiment Amazon S3. Pour les AWS services, l'assistant découvre les ressources et les insère dans le menu déroulant de sélection.
Pour plus de remarques sur la source de données que vous utilisez, veuillez consulter les sections qui suivent cette procédure.
1. Pour vous CloudWatch connecter à la source de données dans un VPC, choisissez **Utiliser un VPC et sélectionnez le VPC** à utiliser. Sélectionnez ensuite le sous-réseau et le groupe de sécurité.
1. Choisissez **Je CloudFormation reconnais pour créer des ressources IAM**. Cette ressource est le rôle d’exécution de la fonction Lambda.
1. Choisissez **Create data source**.
La nouvelle source que vous venez d'ajouter n'apparaît pas tant que la CloudFormation pile n'a pas fini de la créer. Pour vérifier la progression, vous pouvez choisir **Afficher le statut de ma CloudFormation pile**. Vous pouvez également choisir l’icône d’actualisation pour mettre à jour cette liste.
Lorsque votre nouvelle source de données s’affiche dans cette liste, elle est prête à être utilisée. Vous pouvez choisir **Requête parmi CloudWatch les métriques** pour commencer à l'interroger. Pour de plus amples informations, veuillez consulter [Création d’un graphique de mesures à partir d’une autre source de données](graph_a_metric.md#create-metric-graph-multidatasource).
## Amazon Managed Service for Prometheus
**Mise à jour de la configuration de la source de données**
+ Vous pouvez mettre à jour votre source de données manuellement en procédant comme suit :
+ Pour mettre à jour l’ID d’espace de travail Amazon Managed Service for Prometheus, mettez à jour la variable d’environnement `AMAZON_PROMETHEUS_WORKSPACE_ID` de la fonction Lambda du connecteur de source de données.
+ Pour mettre à jour la configuration du VPC, veuillez consulter [Configuration de l’accès au VPC (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html#vpc-configuring) pour plus d’informations.
**Interrogation de la source de données**
+ Lorsque vous interrogez Amazon Managed Service for Prometheus, après avoir sélectionné la source de données dansl’onglet **Requête multisources** et sélectionné un connecteur Amazon Managed Service for Prometheus, vous pouvez utiliser l’**assistant aux requêtes** pour découvrir les métriques et les étiquettes et fournir des requêtes PromQL simples. Vous pouvez également utiliser l’éditeur de requêtes PromQL pour créer une requête PromQL.
+ Les requêtes multilignes ne sont pas prises en charge par les connecteurs de source de CloudWatch données. Chaque retour à la ligne est remplacé par un espace lorsque la requête est exécutée, ou lorsque vous créez une alarme ou un widget de tableau de bord avec la requête. Dans certains cas, cela peut rendre votre requête non valide. Par exemple, si votre requête contient un commentaire d’une seule ligne, elle ne sera pas valide. Si vous essayez de créer un tableau de bord ou une alarme à l’aide d’une requête multiligne à partir de la ligne de commande ou de l’infrastructure en tant que code, l’API rejettera l’action avec une erreur d’analyse.
## Amazon OpenSearch Service
**Création d’une source de données**
Si le OpenSearch domaine est activé pour le FGAC, vous devez mapper le rôle d'exécution de la fonction Lambda du connecteur à un utilisateur OpenSearch dans Service. Pour plus d'informations, consultez la section **Associer les utilisateurs aux rôles** dans la section [Gestion des autorisations](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/fgac.html#fgac-access-control) dans la documentation du OpenSearch service.
Si votre OpenSearch domaine n'est accessible que dans un Virtual Private Cloud (VPC), vous devez inclure manuellement une nouvelle variable d'environnement dans la fonction Lambda appelée. `AMAZON_OPENSEARCH_ENDPOINT` La valeur de cette variable doit être le domaine racine du OpenSearch point de terminaison. Vous pouvez obtenir ce domaine racine en supprimant `https://` et `.es.amazonaws.com` depuis le point de terminaison de domaine répertorié dans la console OpenSearch de service. Par exemple, si le point de terminaison de votre domaine est `https://sample-domain.us-east-1.es.amazonaws.com`, le domaine racine serait `sample-domain`.
**Mise à jour d’une source de données**
+ Vous pouvez mettre à jour votre source de données manuellement en procédant comme suit :
+ Pour mettre à jour le domaine OpenSearch de service, mettez à jour la variable d'`AMAZON_OPENSEARCH_DOMAIN_NAME`environnement de la fonction Lambda du connecteur de source de données.
+ Pour mettre à jour la configuration du VPC, veuillez consulter [Configuration de l’accès au VPC (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html#vpc-configuring) pour plus d’informations.
**Interrogation de la source de données**
+ Lorsque vous interrogez OpenSearch Service, après avoir sélectionné la source de données dans l'onglet **Requête multi-sources**, procédez comme suit :
+ Sélectionnez l’index à interroger.
+ Sélectionnez le nom de la métrique (n’importe quel champ numérique du document) et Stat.
+ Sélectionnez l’axe temporel (n’importe quel champ de date dans le document).
+ Sélectionnez les filtres à appliquer (n’importe quel champ de chaîne du document).
+ Choisissez **Requête graphique**.
## Amazon RDS for PostgreSQL et Amazon RDS for MySQL
**Création d’une source de données**
+ Si votre source de données n’est accessible que dans un VPC, vous devez inclure la configuration VPC du connecteur, comme décrit dans [Connexion à une source de données prédéfinie à l’aide d’un assistant](#CloudWatch_MultiDataSources-Connect). Si la source de données doit se connecter au VPC pour obtenir des informations d’identification, le point de terminaison doit être configuré dans le VPC. Pour plus d'informations, consultez la section [Utilisation d'un point de AWS Secrets Manager terminaison VPC.](https://docs.aws.amazon.com/secretsmanager/latest/userguide/vpc-endpoint-overview.html)
En outre, vous devez créer un point de terminaison d’un VPC pour le service Amazon RDS. Pour plus d’informations, consultez [API Amazon RDS et points de terminaison d’un VPC d’interface (AWS PrivateLink)](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/vpc-interface-endpoints.html).
**Mise à jour d’une source de données**
+ Vous pouvez mettre à jour votre source de données manuellement en procédant comme suit :
+ Pour mettre à jour l’instance de base de données, mettez à jour la variable d’environnement `RDS_INSTANCE` de la fonction Lambda du connecteur de source de données.
+ Pour mettre à jour le nom d’utilisateur et le mot de passe utilisés pour se connecter à Amazon RDS, utilisez AWS Secrets Manager. Vous pouvez trouver l’ARN du secret utilisé pour la source de données dans la variable d’environnement `RDS_SECRET` de la fonction Lambda de la source de données. Pour plus d’informations sur la mise à jour du secret dans AWS Secrets Manager, veuillez consulter la rubrique [Modifier un secret AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_update-secret.html).
+ Pour mettre à jour la configuration du VPC, veuillez consulter [Configuration de l’accès au VPC (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html#vpc-configuring) pour plus d’informations.
**Interrogation de la source de données**
+ Lorsque vous interrogez Amazon RDS, après avoir sélectionné la source de données dans l’onglet **Requête multisources** et sélectionné un connecteur Amazon RDS, vous pouvez utiliser le découvreur de base de données pour afficher les bases de données, les tables et les colonnes disponibles. Vous pouvez également utiliser l’éditeur SQL pour créer une requête SQL.
Vous pouvez utiliser les variables suivantes dans la requête :
+ `$start.iso` : l’heure de début au format de date ISO
+ `$end.iso` : l’heure de fin au format de date ISO
+ `$period` : la période sélectionnée en secondes
Par exemple, vous pouvez effectuer la requête `SELECT value, timestamp FROM table WHERE timestamp BETWEEN $start.iso and $end.iso`
+ Les requêtes multilignes ne sont pas prises en charge par les connecteurs de source de CloudWatch données. Chaque retour à la ligne est remplacé par un espace lorsque la requête est exécutée, ou lorsque vous créez une alarme ou un widget de tableau de bord avec la requête. Dans certains cas, cela peut rendre votre requête non valide. Par exemple, si votre requête contient un commentaire d’une seule ligne, elle ne sera pas valide. Si vous essayez de créer un tableau de bord ou une alarme à l’aide d’une requête multiligne à partir de la ligne de commande ou de l’infrastructure en tant que code, l’API rejettera l’action avec une erreur d’analyse.
**Note**
Si aucun champ de date n’est trouvé dans les résultats, les valeurs de chaque champ numérique sont additionnées en valeurs uniques et tracées sur l’intervalle de temps spécifié. Si les horodatages ne correspondent pas à la période sélectionnée dans CloudWatch, les données sont automatiquement agrégées en utilisant `SUM` et alignées sur la période en. CloudWatch
## Fichiers CSV Amazon S3
**Interrogation de la source de données**
+ Lorsque vous interrogez des fichiers CSV Amazon S3, après avoir sélectionné la source de données dans l’onglet **Requête multisources** et sélectionné un connecteur Amazon S3, vous sélectionnez le compartiment et la clé Amazon S3.
Le format du fichier CSV doit être le suivant :
+ L’horodatage doit être la première colonne.
+ La table doit comporter une ligne d’en-tête. Les en-têtes sont utilisées pour nommer vos statistiques. Le titre de la colonne d’horodatage sera ignoré, seuls les titres des colonnes de métriques sont utilisés.
+ Les horodatages doivent être au format de date ISO.
+ Les métriques doivent être des champs numériques.
```
Timestamp, Metric-1, Metric-2, ...
```
Voici un exemple :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonCloudWatch/latest/monitoring/CloudWatch_MultiDataSources-Connect.html)
**Note**
Si aucun horodatage n’est fourni, les valeurs de chaque métrique sont additionnées en valeurs uniques et tracées sur l’intervalle de temps spécifié. Si les horodatages ne correspondent pas à la période sélectionnée dans CloudWatch, les données sont automatiquement agrégées en utilisant `SUM` et alignées sur la période en. CloudWatch
## Moniteur Microsoft Azure
**Création d’une source de données**
+ Vous devez fournir votre ID client, et votre secret client pour vous connecter à Microsoft Azure Monitor. Les informations d'identification seront stockées dans AWS Secrets Manager. Pour plus d’informations, veuillez consulter la rubrique [Créer une application et un principal de service Microsoft Entra pouvant accéder aux ressources](https://learn.microsoft.com/en-us/entra/identity-platform/howto-create-service-principal-portal) de la documentation Microsoft.
**Mise à jour d’une source de données**
+ Vous pouvez mettre à jour votre source de données manuellement en procédant comme suit :
+ Pour mettre à jour l’ID du locataire, l’ID du client et le secret du client utilisés pour se connecter à Azure Monitor, vous pouvez trouver l’ARN du secret utilisé pour la source de données en tant que variable d’environnement `AZURE_CLIENT_SECRET` sur la fonction Lambda de la source de données. Pour plus d'informations sur la mise à jour du secret dans AWS Secrets Manager, voir [Modifier un AWS Secrets Manager secret](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_update-secret.html).
**Interrogation de la source de données**
+ Lorsque vous interrogez Azure Monitor, après avoir sélectionné la source de données dans l’onglet **Requête multisources** et sélectionné un connecteur Azure Monitor, vous spécifiez l’abonnement Azure, le groupe de ressources et la ressource. Vous pouvez ensuite sélectionner l’espace de noms, la métrique et l’agrégation des métriques, puis les filtrer par dimensions.
## Prometheus
**Création d’une source de données**
+ Vous devez fournir le point de terminaison Prometheus ainsi que l’utilisateur et le mot de passe requis pour interroger Prometheus. Les informations d'identification seront stockées dans AWS Secrets Manager.
+ Si votre source de données n’est accessible que dans un VPC, vous devez inclure la configuration VPC du connecteur, comme décrit dans [Connexion à une source de données prédéfinie à l’aide d’un assistant](#CloudWatch_MultiDataSources-Connect). Si la source de données doit se connecter pour obtenir des informations d’identification, le point de terminaison doit être configuré dans le VPC. Pour plus d'informations, consultez la section [Utilisation d'un point de AWS Secrets Manager terminaison VPC.](https://docs.aws.amazon.com/secretsmanager/latest/userguide/vpc-endpoint-overview.html)
**Mise à jour de la configuration de la source de données**
+ Vous pouvez mettre à jour votre source de données manuellement en procédant comme suit :
+ Pour mettre à jour le point de terminaison Prometheus, spécifiez le nouveau point de terminaison comme variable d’environnement `PROMETHEUS_API_ENDPOINT` dans la fonction Lambda de la source de données.
+ Pour mettre à jour le nom d’utilisateur et le mot de passe utilisés pour se connecter à Prometheus, vous pouvez trouver l’ARN du secret utilisé pour la source de données comme variable d’environnement `PROMETHEUS_API_SECRET` dans la fonction Lambda de la source de données. Pour plus d'informations sur la mise à jour du secret dans AWS Secrets Manager, voir [Modifier un AWS Secrets Manager secret](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_update-secret.html).
+ Pour mettre à jour la configuration du VPC, veuillez consulter [Configuration de l’accès au VPC (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html#vpc-configuring) pour plus d’informations.
**Interrogation de la source de données**
**Important**
Les types de métriques Prometheus sont différents des métriques et CloudWatch de nombreuses métriques disponibles via Prometheus sont cumulatives par conception. Lorsque vous interrogez les métriques de Prometheus CloudWatch , aucune transformation supplémentaire n'est appliquée aux données : si vous spécifiez uniquement le nom ou le libellé de la métrique, la valeur affichée sera cumulative. Pour plus d’informations, veuillez consulter la rubrique [Metric types](https://prometheus.io/docs/concepts/metric_types/) dans la documentation Prometheus.
Pour voir les données des métriques Prometheus sous forme de valeurs discrètes, CloudWatch comme les métriques, vous devez modifier la requête avant de l'exécuter. A titre d’exemple, vous pouvez avoir besoin d’ajouter un appel à la fonction rate sur le nom de votre métrique Prometheus. Pour de la documentation sur la fonction rate et les autres fonctions de Prometheus, veuillez consulter la rubrique [rate()](https://prometheus.io/docs/prometheus/latest/querying/functions/#rate) dans la documentation de Prometheus.
Les requêtes multilignes ne sont pas prises en charge par les connecteurs de source de CloudWatch données. Chaque retour à la ligne est remplacé par un espace lorsque la requête est exécutée, ou lorsque vous créez une alarme ou un widget de tableau de bord avec la requête. Dans certains cas, cela peut rendre votre requête non valide. Par exemple, si votre requête contient un commentaire d’une seule ligne, elle ne sera pas valide. Si vous essayez de créer un tableau de bord ou une alarme à l’aide d’une requête multiligne à partir de la ligne de commande ou de l’infrastructure en tant que code, l’API rejettera l’action avec une erreur d’analyse.
## Notification des mises à jour disponibles
De temps à autre, Amazon peut vous informer que nous vous recommandons de mettre à jour vos connecteurs avec une version plus récente disponible et vous fournira des instructions sur la manière de procéder.