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.
Utiliser le langage naturel pour générer et mettre à jour CloudWatch les requêtes Metrics Insights
CloudWatch prend en charge une fonctionnalité de requête en langage naturel pour vous aider à générer et à mettre à jour des requêtes pour CloudWatch Metrics Insights et CloudWatch Logs Insights.
Grâce à cette fonctionnalité, vous pouvez poser des questions ou décrire les CloudWatch données que vous recherchez dans un langage simple. La fonctionnalité de langage naturel génère une requête en fonction d'une invite que vous entrez et fournit une line-by-line explication du fonctionnement de la requête. Vous pouvez également mettre à jour votre requête pour examiner plus en détail vos données.
En fonction de votre environnement, vous pouvez saisir des messages tels que « Which Amazon Elastic Compute Cloud instance has the highest network out? » et « Show me the top 10 Amazon DynamoDB Tables by consumed reads ».
Note
La fonctionnalité de requête en langage naturel est généralement disponible dans 10 régions. Pour certaines régions, la fonctionnalité effectue des appels interrégionaux vers des régions des États-Unis d'Amérique afin de traiter les demandes de renseignements. Le tableau suivant répertorie les régions prises en charge et indique où chaque région traite ses demandes.
Région prise en charge | Région dans laquelle l'invite est traitée |
---|---|
USA Est (Virginie du Nord) |
USA Est (Virginie du Nord) |
USA Est (Ohio) |
USA Est (Virginie du Nord) |
USA Ouest (Oregon) |
USA Ouest (Oregon) |
Asie-Pacifique (Hong Kong) |
US West (Oregon) |
Asie-Pacifique (Singapour) |
USA Ouest (Oregon) |
Asie-Pacifique (Sydney) |
USA Ouest (Oregon) |
Asie Pacifique (Tokyo) |
Asie-Pacifique (Tokyo) |
Europe (Francfort) |
Europe (Francfort) |
Europe (Irlande) |
USA Est (Virginie du Nord) |
Europe (Stockholm) |
USA Est (Virginie du Nord) |
Pour générer une requête CloudWatch Metrics Insights avec cette fonctionnalité, ouvrez l'éditeur de requêtes CloudWatch Metrics Insights dans la vue du générateur ou de l'éditeur et choisissez Generate query.
Important
Pour utiliser la fonctionnalité de requête en langage naturel, vous devez utiliser la CloudWatchFullAccessReadOnlyAccesspolitique, AdministratorAccess, CloudWatchFullAccessV2 ou. CloudWatchReadOnlyAccess
Vous pouvez également inclure l’action cloudwatch:GenerateQuery
dans une politique en ligne ou gérée par le client, qu’elle soit nouvelle ou existante.
Exemples de requêtes
Les exemples de cette section décrivent comment générer et mettre à jour des requêtes à l’aide de la fonctionnalité de langage naturel.
Note
Pour plus d'informations sur l'éditeur de requêtes et la syntaxe de CloudWatch CloudWatch Metrics Insights, voir Composants et syntaxe des requêtes Metrics Insights.
Exemple : générer une requête en langage naturel
Pour générer une requête en langage naturel, saisissez une invite et choisissez Générer une nouvelle requête. Cet exemple montre une requête qui effectue une recherche de base.
Invite
Voici un exemple d’invite qui indique à la fonctionnalité de rechercher les 10 tables DynamoDB les plus gourmandes en capacité de lecture.
Show top 10 DynamoDB Tables by consumed reads
Requête
Voici un exemple de requête générée par la fonctionnalité de langage naturel en fonction de l’invite. Remarquez comment l’invite apparaît dans un commentaire avant la requête. Après la requête, vous pouvez lire une explication qui décrit son fonctionnement.
# Show top 10 DynamoDB Tables by consumed reads SELECT SUM("ConsumedReadCapacityUnits") FROM "AWS/DynamoDB" GROUP BY TableName ORDER BY SUM() DESC LIMIT 10 # This query selects the sum of consumed read capacity units for each DynamoDB table, groups the results by table name, orders the results from highest to lowest read capacity consumption, and limits the results to the top 10 tables.
Note
Pour désactiver l’affichage de votre invite et de l’explication du fonctionnement de la requête, utilisez l’icône en forme de roue dentée dans votre éditeur.
Exemple : mettre à jour une requête en langage naturel
Vous pouvez mettre à jour une requête en modifiant l’invite initiale, puis en choisissant Mettre à jour la requête.
Invite mise à jour
L’exemple suivant présente une version mise à jour de la requête précédente. Au lieu d’une invite qui recherche les 10 principales tables DynamoDB consommant le plus de capacité de lecture, cette invite indique désormais la possibilité de trier les résultats en fonction du nombre d’octets renvoyés.
Sort by bytes returned instead
Requête mise à jour
Voici un exemple de la requête mise à jour. Remarquez comment l’invite mise à jour apparaît dans un commentaire avant la requête mise à jour. Après la requête, vous pouvez lire une explication qui décrit comment la requête d’origine a été mise à jour.
# Sort by bytes returned instead SELECT SUM("ReturnedBytes") FROM "AWS/DynamoDB" GROUP BY TableName ORDER BY SUM() DESC LIMIT 10 # This query modifies the original query to select the sum of returned bytes instead of consumed read capacity units, and orders the results from highest to lowest sum of returned bytes, limiting the results to the top 10 tables.
Refus d’utiliser vos données pour améliorer le service
Les données d’invite en langage naturel que vous fournissez pour entraîner le modèle d’IA et générer des requêtes pertinentes ne sont utilisées que pour fournir et maintenir votre service. Ces données peuvent être utilisées pour améliorer la qualité de CloudWatch Metrics Insights. Votre confiance, la confidentialité et la sécurité de votre contenu constituent nos priorités N° 1. Pour plus d’informations, veuillez consulter les rubriques Conditions de service AWS
Vous pouvez refuser que votre contenu soit utilisé pour développer ou améliorer la qualité des requêtes en langage naturel en créant une politique de désinscription des services d’IA. Pour désactiver la collecte de données pour toutes les fonctionnalités de l' CloudWatch IA, y compris la capacité de génération de requêtes, vous devez créer une politique de désinscription pour CloudWatch. Pour plus d’informations, veuillez consulter la rubrique Politiques de désactivation des services IA dans le Guide de l’utilisateur AWS Organizations .