Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam logs`.

Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Il `sam logs` comando recupera i log generati dalle tue AWS Lambda funzioni.

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

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

## Opzioni
<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>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-logs-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è «samconfig.toml» nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--cw-log-group LIST`  <a name="sam-cli-command-reference-sam-logs-options-cw-log-group"></a>
Include i log dei gruppi di CloudWatch log Logs specificati. Se si specifica questa opzione insieme a`name`, AWS SAM include i registri dei gruppi di log specificati oltre ai registri delle risorse denominate.

`--debug`  <a name="sam-cli-command-reference-sam-logs-options-debug"></a>
Attiva la registrazione di debug per stampare il messaggio di debug generato dai timestamp e visualizzarli. AWS SAMCLI

`---end-time, e TEXT`  <a name="sam-cli-command-reference-sam-logs-options-end-time"></a>
Recupera i log aggiornati a quest'ora. L'ora può essere costituita da valori relativi come «5 minuti fa», «domani» o un timestamp formattato come «2018-01-01 10:10:10».

`--filter TEXT`  <a name="sam-cli-command-reference-sam-logs-options-filter"></a>
Consente di specificare un'espressione per trovare rapidamente i log che corrispondono a termini, frasi o valori negli eventi di registro. Può trattarsi di una semplice parola chiave (ad esempio «errore») o di un pattern supportato da Amazon CloudWatch Logs. Per la sintassi, consulta la documentazione di [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>
Mostra questo messaggio ed esce.

`--include-traces`  <a name="sam-cli-command-reference-sam-logs-options-include-traces"></a>
Include tracce X-Ray nell'output del registro.

`--name, -n TEXT`  <a name="sam-cli-command-reference-sam-logs-options-name"></a>
Il nome della risorsa per la quale recuperare i log. Se questa risorsa fa parte di uno CloudFormation stack, può essere l'ID logico della risorsa funzionale nel CloudFormation modello /.AWS SAM È possibile fornire più nomi ripetendo nuovamente il parametro. Se la risorsa si trova in uno stack nidificato, al nome può essere aggiunto il nome dello stack nidificato per estrarre i log da quella risorsa (/). NestedStackLogicalId ResourceLogicalId Se il nome della risorsa non viene fornito, lo stack specificato verrà scansionato e verranno recuperate le informazioni di registro per tutte le risorse supportate. Se non specificate questa opzione, AWS SAM recupera i log per tutte le risorse nello stack specificato. Sono supportati i seguenti tipi di risorse:  
+ `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>
Speciifica il formato di output per i registri. Per stampare registri formattati, specificare. `text` Per stampare i log come JSON, specificare. `json`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-logs-options-profile"></a>
Il profilo specifico del file delle credenziali che ottiene le credenziali. AWS 

`--region TEXT`  <a name="sam-cli-command-reference-sam-logs-options-region"></a>
La AWS regione in cui effettuare la distribuzione. Ad esempio, us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-logs-options-save-params"></a>
Salva i parametri forniti dalla riga di comando nel file di AWS SAM configurazione.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-logs-options-stack-name"></a>
Il nome dello CloudFormation stack di cui fa parte la risorsa.

`--start-time, -s TEXT`  <a name="sam-cli-command-reference-sam-logs-options-start-time"></a>
Recupera i log a partire da questo momento. L'ora può essere costituita da valori relativi come «5 minuti fa», «ieri» o un timestamp formattato come «2018-01-01 10:10:10». Il valore predefinito è «10 minuti fa».

` --tail, -t`  <a name="sam-cli-command-reference-sam-logs-options-tail"></a>
Coordina l'output del registro. Questo ignora l'argomento dell'ora di fine e continua a recuperare i log non appena diventano disponibili.

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

Quando le funzioni fanno parte di uno CloudFormation stack, puoi recuperare i log utilizzando l'ID logico della funzione quando specifichi il nome dello stack.

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

Visualizza i log per un intervallo di tempo specifico utilizzando le opzioni -s (--start-time) e -e (--end-time).

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

Puoi anche aggiungere l'`--tail`opzione per attendere nuovi log e vederli man mano che arrivano.

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

Utilizza l'`--filter`opzione per trovare rapidamente i log che corrispondono a termini, frasi o valori nei tuoi eventi di registro.

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

Visualizza i log di una risorsa in uno stack secondario.

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

Registri di coda per tutte le risorse supportate nell'applicazione.

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

Recupera i log per una funzione Lambda specifica e l'API API Gateway nella tua applicazione.

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

Recupera i log per tutte le risorse supportate nell'applicazione e, in aggiunta, dai gruppi di log specificati.

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