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 for PostgreSQL
Fichiers CSV Amazon S3
Moniteur Microsoft Azure
Prometheus
Plus avant dans cette section, vous trouverez des sous-sections contenant des remarques sur la gestion et l’interrogation de chacune de ces sources de données.
Pour créer un connecteur à une source de données
Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/
. -
Dans le panneau de navigation, sélectionnez Settings (Paramètres).
Choisissez l’onglet Sources de données de métriques.
Choisissez Create data source.
Sélectionnez la source de votre choix, puis choisissez Suivant.
Entrez un nom pour la source de données.
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.
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é.
Choisissez Je AWS CloudFormation reconnais pour créer des ressources IAM. Cette ressource est le rôle d’exécution de la fonction Lambda.
Choisissez Create data source.
La nouvelle source que vous venez d'ajouter n'apparaît pas tant que la AWS 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 plus d’informations, consultez Création d’un graphique de mesures à partir d’une autre source de données.
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) 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 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 <region>.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 esthttps://sample-domain.us-east-1.es.amazonaws.com
, le domaine racine seraitsample-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) 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. 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.
En outre, vous devez créer un point de terminaison VPC pour le service Amazon RDS. Pour plus d'informations, consultez l'API Amazon RDS et les points de terminaison AWS PrivateLink VPC d'interface ().
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.Pour mettre à jour la configuration du VPC, veuillez consulter Configuration de l’accès au VPC (console) 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 fichier CSV doit être formaté de la manière suivante :
L'horodatage doit être la première colonne.
Le tableau doit comporter une ligne d'en-tête. Les en-têtes sont utilisés pour nommer vos indicateurs. Le titre de la colonne d'horodatage sera ignoré, seuls les titres des colonnes de mesures 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 :
timestamp Processeur (%) Memory (%) (Mémoire (%)) Stockage (%) 2023-11-23T17:09:41+00:00
1
2
3
2023-11-23T17:04:41+00:00
4
5
6
2023-11-23T16:59:41+00:00
7
8
9
2023-11-23T16:54:41+00:00
10
11
12
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
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.
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. 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.
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.Pour mettre à jour la configuration du VPC, veuillez consulter Configuration de l’accès au VPC (console) 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
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()
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.