Connexion à une source de données prédéfinie à l’aide d’un assistant - Amazon CloudWatch
Amazon Managed Service for Prometheus Amazon OpenSearch Service Amazon RDS for PostgreSQL et Amazon RDS for MySQL Fichiers CSV Amazon S3 Moniteur Microsoft Azure Prometheus Notification des mises à jour disponibles

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

  1. Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

  2. Dans le panneau de navigation, sélectionnez Settings (Paramètres).

  3. Choisissez l’onglet Sources de données de métriques.

  4. Choisissez Create data source.

  5. Sélectionnez la source de votre choix, puis choisissez Suivant.

  6. Entrez un nom pour la source de données.

  7. 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.

  8. 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é.

  9. Choisissez Je AWS CloudFormation reconnais pour créer des ressources IAM. Cette ressource est le rôle d’exécution de la fonction Lambda.

  10. 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_NAMEenvironnement 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

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

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

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 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() 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.