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 pour moi SQL
Amazon RDS pour Postgrer SQL
CSVFichiers Amazon S3
Moniteur Microsoft Azure
Prometheus
Les sous-sections de cette rubrique contiennent 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. Dans 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 unVPC, choisissez Utiliser a, VPC puis sélectionnez le VPC à utiliser. Sélectionnez ensuite le sous-réseau et le groupe de sécurité.
Choisissez Je reconnais que AWS CloudFormation créera des IAM ressources. 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 que lorsque AWS CloudFormation la pile est terminée en le créant. 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.
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_IDde la fonction Lambda du connecteur de source de données.Pour mettre à jour la VPC configuration, voir Configuration de VPC l'accès (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'action API sera rejetée avec une erreur d'analyse.
Amazon OpenSearch Service
Création d’une source de données
Si le OpenSearch domaine est activé pourFGAC, vous devez mapper le rôle d'exécution de la fonction Lambda du connecteur à un utilisateur dans OpenSearch Service. Pour plus d'informations, consultez la section Mappage des 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 cloud privé virtuel (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 est le cashttps://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_NAMEenvironnement de la fonction Lambda du connecteur de source de données.Pour mettre à jour la VPC configuration, voir Configuration de VPC l'accès (console) pour plus d'informations.
Interrogation de la source de données
Lorsque vous interrogez le OpenSearch service, après avoir sélectionné la source de données dans l'onglet Requête multisource, 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 pour Postgre SQL et Amazon RDS pour moi SQL
Création d’une source de données
Si votre source de données n'est accessible que dans unVPC, vous devez inclure la VPC configuration du connecteur, comme décrit dansConnexion à une source de données prédéfinie à l’aide d’un assistant. Si la source de données doit se connecter aux informations VPC d'identification, le point de terminaison doit être configuré dans leVPC. Pour plus d'informations, voir Utilisation d'un AWS Secrets Manager VPCpoint final.
En outre, vous devez créer un VPC point de terminaison pour le RDS service Amazon. Pour plus d'informations, consultez Amazon RDS API et les VPC points de terminaison d'interface (AWS PrivateLink).
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_INSTANCEde 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 à AmazonRDS, utilisez AWS Secrets Manager. Vous pouvez trouver le secret utilisé pour la source ARN de données dans la variable d'environnement de la
RDS_SECRETfonction 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 VPC configuration, voir Configuration de VPC l'accès (console) pour plus d'informations.
Interrogation de la source de données
Lorsque vous interrogez AmazonRDS, après avoir sélectionné la source de données dans l'onglet Requête multi-sources et sélectionné un RDS connecteur Amazon, 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'SQLéditeur pour créer une SQL requête.
Vous pouvez utiliser les variables suivantes dans la requête :
$start.iso— L'heure de début au format ISO date$end.iso— L'heure de fin au format ISO date$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.isoLes 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'action API sera rejetée 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
CSVFichiers Amazon S3
Interrogation de la source de données
Lorsque vous interrogez des CSV fichiers Amazon S3, après avoir sélectionné la source de données dans l'onglet Requête multi-sources et sélectionné un connecteur Amazon S3, vous sélectionnez le compartiment et la clé Amazon S3.
Le CSV fichier 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 ISO date.
Les métriques doivent être des champs numériques.
Timestamp, Metric-1, Metric-2, ...Voici un exemple :
timestamp CPU (%) Memory (%) (Mémoire (%)) Stockage (%) 2023-11-23T17:09:41+00:00
1
232023-11-23T17:04:41+00:00
4
562023-11-23T16:59:41+00:00
7
892023-11-23T16:54:41+00:00
10
1112
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, voir Création d'une application Microsoft Entra et d'un principal de service 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 rechercher le secret utilisé pour la source ARN de données en tant que variable d'
AZURE_CLIENT_SECRETenvironnement 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 unVPC, vous devez inclure la VPC configuration du connecteur, comme décrit dansConnexion à 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 leVPC. Pour plus d'informations, voir Utilisation d'un AWS Secrets Manager VPCpoint final.
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_ENDPOINTdans 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 ARN le secret utilisé pour la source de données comme variable d'environnement sur la fonction
PROMETHEUS_API_SECRETLambda 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 VPC configuration, voir Configuration de VPC l'accès (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'action API sera rejetée 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.
