기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

이 페이지에서는 AWS Serverless Application Model 명령줄 인터페이스(AWS SAM CLI) `sam traces` 명령에 대한 참조 정보를 제공합니다.

에 대한 소개는 단원을 AWS SAM CLI참조하십시오. [란 무엇입니까 AWS SAM CLI?](what-is-sam-overview.md#what-is-sam-cli) 

`sam traces` 명령은의 AWS 계정 에서 AWS X-Ray 트레이스를 가져옵니다 AWS 리전.

## 사용법
<a name="sam-cli-command-reference-sam-traces-usage"></a>

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

## 옵션
<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>
사용할 구성 파일의 기본 매개변수 값을 지정하는 환경 이름입니다. 기본값은 “기본값”입니다. 구성 파일에 대한 자세한 내용은 [AWS SAMCLI구성 파일](serverless-sam-cli-config.md) 섹션을 참조하세요.

`--config-file PATH`  <a name="sam-cli-command-reference-sam-traces-options-config-file"></a>
사용할 기본 매개변수 값이 들어 있는 구성 파일의 경로 및 파일 이름입니다. 기본값은 프로젝트 디렉터리의 루트에 있는 “`samconfig.toml`“입니다. 구성 파일에 대한 자세한 내용은 [AWS SAMCLI구성 파일](serverless-sam-cli-config.md) 섹션을 참조하세요.

`--end-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-end-time"></a>
이 시간까지의 추적을 가져옵니다. 시간은 ‘5분 전’, ‘내일’과 같은 상댓값이거나 ‘2018-01-01 10:10:10’과 같은 형식이 지정된 타임스탬프일 수 있습니다.

`--output TEXT`  <a name="sam-cli-command-reference-sam-traces-options-output"></a>
로그에 대한 출력 형식을 지정합니다. 형식이 지정된 로그를 인쇄하려면 `text`을 지정합니다. 로그를 JSON으로 인쇄하려면 `json`을 지정합니다.

`--save-params`  <a name="sam-cli-command-reference-sam-traces-options-save-params"></a>
명령줄에 제공한 파라미터를 AWS SAM 구성 파일에 저장합니다.

`--start-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-start-time"></a>
이때부터 추적을 가져옵니다. 시간은 ‘5분 전’, ‘어제’와 같은 상댓값이거나 ‘2018-01-01 10:10:10’과 같은 형식이 지정된 타임스탬프일 수 있습니다. 기본값은 ‘10분 전’입니다.

`--tail`  <a name="sam-cli-command-reference-sam-traces-options-tail"></a>
추적 결과를 업데이트합니다. 이렇게 하면 엔드타임 인수가 무시되고 변경이 반영 가능할 때마다 계속 표시됩니다.

`--trace-id TEXT`  <a name="sam-cli-command-reference-sam-traces-options-trace-id"></a>
X-Ray 추적의 고유 식별자.

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

다음 명령을 실행하여 ID별로 X-Ray 추적을 가져옵니다.

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

다음 명령을 실행하여 X-Ray 추적을 사용할 수 있게 되면 이를 추적합니다.

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