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.

# sam logs
<a name="sam-cli-command-reference-sam-logs"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam logs`.

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam logs` commande récupère les journaux générés par vos AWS Lambda fonctions.

## Usage
<a name="sam-cli-command-reference-sam-logs-usage"></a>

```
$ sam logs <options>
```

## Options
<a name="sam-cli-command-reference-sam-logs-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-logs-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-logs-options-config-file"></a>
Le chemin d'accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « samconfig.toml » dans la racine du répertoire du projet. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--cw-log-group LIST`  <a name="sam-cli-command-reference-sam-logs-options-cw-log-group"></a>
Inclut les CloudWatch journaux des groupes de journaux que vous spécifiez. Si vous spécifiez cette option avec`name`, AWS SAM inclut les journaux des groupes de journaux spécifiés en plus des journaux des ressources nommées.

`--debug`  <a name="sam-cli-command-reference-sam-logs-options-debug"></a>
Active la journalisation de débogage pour imprimer le message de débogage généré par la CLI  AWS SAM et pour afficher les horodatages.

`---end-time, e TEXT`  <a name="sam-cli-command-reference-sam-logs-options-end-time"></a>
Récupère les journaux jusqu’à ce moment. L'heure peut être des valeurs relatives comme « il y a 5 minutes », « hier », ou un horodatage formaté comme « 2018-01-01 10:10:10 ».

`--filter TEXT`  <a name="sam-cli-command-reference-sam-logs-options-filter"></a>
Vous permet de spécifier une expression pour rechercher rapidement des journaux qui correspondent à des termes, des phrases ou des valeurs dans les journaux d’événements. Il peut s'agir d'un simple mot clé (par exemple, « erreur ») ou d'un modèle pris en charge par Amazon CloudWatch Logs. Pour connaître la syntaxe, consultez la [documentation Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html).

`--help`  <a name="sam-cli-command-reference-sam-logs-options-help"></a>
Affiche ce message, puis se ferme.

`--include-traces`  <a name="sam-cli-command-reference-sam-logs-options-include-traces"></a>
Inclut des traces X-Ray dans la sortie du journal.

`--name, -n TEXT`  <a name="sam-cli-command-reference-sam-logs-options-name"></a>
Le nom de la ressource pour laquelle vous souhaitez récupérer des journaux. Si cette ressource fait partie d'une CloudFormation pile, il peut s'agir de l'ID logique de la ressource fonctionnelle dans le AWS SAM modèle CloudFormation/. Plusieurs noms peuvent être fournis en répétant à nouveau le paramètre. Si la ressource se trouve dans une pile imbriquée, le nom peut être précédé du nom de la pile imbriquée pour extraire les journaux de cette ressource (/). NestedStackLogicalId ResourceLogicalId Si le nom de la ressource n'est pas fourni, la pile donnée sera analysée et les informations de journal seront extraites pour toutes les ressources prises en charge. Si vous ne spécifiez pas cette option, AWS SAM extrait les journaux de toutes les ressources de la pile que vous spécifiez. Les types de ressources suivants sont pris en charge :  
+ `AWS::Serverless::Function`
+ `AWS::Lambda::Function`
+ `AWS::Serverless::Api`
+ `AWS::ApiGateway::RestApi`
+ `AWS::Serverless::HttpApi`
+ `AWS::ApiGatewayV2::Api`
+ `AWS::Serverless::StateMachine`
+ `AWS::StepFunctions::StateMachine`

`--output TEXT`  <a name="sam-cli-command-reference-sam-logs-options-output"></a>
Spécifie le format de sortie pour les journaux. Pour imprimer des journaux formatés, spécifiez `text`. Pour imprimer les journaux au format JSON, spécifiez `json`.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-logs-options-profile"></a>
Le profil spécifique de votre fichier d'informations d'identification qui obtient les AWS informations d'identification.

`--region TEXT`  <a name="sam-cli-command-reference-sam-logs-options-region"></a>
 AWS Région dans laquelle le déploiement doit être effectué. Par exemple, us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-logs-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-logs-options-stack-name"></a>
Nom de la CloudFormation pile dont fait partie la ressource.

`--start-time, -s TEXT`  <a name="sam-cli-command-reference-sam-logs-options-start-time"></a>
Récupère les journaux à partir de ce moment. L'heure peut être des valeurs relatives comme « il y a 5 minutes », « hier », ou un horodatage formaté comme « 2018-01-01 10:10:10 ». La valeur par défaut est « il y a 10 minutes ».

` --tail, -t`  <a name="sam-cli-command-reference-sam-logs-options-tail"></a>
Suit la sortie du journal. Cela ignore l’argument de fin d’heure et continue de récupérer les journaux à mesure qu’ils deviennent disponibles.

## Exemples
<a name="sam-cli-command-reference-sam-logs-examples"></a>

Lorsque vos fonctions font partie d'une CloudFormation pile, vous pouvez récupérer les journaux en utilisant l'identifiant logique de la fonction lorsque vous spécifiez le nom de la pile.

```
$ sam logs -n HelloWorldFunction --stack-name myStack
```

Consultez les journaux pour une plage de temps spécifique à l'aide des options -s (--start-time) et -e (--end-time).

```
$ sam logs -n HelloWorldFunction --stack-name myStack -s '10min ago' -e '2min ago'
```

Vous pouvez également ajouter la `--tail` possibilité d'attendre les nouveaux journaux et de les voir à leur arrivée.

```
$ sam logs -n HelloWorldFunction --stack-name myStack --tail
```

Utilisez `--filter` cette option pour trouver rapidement les journaux correspondant aux termes, expressions ou valeurs de vos événements de journal.

```
$ sam logs -n HelloWorldFunction --stack-name myStack --filter "error"
```

Consultez les journaux d'une ressource dans une pile enfant.

```
$ sam logs --stack-name myStack -n childStack/HelloWorldFunction
```

Journaux de suivi de toutes les ressources prises en charge dans votre application.

```
$ sam logs --stack-name sam-app --tail
```

Récupérez les journaux d'une fonction Lambda et d'une API API Gateway spécifiques dans votre application.

```
$ sam logs --stack-name sam-app --name HelloWorldFunction --name HelloWorldRestApi
```

Récupérez les journaux de toutes les ressources prises en charge dans votre application, ainsi que des groupes de journaux spécifiés.

```
$ sam logs --cw-log-group /aws/lambda/myfunction-123 --cw-log-group /aws/lambda/myfunction-456
```