Utilisation d'alias et de commentaires dans les requêtes

Créez des requêtes contenant des alias. Utilisez des alias pour renommer des champs de journal ou lors de l'extraction de valeurs dans des champs. Utilisez le mot-clé as pour attribuer un champ de journal ou obtenir un alias. Vous pouvez utiliser plusieurs alias dans une requête. Vous pouvez utiliser des alias dans les commandes suivantes :

• fields

• parse

• sort

• stats

Les exemples suivants montrent comment créer des requêtes contenant des alias.

Exemple

La requête contient un alias dans la commande fields.

fields @timestamp, @message, accountId as ID
| sort @timestamp desc
| limit 20

La requête renvoie les valeurs des champs @timestamp, @message et accountId. Les résultats sont triés dans l'ordre décroissant et limités à 20. Les valeurs pour accountId sont répertoriés sous l'alias ID.

Exemple

La requête contient des alias dans les commandes sort et stats.

stats count(*) by duration as time 
| sort time desc

La requête compte le nombre de fois que le champ duration apparaît dans le groupe de journaux et trie les résultats dans l'ordre décroissant. Les valeurs pour duration sont répertoriés sous l'alias time.

Utilisation de commentaires

CloudWatch Logs Insights prend en charge les commentaires dans les requêtes. Utilisez le caractère dièse (#) pour afficher les commentaires. Vous pouvez utiliser des commentaires pour ignorer les lignes des requêtes ou des requêtes de documents.

Exemple : requête

Lorsque la requête suivante est exécutée, la deuxième ligne est ignorée.

fields @timestamp, @message, accountId
# | filter accountId not like "7983124201998"
| sort @timestamp desc
| limit 20