이 페이지에서는 Cloud Storage 구독에 대한 일반적인 문제 해결 팁을 제공합니다.
Cloud Storage 구독 상태 확인
구독 상태를 확인하려면 다음 단계를 수행하세요.
Google Cloud 콘솔에서 Pub/Sub 구독 페이지로 이동합니다.
Cloud Storage 구독의 상태 아이콘을 확인합니다.
아이콘이 녹색 체크표시이면 구독이 정상입니다.
아이콘이 빨간색 느낌표면 구독이 오류 상태입니다.
Cloud Storage 구독을 클릭합니다.
구독 세부정보 페이지가 열립니다.
구독 상태에서 오류 메시지를 확인합니다.
오류 메시지에 따라 문제 해결을 위해 이 페이지의 관련 섹션으로 이동합니다.
문제가 해결되면 구독이 결국 정상 상태로 돌아갑니다.
구독을 만들거나 업데이트할 수 없음
다음은 Cloud Storage 구독을 만들거나 업데이트할 때 발생하는 일반적인 문제에 대한 설명입니다.
버킷을 찾을 수 없음 오류
구독 만들기 또는 업데이트 워크플로에 지정한 버킷이 존재하지 않으면 워크플로가 bucket not found 오류를 반환합니다.
Google Cloud 콘솔에서 다음과 비슷한 메시지가 표시됩니다.
The Cloud Storage bucket specified cannot be found.
이 문제를 해결하려면 버킷을 create 기존 버킷을 사용하도록 Cloud Storage 구독을 업데이트합니다.
서비스 계정 오류
올바른 권한을 사용해서 Pub/Sub 서비스 계정을 구성하지 않은 경우 구독 만들기 또는 업데이트 워크플로로 오류가 반환됩니다. Google Cloud 콘솔에서 다음과 비슷한 메시지가 표시됩니다.
Cloud Pub/Sub did not have the necessary permissions configured to access
the provided bucket my-bucket (or the bucket may not exist).
Please verify that the service account
service-112233445566@gcp-sa-pubsub.iam.gserviceaccount.com
was granted the Storage Legacy Bucket Reader and Storage Object Creator
roles for the provided bucket.
문제를 해결하려면 서비스 계정에 올바른 권한이 있는지 확인합니다.
구독 상태가 빨간색 느낌표로 표시됨
구독을 만든 후 버킷을 수정하면 Pub/Sub의 버킷 메시지 작성 방법에 영향을 줄 수 있습니다. 변경으로 인해 문제가 발생하면 구독 상태 필드가 오류 상태로 설정됩니다.
구독 세부정보 페이지에서 Subscription state 필드 상태를 확인합니다.
Subscription state 필드는 다음 중 하나일 수 있는 보다 구체적인 오류를 제공합니다.
버킷을 찾을 수 없음: 버킷이 삭제되었습니다. 버킷을 다시 만들거나 기존 버킷을 사용하도록 구독을 업데이트합니다.
버킷 권한 거부됨: Pub/Sub 서비스 계정에 더 이상 버킷에 쓰기 권한이 없습니다. 서비스 계정에 올바른 권한이 있는지 확인합니다.
Pub/Sub 구독이 오류 상태이면 메시지가 버킷에 작성되지 않고 구독 백로그에 유지됩니다. 메시지는 구성된 경우 연결된 데드 레터 주제로 전송되지 않습니다. 확인되지 않은 메시지는 message_retention_duration에 설정된 기간(기본적으로 7일) 동안 보관됩니다.
구독의 메시지 처리 속도가 매우 느림
일부 구독 설정으로 인해 메시지 처리 속도가 느려질 수 있습니다.
예를 들어 Cloud Storage 구독에서 메시지 순서 지정을 사용 설정하면 메시지가 Cloud Storage에 쓰여지지만 동일한 순서 지정 키가 있는 후속 메시지를 지연시키기 위해 완료되지 않을 수 있습니다. 성능 향상을 위해 메시지를 게시할 때 더 넓은 범위의 순서 지정 키를 사용하거나 사용 사례에 필요하지 않은 경우 메시지 순서 지정을 중지하는 것이 좋습니다.
또한 Cloud Storage 구독의 최대 파일 크기를 너무 낮게 설정하면 성능에 부정적인 영향을 미칠 수 있습니다. 최대 파일 크기가 너무 낮으면 Pub/Sub가 각 객체에 소량의 메시지만 포함된 많은 Cloud Storage 객체를 만들 수 있습니다. 객체 생성 및 마무리에 따른 추가적인 오버헤드로 인해 메시지 처리 속도가 느려집니다. 성능 향상을 위해서는 Cloud Storage 구독의 최대 파일 크기 설정을 늘리거나 파일 크기 제한을 없애는 것이 좋습니다.
할당량 제한사항
또 다른 가능성은 프로젝트가 Pub/Sub push 처리량 할당량(pubsub.googleapis.com/regionalpushsubscriber)에 도달한 경우입니다. 할당량 제한에 도달했는지 확인하려면 push 요청 측정항목(subscription/push_request_count)에서 resource_exhausted 오류를 조사합니다.
프로젝트 할당량을 검토하고 남은 할당량이 충분한지 확인합니다. Pub/Sub 구독이 포함된 프로젝트 내에서 IAM 및 관리자 > 할당량으로 이동합니다. pubsub.googleapis.com/regionalpushsubscriber 할당량을 검색합니다. 할당량 한도에 도달하면 할당량 상향을 요청할 수 있습니다.
구독에서 예상보다 많은 파일 생성
확장성을 높이기 위해 Cloud Storage 구독은 여러 Pub/Sub 백엔드에서 처리할 수 있습니다. 각 백엔드가 개별 Cloud Storage 파일에 쓰기를 수행하므로 특히 처리량이 낮은 워크로드의 경우 Cloud Storage에서 예상보다 많은 파일이 생성되는 것을 볼 수 있습니다.
이는 정상입니다. 구독으로 생성된 파일 수를 줄이려면 구독에서 파일 일괄 처리 설정을 늘려 더 큰 파일을 사용할 수 있습니다. 또한 이를 더 적은 개수의 큰 파일로 구성하여 파일을 후처리할 수 있습니다.
다음 단계
- Cloud Storage 구독 문제가 계속되면 지원 받기를 참조하세요.