As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam traces`.

Para uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam traces` comando busca AWS X-Ray traços em seu Conta da AWS no Região da AWS.

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

```
$ sam traces <options>
```

## Opções
<a name="sam-cli-command-reference-sam-traces-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-traces-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-traces-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “`samconfig.toml`“ na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--end-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-end-time"></a>
Busca rastros até agora. A hora pode ser valores relativos, como '5 minutos atrás', 'amanhã' ou um carimbo de data/hora formatado como '2018-01-01 10:10:10'.

`--output TEXT`  <a name="sam-cli-command-reference-sam-traces-options-output"></a>
Especifica o formato de saída para logs. Para imprimir registros formatados, especifique`text`. Para imprimir os registros como JSON, especifique `json`.

`--save-params`  <a name="sam-cli-command-reference-sam-traces-options-save-params"></a>
Salve os parâmetros fornecidos na linha de comando no arquivo AWS SAM de configuração.

`--start-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-start-time"></a>
Busca traços a partir desse momento. A hora pode ser valores relativos, como '5 minutos atrás', 'ontem' ou um carimbo de data/hora formatado como '2018-01-01 10:10:10'. O padrão é '10 minutos atrás'.

`--tail`  <a name="sam-cli-command-reference-sam-traces-options-tail"></a>
Encerra a saída do rastreamento. Isso ignora o argumento de horário de término e continua exibindo rastreamentos à medida que eles se tornam disponíveis.

`--trace-id TEXT`  <a name="sam-cli-command-reference-sam-traces-options-trace-id"></a>
O identificador exclusivo para rastreamento com X-Ray.

## Exemplos
<a name="sam-cli-command-reference-sam-traces-examples"></a>

Execute o comando a seguir para buscar traços do X-Ray por ID.

```
$ sam traces --trace-id tracing-id-1 --trace-id tracing-id-2
```

Execute o comando a seguir para rastrear traços do X-Ray assim que estiverem disponíveis.

```
$ sam traces --tail
```