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 Logs Insights

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, OpenSearch Service PPL, OpenSearch Service SQL 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.

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.

Exemples : 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 les requêtes qui effectuent 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 la requête utilisant le langage de requête CloudWatch Logs Insights généré 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.

Invite

Pour générer une requête OpenSearch SQL, sélectionnez l'onglet OpenSearch SQL, puis ouvrez la boîte de dialogue du générateur de requêtes pour saisir votre invite en langage naturel. Voici un exemple d'invite qui utilise la fonctionnalité du langage naturel pour générer une requête OpenSearch SQL.

Give me the number of errors and exceptions per hour

Requête

Voici la requête SQL générée par cette invite que vous pouvez utiliser pour trouver le nombre d'erreurs et d'exceptions agrégées par heure :

SELECT DATE_FORMAT(`@timestamp`, 'yyyy-MM-dd HH') AS hour,
       COUNT(*) AS error_count
FROM `/aws/lambda/CloudWatchOdysseyQueryGen`
WHERE `@message` LIKE '%error%'
  OR `@message` LIKE '%exception%'
GROUP BY DATE_FORMAT(`@timestamp`, 'yyyy-MM-dd HH')
ORDER BY hour

Invite

Pour générer une requête OpenSearch PPL, sélectionnez l'onglet OpenSearch PPL, puis ouvrez la boîte de dialogue du générateur de requêtes pour saisir votre invite en langage naturel. Voici un exemple d'invite qui utilise la fonctionnalité du langage naturel pour générer une requête OpenSearch PPL.

Give me all unique exception messages

Requête

Voici la requête PPL générée par cette invite que vous pouvez utiliser pour rechercher les messages d'exception uniques dans vos journaux :

dedup @message 
| fields @message
                       

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 requête mise à jour à l'aide du langage de requête CloudWatch Logs Insights. 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 .