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

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

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

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

`sam logs` 명령은 AWS Lambda 함수에서 생성된 로그를 가져옵니다.

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

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

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

`--cw-log-group LIST`  <a name="sam-cli-command-reference-sam-logs-options-cw-log-group"></a>
지정한 CloudWatch Logs 로그 그룹의 로그를 포함합니다. 와 함께이 옵션을 지정하는 경우 `name`에는 지정된 로그 그룹의 로그와 명명된 리소스의 로그가 AWS SAM 포함됩니다.

`--debug`  <a name="sam-cli-command-reference-sam-logs-options-debug"></a>
디버그 로깅을 켜서 AWS SAMCLI 에 의해 생성된 디버그 메시지를 인쇄하고 타임스탬프를 표시합니다.

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

`--filter TEXT`  <a name="sam-cli-command-reference-sam-logs-options-filter"></a>
표현식을 지정하여 로그 이벤트에서 단어, 구문 또는 값과 일치하는 로그를 빠르게 찾을 수 있습니다. 이는 간단한 키워드 (예: “error”) 이거나 Amazon CloudWatch Logs에서 지원하는 패턴일 수 있습니다. 명령문에 대한 내용은 [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>
이 메시지를 표시한 후 종료합니다.

`--include-traces`  <a name="sam-cli-command-reference-sam-logs-options-include-traces"></a>
로그 출력에 X-Ray 트레이스를 포함합니다.

`--name, -n TEXT`  <a name="sam-cli-command-reference-sam-logs-options-name"></a>
로그를 가져올 리소스의 이름입니다. 이 리소스가 CloudFormation 스택의 일부인 경우 이는 CloudFormation/AWS SAM 템플릿에 있는 함수 리소스의 논리적 ID일 수 있습니다. 인자를 반복함으로써 여러 이름을 제공할 수 있습니다. 리소스가 중첩된 스택에 있는 경우 이름 앞에 중첩된 스택 이름을 추가하여 해당 리소스에서 로그를 가져올 수 있습니다 (NestedStackLogicalID/ResourceLogicalID). 리소스 이름을 지정하지 않으면 지정된 스택을 스캔하고 지원되는 모든 리소스에 대한 로그 정보를 가져옵니다. 이 옵션을 지정하지 않으면는 지정한 스택의 모든 리소스에 대한 로그를 AWS SAM 가져옵니다. 다음과 같은 리소스 유형이 지원됩니다.  
+ `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>
로그에 대한 출력 형식을 지정합니다. 형식이 지정된 로그를 인쇄하려면 `text`을 지정합니다. 로그를 JSON으로 인쇄하려면 `json`을 지정합니다.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-logs-options-profile"></a>
자격 증명을 가져오는 AWS 자격 증명 파일의 특정 프로필입니다.

`--region TEXT`  <a name="sam-cli-command-reference-sam-logs-options-region"></a>
배포할 AWS 리전입니다. 예를 들어 us-east-1입니다.

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

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-logs-options-stack-name"></a>
리소스가 속한 CloudFormation 스택의 이름입니다.

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

` --tail, -t`  <a name="sam-cli-command-reference-sam-logs-options-tail"></a>
로그 출력을 추적합니다. 이렇게 하면 종료 시간 인수를 무시하고 로그가 제공되는 대로 계속 가져옵니다.

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

함수가 CloudFormation 스택의 일부인 경우 스택 이름을 지정할 때 함수의 논리적 ID를 사용하여 로그를 가져올 수 있습니다.

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

-s(--start-time) 및 -e(--endtime) 옵션을 사용하여 특정 시간 범위의 로그를 볼 수 있습니다.

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

새 로그가 도착할 때까지 기다렸다가 로그가 도착하는 대로 확인하는 `--tail` 옵션을 추가할 수도 있습니다.

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

`--filter` 옵션을 사용하면 로그 이벤트의 용어, 구문 또는 값과 일치하는 로그를 빠르게 찾을 수 있습니다.

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

하위 스택에 있는 리소스의 로그를 볼 수 있습니다.

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

귀하의 애플리케이션에서 지원되는 모든 리소스의 테일 로그입니다.

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

애플리케이션의 특정 Lambda 함수 및 API 게이트웨이 API에 대한 로그를 가져옵니다.

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

애플리케이션에서 지원되는 모든 리소스에 대한 로그를 가져오고, 추가로 지정된 로그 그룹에서도 로그를 가져옵니다.

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