pcluster export-cluster-logs

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

pcluster export-cluster-logs [-h]
                 --bucket BUCKET_NAME
                 --cluster-name CLUSTER_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]

이름 지정된 인수

-h, --help

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

--bucket BUCKET_NAME

클러스터 로그 데이터를 내보낼 Amazon S3 버킷의 이름을 지정합니다. 그것은 클러스터와 같은 리전에 있어야 합니다.

참고

CloudWatch 액세스를 허용하려면 Amazon S3 버킷 정책에 권한을 추가해야 합니다. 자세한 내용은 CloudWatch Logs 사용 설명서의 Amazon S3 버킷에 대한 권한 설정을 참조하십시오.

--cluster-name, -n CLUSTER_NAME

클러스터의 이름을 지정합니다.

--bucket-prefix BUCKET_PREFIX

내보낸 로그 데이터가 저장되는 Amazon S3 버킷의 경로를 지정합니다.

기본적으로 버킷 접두사는 다음과 같습니다.

cluster-name-logs-202209061743.tar.gz

202209061743는 현재 시간을 %Y%m%d%H%M 형식으로 나타낸 것입니다.

--debug

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

--end-time END_TIME

로그 이벤트를 수집할 시간 범위의 끝을 지정합니다. 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_S3_OBJECTS

true면 내보낸 객체를 아마존 S3로 내보낸 것을 보관합니다. (false로 디폴트됩니다.)

--output-file OUTPUT_FILE

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

--region, -r REGION

사용할 AWS 리전 항목을 지정합니다. 는 AWS_DEFAULT_REGION 환경 변수, ~/.aws/config 파일 [default] 섹션의 region 설정 또는 --region 매개변수를 사용하여 AWS 리전 지정해야 합니다.

--start-time START_TIME

시간 범위의 시작을 지정합니다. 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..."
}