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

# `pcluster export-cluster-logs`
<a name="pcluster.export-cluster-logs-v3"></a>

Amazon S3 버킷을 통과하여 클러스터의 로그를 로컬 `tar.gz` 아카이브로 내보냅니다.

```
pcluster export-cluster-logs [-h]
                 --cluster-name CLUSTER_NAME
                [--bucket BUCKET_NAME]
                [--bucket-prefix BUCKET_PREFIX]
                [--debug]
                [--end-time END_TIME]
                [--filters FILTER [FILTER ...]]
                [--keep-s3-objects KEEP_S3_OBJECTS]
                [--output-file OUTPUT_FILE]
                [--region REGION]
                [--start-time START_TIME]
```

**참고**  
`export-cluster-logs` 명령은 CloudWatch Logs가 로그 내보내기를 완료할 때까지 대기하므로 출력 없이 일정 시간이 걸릴 것으로 예상됩니다.

## 이름 지정된 인수
<a name="pcluster-v3.export-cluster-logs.namedargs"></a>

**-h, --help**  
`pcluster export-cluster-logs`에 대한 도움말 텍스트를 표시합니다.

**--bucket *BUCKET\$1NAME***  
클러스터 로그 데이터를 내보낼 Amazon S3 버킷의 이름을 지정합니다. 그것은 클러스터와 같은 리전에 있어야 합니다.  
+ CloudWatch 액세스 권한을 부여하려면 Amazon S3 버킷 정책에 권한을 추가해야 합니다. 자세한 내용은 CloudWatch Logs 사용 설명서의 [ Amazon S3 버킷에 대한 권한 설정을](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions) 참조하세요. *CloudWatch *
+  AWS ParallelCluster 버전 **3.12.0**부터 `--bucket` 옵션은 **선택 사항**입니다. 옵션을 지정 AWS ParallelCluster 하지 않으면 리전 기본 버킷(`parallelcluster-hash-v1-DO-NOT-DELETE`)이 사용되거나 클러스터 구성에가 가리키는 Amazon S3 버킷`CustomS3Bucket`이 지정되어 사용됩니다. `--bucket` 옵션을 지정하지 않고 기본 AWS ParallelCluster 버킷을 사용하는 경우 로그는 내부용으로 예약된 보호`parallelcluster/`된 폴더이므로 폴더로 내보낼 수 없습니다.
 AWS ParallelCluster 기본 버킷을 사용하는 경우 pcluster가 버킷 정책을 구성합니다. 버킷 정책을 사용자 지정한 다음 버전 **3.12.0**으로 AWS ParallelCluster 업그레이드하면 버킷 정책이 재정의되므로 변경 사항을 다시 적용해야 합니다.

**--cluster-name, -n *CLUSTER\$1NAME***  
클러스터의 이름을 지정합니다.

**--bucket-prefix *BUCKET\$1PREFIX***  
내보낸 로그 데이터가 저장되는 Amazon S3 버킷의 경로를 지정합니다.  
기본적으로 버킷 접두사는 다음과 같습니다.  

```
cluster-name-logs-202209061743.tar.gz
```
`202209061743`는 `%Y%m%d%H%M` 형식의 시간 예제입니다.  
 AWS ParallelCluster 버전 **3.12.0**부터는 `--bucket` 옵션을 지정하지 않고 기본 AWS ParallelCluster 버킷을 사용하는 경우 내부용으로 예약된 보호`parallelcluster/`된 폴더이므로 폴더로 로그를 내보낼 수 없습니다.

**--debug**  
디버깅 로깅을 활성화합니다.

**--end-time *END\$1TIME***  
로그 이벤트를 수집할 시간 범위의 끝을 지정합니다. ISO 8601 형식(`YYYY-MM-DDThh:mm:ssZ`, 예시로는 `2021-01-01T20:00:00Z`‘)으로 표현됩니다. 타임스탬프가 이 시간 이후인 이벤트는 포함되지 않습니다. 시간 요소(예: 분 및 초)는 생략될 수 있습니다. 기본값은 현재 시간입니다.

**--filters *FILTER* [*FILTER* ...]**  
로그의 필터를 지정합니다. 형식: `Name=a,Values=1 Name=b,Values=2,3` 지원되는 필터는 다음과 같습니다.    
`private-dns-name`  
인스턴스의 프라이빗 DNS 이름의 약식을 지정합니다(예:`ip-10-0-0-101`).  
`node-type`  
노드 유형을 지정합니다. 이 필터에 허용되는 유일한 값은 `HeadNode`입니다.

**--keep-s3-objects *KEEP\$1S3\$1OBJECTS***  
`true`면 내보낸 객체를 아마존 S3로 내보낸 것을 보관합니다. (`false`로 디폴트됩니다.)

**--output-file *OUTPUT\$1FILE***  
로그 아카이브를 저장할 파일 경로를 지정합니다. 이 정보가 제공되면 로그가 로컬에 저장됩니다. 그렇지 않으면 출력에 반환된 URL과 함께 Amazon S3에 업로드됩니다. Amazon S3로 업로드하는 것이 기본값입니다.

**--region, -r *REGION***  
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.

**--start-time *START\$1TIME***  
시간 범위의 시작을 지정합니다. ISO 8601 형식(`YYYY-MM-DDThh:mm:ssZ`, 예시로는 `2021-01-01T20:00:00Z`)으로 표현됩니다. 타임스탬프가 이 시간 이후인 로그 이벤트가 포함됩니다. 지정하지 않을 경우 기본값은 클러스터가 생성된 시간입니다.

** AWS ParallelCluster 버전 3.1.4 사용 예제:**

```
$ pcluster export-cluster-logs --bucket cluster-v3-bucket -n cluster-v3
{
  "url": "https://cluster-v3-bucket..."
}
```

## 로그를 검색할 수 없습니까?
<a name="pcluster-v3.export-cluster-logs.retrieve-logs"></a>

`export-cluster-logs` 명령을 사용하여 로그를 검색할 수 없는 경우 다음 중 하나를 수행합니다.
+ 클러스터의 CloudWatch 로그 그룹에서 로그를 수동으로 검색합니다.
+ 로그 그룹이 비어 있는 경우 클러스터 노드에 SSH를 넣고에 나열된 로그를 검색합니다[노드 초기화 문제 해결](troubleshooting-v3-scaling-issues.md#troubleshooting-v3-node-init).
+ 클러스터가 생성되지 않아 클러스터 노드에 액세스할 수 없는 경우 옵션으로 클러스터를 다시 생성하고 노드에서 로그를 `--rollback-on-failure false` 검색합니다.