기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 데이터 리포지토리 이벤트 로그
CloudWatch Logs에 로깅을 켜면 가져오기, 내보내기, 데이터 리포지토리 작업, 복원 이벤트를 사용하여 파일을 가져오거나 내보내는 동안 발생한 모든 실패에 대한 정보를 기록할 수 있습니다. 자세한 내용은 [Amazon CloudWatch Logs를 사용한 로깅](cw-event-logging.md) 섹션을 참조하세요.
**참고**
데이터 리포지토리 작업이 실패하면 Amazon FSx는 작업 완료 보고서에도 실패 정보를 기록합니다. 완료 보고서의 실패 정보에 대한 자세한 내용은 [데이터 리포지토리 작업 실패 문제 해결](failed-tasks.md) 섹션을 확인합니다.
**Topics**
+ [이벤트 가져오기](#import-event-logging)
+ [내보내기 이벤트](#export-event-logging)
+ [HSM 복원 이벤트](#hsm-restore-event-logging)
## 이벤트 가져오기
| 오류 유형 | 로그 수준 | 로그 메시지 | 근본 원인: | 완료 보고서의 오류 코드 |
| --- | --- | --- | --- | --- |
| 객체 나열 실패 | ERROR | 접두사 접두사를 사용하여 S3 버킷 bucket\$1name의 S3 객체를 나열하지 못했습니다. | Amazon FSx가 S3 버킷의 S3 객체를 나열하지 못했습니다. 이는 S3 버킷 정책이 Amazon FSx에 충분한 권한을 제공하지 않는 경우 발생할 수 있습니다. | N/A |
| 지원되지 않는 S3 스토리지 클래스 | WARN | 지원되지 않는 계층 S3\$1tier\$1name의 S3 객체로 인해 S3 버킷 bucket\$1name에 key\$1value이 있는 S3 객체를 가져오지 못했습니다. | Amazon FSx는 S3 Glacier Flexible Retrieve 또는 S3 Glacier Deep Archive 스토리지 클래스와 같이 지원되지 않는 Amazon S3 스토리지 클래스에 있으므로 S3 객체를 가져올 수 없습니다. | S3ObjectInUnsupportedTier |
| 지원되지 않는 symlink 스토리지 클래스 | ERROR | 지원되지 않는 계층 S3\$1Tier\$1name의 S3 심볼릭 링크 객체로 인해 S3 버킷 bucket\$1name에 key\$1value이 있는 S3 객체를 가져오지 못했습니다. | Amazon FSx는 S3 Glacier Flexible Retrieve 또는 S3 Glacier Deep Archive 스토리지 클래스와 같이 지원되지 않는 Amazon S3 스토리지 클래스에 있으므로 심볼링크 객체를 가져올 수 없습니다. | S3SymlinkInUnsupportedTier |
| S3 액세스 거부됨 | ERROR | S3 객체에 대한 액세스가 거부되어 S3 버킷 bucket\$1name에 key\$1value 키가 있는 S3 객체를 가져오지 못했습니다. | Amazon S3에 대한 데이터 리포지토리 내보내기 가져오기 작업에 대한 액세스가 거부되었습니다. 가져오기 작업의 경우 Amazon FSx 파일 시스템에 S3의 연결된 데이터 리포지토리에서 가져오기 위한 `s3:HeadObject` 및 `s3:GetObject` 작업을 수행할 권한이 있어야 합니다. 가져오기 작업의 경우 S3 버킷이 고객 관리 키가 저장된 서버 측 암호화 AWS Key Management Service(SSE-KMS)를 사용하는 경우 [서버 측 암호화된 Amazon S3 버킷 사용](s3-server-side-encryption-support.md)의 정책 구성을 따라야 합니다. | S3AccessDenied |
| 액세스 삭제 거부됨 | ERROR | S3 객체에 대한 액세스가 거부되었기 때문에 S3 버킷 bucket\$1name에 key\$1value가 있는 S3 객체의 로컬 파일을 삭제하지 못했습니다. | S3 객체에 대한 자동 가져오기 액세스가 거부되었습니다. | N/A |
| POSIX 미준수 객체 | ERROR | S3 객체가 POSIX와 호환되지 않기 때문에 S3 버킷 bucket\$1name에 key\$1value가 있는 S3 객체를 가져오지 못했습니다. | Amazon S3 객체가 존재하지만 POSIX 호환 객체가 아니므로 가져올 수 없습니다. 지원되는 POSIX 메타데이터에 대한 자세한 내용은 [데이터 리포지토리에 대한 POSIX 메타데이터 지원](posix-metadata-support.md) 섹션을 참조하세요. | S3ObjectPathNotPosixCompliant |
| 객체 유형 불일치 | ERROR | 이름이 같은 S3 객체를 이미 파일 시스템으로 가져왔기 때문에 S3 버킷 bucket\$1name에 key\$1value가 있는 S3 객체를 가져오지 못했습니다. | 가져오는 S3 객체가 파일 시스템에서 이름이 같은 기존 객체와 유형(파일 또는 디렉터리)이 다릅니다. | S3ObjectTypeMismatch |
| 디렉터리 메타데이터 업데이트 실패 | ERROR | 내부 오류로 인해 로컬 디렉터리 메타데이터를 업데이트하지 못했습니다. | 내부 오류로 인해 디렉터리 메타데이터를 가져올 수 없는 경우. | N/A |
| S3 객체를 찾을 수 없음 | ERROR | key\$1value 키가 있는 S3 객체를 S3 버킷 bucket\$1name에서 찾을 수 없어서 가져오지 못했습니다. | Amazon FSx는 해당 객체가 데이터 리포지토리에 없기 때문에 파일 메타데이터를 가져올 수 없었습니다. | S3FileDeleted |
| S3 버킷을 찾을 수 없음 | ERROR | 버킷이 없어서 S3 버킷 bucket\$1name에 key\$1value 키가 있는 S3 객체를 가져오지 못했습니다. | S3 버킷이 더 이상 존재하지 않기 때문에 Amazon FSx는 S3 객체를 파일 시스템으로 자동으로 가져올 수 없습니다. | N/A |
| S3 버킷을 찾을 수 없음 | ERROR | 버킷이 없어서 S3 버킷 bucket\$1name에 key\$1value가 있는 S3 객체의 로컬 파일을 삭제하지 못했습니다. | S3 버킷이 더 이상 존재하지 않기 때문에 Amazon FSx는 파일 시스템의 S3 객체에 연결된 파일을 삭제할 수 없습니다. | N/A |
| 디렉터리 생성 실패 | ERROR | 내부 오류로 인해 로컬 디렉터리를 만들지 못했습니다. | Amazon FSx가 내부 오류로 인해 파일 시스템에 생성된 디렉터리를 자동으로 가져오지 못했습니다. | N/A |
| 디스크 공간이 가득 참 | ERROR | 파일 시스템이 꽉 찼기 때문에 S3 버킷 bucket\$1name에 key\$1value 키가 있는 S3 객체를 가져오지 못했습니다. | 파일 또는 디렉터리를 생성하는 동안 파일 시스템에서 메타데이터 서버의 디스크 공간이 부족했습니다. | N/A |
## 내보내기 이벤트
| 오류 유형 | 로그 수준 | 로그 메시지 | 근본 원인: | 완료 보고서의 오류 코드 |
| --- | --- | --- | --- | --- |
| 액세스가 거부되었습니다 | ERROR | S3 버킷 bucket\$1name에 key\$1value 키가 있는 S3 객체에 대한 액세스가 거부되어 파일을 내보내지 못했습니다. | Amazon S3에 대한 데이터 리포지토리 내보내기 작업에 대한 액세스가 거부되었습니다. 내보내기 작업의 경우 Amazon FSx 파일 시스템에 S3의 연결된 데이터 리포지토리로 내보내기 작업을 수행할 `s3:PutObject` 권한이 있어야 합니다. 이 권한은 `AWSServiceRoleForFSxS3Access_fs-0123456789abcdef0` 서비스 연결 역할에서 부여됩니다. 자세한 내용은 [Amazon FSx에 대해 서비스 연결 역할 사용](using-service-linked-roles.md) 섹션을 참조하세요. 내보내기 작업을 수행하려면 데이터가 파일 시스템의 VPC 외부로 이동해야 하므로 대상 리포지토리에 `aws:SourceVpc` 또는 `aws:SourceVpce` IAM 글로벌 조건 키 중 하나가 포함된 버킷 정책이 있는 경우 이 오류가 발생할 수 있습니다. S3 버킷에 파일 시스템에 연결된 S3 버킷 계정과 다른 AWS 계정에서 업로드된 객체가 포함된 경우, 업로드한 계정과 상관없이 데이터 리포지토리 작업이 S3 메타데이터를 수정하거나 S3 객체를 덮어쓸 수 있도록 할 수 있습니다. S3 버킷에 대해 S3 객체 소유권 기능을 활성화하는 것이 좋습니다. 이 기능을 사용하면 `--acl bucket-owner-full-control` ACL을 제공하기 위해 강제로 업로드함으로써 다른 AWS 계정이 버킷에 업로드하는 새 객체의 소유권을 가질 수 있습니다. S3 버킷에서 **버킷 소유자 선호** 옵션을 선택하여 S3 객체 소유권을 활성화합니다. 자세한 내용은 *Amazon S3 사용 설명서*의 [S3 객체 소유권을 사용하여 업로드된 객체의 소유권 제어](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html)를 참조하세요. | S3AccessDenied |
| 내보내기 경로가 너무 김 | ERROR | 로컬 파일 경로 크기가 S3에서 지원하는 최대 객체 키 길이를 초과하여 파일을 내보내지 못했습니다. | 내보내기 경로가 너무 깁니다. S3에서 지원하는 최대 객체 키 길이는 1,024자입니다. | PathSizeTooLong |
| 파일이 너무 큼 | ERROR | 파일 크기가 지원되는 최대 S3 객체 크기를 초과하여 파일을 내보내지 못했습니다. | Amazon S3에서 지원하는 최대 객체 크기는 5TiB입니다. | FileSizeTooLarge |
| KMS 키를 찾을 수 없음 | ERROR | 버킷의 KMS 키를 찾을 수 없어서 S3 버킷 bucket\$1name에 key\$1value 키가 있는 S3 객체의 파일을 내보내지 못했습니다. | AWS KMS key을 찾을 수 없어서 Amazon FSx에서 파일을 내보낼 수 없었습니다. S3 버킷의 AWS 리전과 동일한 키를 사용해야 합니다. KMS 키 생성에 대한 자세한 내용은 AWS Key Management Service 개발자 안내서의 [키 생성](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html)을 참조하세요. | N/A |
| 리소스 사용 중 | ERROR | 다른 프로세스에서 사용 중이므로 파일을 내보내지 못했습니다. | 파일 시스템의 다른 클라이언트가 파일을 수정하고 있었기 때문에 Amazon FSx에서 파일을 내보낼 수 없었습니다. 워크플로에서 파일 쓰기를 완료한 후 작업을 재시도할 수 있습니다. | ResourceBusy |
| 파일이 릴리스됨 | WARN | 내보내기 건너뛰기: 로컬 파일이 릴리스된 상태이고 key\$1value 키가 있는 연결된 S3 객체를 버킷 bucket\$1name에서 찾을 수 없습니다. | Amazon FSx는 파일이 파일 시스템에서 릴리스된 상태였기 때문에 파일을 내보낼 수 없었습니다. | N/A |
| 데이터 리포지토리 경로 불일치 | WARN | 내보내기 건너뛰기: 로컬 파일이 데이터 리포지토리 연결 파일 시스템 경로에 속하지 않습니다. | 객체가 데이터 리포지토리에 연결된 파일 시스템 경로에 속하지 않기 때문에 Amazon FSx에서 내보낼 수 없었습니다. | N/A |
| 내부 오류 | ERROR | 자동 내보내기에서 파일 시스템 객체를 내보내는 동안 내부 오류가 발생했습니다. | 내부(자동 내보내기 또는 Lustre 수준) 오류로 인해 내보내기에 실패했습니다. | N/A |
| 완료 보고서 업로드 실패 | ERROR | 데이터 리포지토리 작업 완료 보고서를 bucket\$1name에 업로드하지 못했습니다. | Amazon FSx가 완료 보고서를 업로드하지 못했습니다. | N/A |
| 완료 보고서 검증 실패 | ERROR | 완료 보고서 경로 report\$1path가 이 파일 시스템과 연결된 데이터 리포지토리에 속하지 않기 때문에 데이터 리포지토리 작업 완료 보고서를 bucket\$1name 버킷에 업로드하지 못했습니다. | 고객이 제공한 S3 경로가 연결된 데이터 리포지토리에 속하지 않기 때문에 Amazon FSx에서 완료 보고서를 업로드하지 못했습니다. | N/A |
## HSM 복원 이벤트
| 오류 유형 | 로그 수준 | 로그 메시지 | 근본 원인: |
| --- | --- | --- | --- |
| 액세스가 거부되었습니다 | ERROR | S3 버킷 bucket\$1name의 S3 객체 object\$1name에 대한 액세스가 거부되어 파일을 복원하지 못했습니다. | HSM 명령을 사용하여 파일을 복원하려고 할 때 Amazon S3에 대한 액세스가 거부되었습니다. S3의 연결된 데이터 리포지토리로부터 복원하기 위해 `s3:HeadObject` 및 `s3:GetObject` 작업을 수행할 권한이 파일 시스템에 있어야 합니다. |
| 지원되지 않는 S3 스토리지 클래스 | WARN | 버킷 bucket\$1name의 S3 객체 object\$1name이 지원되지 않는 S3\$1storage\$1class \$1name에 있기 때문에 파일을 복원하지 못했습니다. | 해당 S3 객체가 S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive와 같이 지원되지 않는 S3 스토리지 클래스에 있기 때문에 Amazon FSx가 파일을 복원할 수 없습니다. `hsm_restore`를 사용하기 전에 먼저 Glacier 스토리지 클래스로부터 객체를 복원해야 합니다. |
| S3 객체를 찾을 수 없음 | ERROR | key\$1value 키가 있는 S3 객체를 S3 버킷 bucket\$1name에서 찾을 수 없어서 파일을 복원하지 못했습니다. | 해당 S3 객체가 데이터 리포지토리에 없기 때문에 Amazon FSx가 파일을 복원할 수 없었습니다. |
| S3 버킷을 찾을 수 없음 | ERROR | S3 버킷 bucket\$1name이 존재하지 않아서 파일을 복원하지 못했습니다. | 연결된 S3 버킷이 더 이상 존재하지 않으므로 Amazon FSx가 파일을 복원할 수 없습니다. |
| 디스크 공간이 가득 참 | ERROR | 파일 시스템에 사용 가능한 스토리지 공간이 없어 파일을 복원하지 못했습니다. | S3로부터 파일 데이터를 복원하려고 시도하는 동안 파일 시스템에 사용 가능한 스토리지 공간이 부족해졌습니다. 파일 시스템의 스토리지 용량을 늘리거나 파일을 릴리스하여 공간을 확보하는 것이 좋습니다. |