Cloud Storage 가져오기 주제 문제 해결

이 문서에서는 Cloud Storage 가져오기 주제에 대한 일반적인 문제 해결 팁을 제공합니다.

가져오기 주제를 구성하고 메시지 수집을 시작한 후 관련 Cloud Monitoring 측정항목을 확인하여 데이터가 수집되었는지 확인할 수 있습니다. 다음 단계를 수행합니다.

  1. Console에서 주제 페이지로 이동합니다.

    주제로 이동

  2. 문제를 해결하려는 Cloud Storage 가져오기 주제를 클릭합니다.

  3. 주제 세부정보 페이지에서 측정항목 탭을 클릭합니다.

  4. 차트에서 수집 바이트 수 측정항목을 확인합니다.

  5. 수집 중인 데이터가 없으면 주제 세부정보 페이지에서 주제 상태 필드에 오류와 빨간색 느낌표가 있는지 확인합니다.

  6. 수집 데이터 소스 상태 측정항목을 확인할 수도 있습니다. 이렇게 하려면 주제 세부정보 페이지에서 측정항목 탭을 클릭합니다.

    이러한 측정항목에 대한 자세한 내용은 가져오기 주제를 모니터링하는 측정항목을 참고하세요.

  7. 다음은 발생할 수 있는 오류 목록입니다.

    오류 코드 설명 수정
    CLOUD_STORAGE_PERMISSION_DENIED 권한 문제로 인해 Cloud Storage 데이터를 사용하는 중에 오류가 발생했습니다. Pub/Sub 서비스 계정에 Cloud Storage 버킷에 액세스하는 데 필요한 권한이 있는지 확인합니다. 서비스 계정에 다음 권한이 있는지 확인합니다.
    • storage.objects.list: 버킷의 객체를 나열합니다.
    • storage.objects.get: 버킷의 객체를 읽습니다.
    • storage.buckets.get: 버킷 위치와 버킷이 존재하는지 확인합니다.

    자세한 내용은 Cloud Storage 주제 만들기의 기본 요건을 참고하세요.

    PUBLISH_PERMISSION_DENIED 권한 문제로 인해 주제에 게시하는 중에 오류가 발생했습니다. Pub/Sub 서비스 계정에 필요한 게시 권한을 부여합니다. 자세한 내용은 Pub/Sub 서비스 계정에 Pub/Sub 게시자 역할 추가를 참조하세요.
    BUCKET_NOT_FOUND 지정된 Cloud Storage 버킷을 찾을 수 없습니다. 버킷 이름이 정확한지 확인합니다.
    TOO_MANY_OBJECTS Cloud Storage 버킷에 객체가 너무 많아 처리가 일시중지되었습니다. 버킷의 객체 수가 5,000만 개 미만이 되면 처리가 재개됩니다. 객체 한도는 5,000만 개입니다. 버킷의 객체 수를 줄이거나 Google Cloud 지원팀에 문의하세요.

이 시점까지 오류가 없으면 정상 게시자 유지의 권장사항을 확인하세요.

Cloud Storage 가져오기 주제에 플랫폼 로그를 사용 설정할 수도 있습니다. 이러한 로그는 Pub/Sub 가져오기 주제에 객체를 처리하는 데 문제가 있을 때 문제를 해결하는 데 도움이 됩니다.