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 identifiants AWS SAM
<a name="serverless-sam-cli-logging"></a>

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 CloudFormation
<a name="serverless-logging-cfn"></a>

Lorsque votre fonction fait partie d'une 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
<a name="serverless-logging-function"></a>

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

```
sam logs -n mystack-HelloWorldFunction-1FJ8PD
```

## Journaux détaillés
<a name="serverless-logging-tail"></a>

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
<a name="serverless-logging-time-range"></a>

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
<a name="serverless-logging-time-range"></a>

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
<a name="serverless-logging-error-highlight"></a>

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 »
<a name="serverless-logging-error-highlight"></a>

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.