Utilisation des journaux - AWS Serverless Application Model

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.

Utilisation des journaux

Pour simplifier la résolution des problèmes, la CLI  AWS SAM possède une commande appelée sam logs. Cette commande permet d'extraire les journaux générés par votre fonction Lambda depuis la ligne de commande.

Note

La sam logs commande fonctionne pour toutes les AWS Lambda fonctions, pas uniquement celles que vous déployez à l'aide AWS SAM.

Récupération des journaux par pile AWS CloudFormation

Lorsque votre fonction fait partie d'une AWS CloudFormation pile, vous pouvez récupérer les journaux en utilisant l'identifiant logique de la fonction :

sam logs -n HelloWorldFunction --stack-name mystack

Extraction des journaux par nom de fonction Lambda

Vous pouvez également extraire les journaux en utilisant le nom de la fonction :

sam logs -n mystack-HelloWorldFunction-1FJ8PD

Journaux détaillés

Ajoutez l'option --tail pour attendre les nouveaux journaux et les consulter au fur et à mesure qu'ils arrivent. Cela est utile pendant un déploiement ou lors de la résolution d'un problème de production.

sam logs -n HelloWorldFunction --stack-name mystack --tail

Affichage des journaux pour une plage de temps spécifique

Vous pouvez afficher les journaux pour une plage de temps spécifique à l'aide des options -s et -e :

sam logs -n HelloWorldFunction --stack-name mystack -s '10min ago' -e '2min ago'

Filtrage des journaux

Utilisez l'option --filter pour rechercher rapidement des journaux correspondant à des termes, expressions ou valeurs dans vos journaux d'événements.

sam logs -n HelloWorldFunction --stack-name mystack --filter "error"

Dans la réponse générée, la CLI  AWS SAM soulignera toutes les occurrences du terme « error » (erreur), afin que vous puissiez facilement trouver le mot clé filtre dans la réponse générée par le journal.

Mise en surbrillance des erreurs

Lorsque votre fonction Lambda se bloque ou expire, la CLI  AWS SAM met en surbrillance le message de délai d'attente en rouge. Cela permet de localiser aisément les exécutions spécifiques qui sont sur le point d'expirer au sein d'une diffusion importante de sortie de journal.

Impression JSON « pretty printing »

Si vos messages de journal impriment des chaînes JSON, la CLI  AWS SAM imprimera automatiquement le fichier JSON en « Pretty-print » pour vous aider à le comprendre et à l'analyser visuellement.