Utiliser le langage naturel pour générer et mettre à jour CloudWatch les requêtes Logs Insights

Note

Cette fonctionnalité est généralement disponible dans l'est des États-Unis (Virginie du Nord), dans l'ouest des États-Unis (Oregon) et en Asie-Pacifique (Tokyo) pour les CloudWatch journaux.

CloudWatch Logs 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 Logs Insights et CloudWatch Metrics Insights.

Grâce à cette fonctionnalité, vous pouvez poser des questions ou décrire les données des CloudWatch journaux que vous recherchez dans un langage clair. 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 « Quelles sont les 100 principales adresses IP sources en octets transférés ? » et « Trouvez les 10 requêtes de fonction Lambda les plus lentes ».

Pour générer une requête CloudWatch Logs Insights avec cette fonctionnalité, ouvrez l'éditeur de requêtes CloudWatch Logs Insights, sélectionnez le groupe de journaux que vous souhaitez interroger, puis choisissez Generate query.

Important

Pour utiliser la fonctionnalité de requête en langage naturel, vous devez utiliser la ReadOnlyAccesspolitique CloudWatchLogsFullAccessCloudWatchLogsReadOnlyAccessAdministratorAccess,, ou.

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 Logs Insights, voir Syntaxe de requête CloudWatch Logs 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 appels de fonction Lambda les plus lents.

Find the 10 slowest requests

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.

# Find the 10 slowest requests
fields @timestamp, @message, @duration 
| sort @duration desc 
| limit 10
# This query retrieves the timestamp, message and duration fields from the logs and sorts them in descending order by duration to find the 10 slowest requests.

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 appels de fonction Lambda les plus lents, cette invite indique désormais à la fonctionnalité de rechercher les 20 appels de fonction Lambda les plus lents et d'inclure une autre colonne pour les événements de journal supplémentaires.

Show top 20 slowest requests instead and display requestId as a column

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.

# Show top 20 slowest requests instead and display requestId as a column
fields @timestamp, @message, @requestId, @duration 
| sort @duration desc 
| limit 20
# This query modifies the original query by replacing the @message field with the @requestId field and changing the limit from 10 to 20 to return the top 20 log events by duration instead of the top 10.
                

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 Logs 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 et AWS responsible AI policy.

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 CloudWatch Logs AI, y compris la fonctionnalité de génération de requêtes, vous devez créer une politique de désinscription pour CloudWatch Logs. Pour plus d’informations, veuillez consulter la rubrique Politiques de désactivation des services IA dans le Guide de l’utilisateur AWS Organizations .