Storage Intelligence 문제 해결

이 문서에서는 Storage Intelligence, Storage Insights 인벤토리 보고서, Storage Insights 데이터 세트, 객체 보강(프리뷰), 스토리지 일괄 작업의 일반적인 문제를 해결하는 방법을 설명합니다.

Storage Intelligence 구성 오류

다음 섹션에서는 리소스에 대해 Storage Intelligence를 구성하거나 관리할 때 발생할 수 있는 오류에 대해 설명합니다.

400: 잘못된 버킷 이름

문제: 요청이 The specified bucket is not valid. 메시지와 함께 400 Bad Request를 반환합니다.

해결 방법: 요청이 잘못되었습니다. 요청이 다음 요구사항을 충족하는지 확인합니다.

  • locations/global을 사용합니다. Storage Intelligence는 다른 위치를 지원하지 않습니다.
  • bucket_id_regexes의 버킷 이름 또는 정규 표현식이 유효한지 확인하세요.

다음은 유효한 요청의 예시입니다.

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "edition_config": "STANDARD",
      "filter": {
        "included_cloud_storage_buckets": {
          "bucket_id_regexes": [
            "my-bucket-name",
            "prod-data-.*"
          ]
        }
      }
    }' \
    "https://storage.googleapis.com/v2/projects/PROJECT_ID/locations/global/intelligenceConfig?updateMask=edition_config,filter"

400: 잘못된 인수 - 비어 있는 업데이트 마스크

문제: 구성 또는 업데이트 요청을 전송하면 요청이 400 Bad Request를 반환하고 Empty UPDATE_MASK in the request. 메시지가 표시됩니다.

해결 방법: 요청에 비어 있지 않은 UPDATE_MASK를 제공합니다. UPDATE_MASK는 업데이트할 IntelligenceConfig 리소스의 FieldMask 필드를 쉼표로 구분한 목록을 지정합니다 (예: updateMask=edition_config 또는 updateMask=edition_config,filter).

400: 잘못된 업데이트 마스크 경로

문제: 구성을 업데이트할 때 요청이 400 Bad Request를 Invalid UPDATE_MASK paths. 메시지와 함께 반환합니다.

해결 방법: UPDATE_MASK의 각 필드 이름이 IntelligenceConfig 리소스의 유효한 필드와 일치하는지 확인합니다.

400: 필드를 수정할 수 없음

문제: 구성을 업데이트할 때 요청이 400 Bad Request를 Invalid UPDATE_MASK: UPDATE_TIME field is not editable. 메시지와 함께 반환합니다.

해결 방법: UPDATE_MASK에서 수정할 수 없는 시스템 필드 (예: UPDATE_TIME)를 삭제합니다. IntelligenceConfig에 정의된 변경 가능한 필드만 지정합니다.

400: 잘못된 값

문제: 요청이 Invalid value at storage_intelligence.edition_config. 메시지와 함께 400 Bad Request를 반환합니다.

해결책: edition_config를 지원되는 값(INHERIT, STANDARD, DISABLED)으로 설정합니다.

400: 비어 있지 않은 필터

문제: 요청이 Non-empty filter cannot be specified for INHERIT or DISABLED edition configuration. 메시지와 함께 400 Bad Request를 반환합니다.

해결 방법: 요청에서 버킷 필터를 삭제합니다. edition_config가 INHERIT 또는 DISABLED로 설정된 경우 버킷 필터가 지원되지 않습니다.

400: 필터에서 비어 있는 위치 또는 버킷 값

문제: 요청이 Empty location or bucket values in filter. 메시지와 함께 400 Bad Request를 반환합니다.

해결 방법: 버킷 필터에서 location 및 bucket가 빈 문자열이 아닌지 확인합니다.

Storage Insights 일반적인 문제

이 섹션에서는 인벤토리 보고서 및 데이터 세트의 일반적인 문제를 해결하는 방법을 설명합니다.

매일 여러 인벤토리 보고서가 생성됨

문제: 인벤토리 보고서 구성에서 매일 여러 보고서 파일을 생성합니다.

해결 방법: Cloud Storage는 객체가 1,000,000개 넘게 있는 버킷의 인벤토리 보고서를 샤딩하여 객체 1,000,000개당 샤드 하나를 생성합니다. 예를 들어 객체가 3,500,000개인 버킷은 보고서 샤드 4개와 각 샤드를 나열하는 매니페스트 파일을 생성합니다.

인벤토리 보고서가 대상 버킷에 표시되지 않음

문제: 인벤토리 보고서가 대상 버킷에 표시되지 않습니다.

해결 방법: 보고서가 대상 버킷에 전송되지 않으면 다음을 확인합니다.

  • 구성된 시작일이 지났는지 확인합니다. 자세한 내용은 인벤토리 보고서 구성 만들기를 참조하세요.

  • 인벤토리 보고서 기록을 보고 오류 및 근본 원인을 확인합니다. 인벤토리 보고서 기록을 보려면 다음 단계를 완료합니다.

    1. Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.

      버킷으로 이동

    2. 버킷 목록에서 인벤토리 보고서 구성이 포함된 소스 버킷의 이름을 클릭합니다.

    3. 버킷 세부정보 페이지에서 인벤토리 보고서 탭을 클릭합니다.

    4. 인벤토리 보고서 구성 목록에서 확인하려는 보고서를 생성한 인벤토리 보고서 구성의 UUID를 클릭합니다.

    5. 인벤토리 보고서 기록 섹션에 오류가 있는지 확인합니다. 도움말() 위에 마우스 포인터를 올려놓으면 실패 이유에 대한 세부정보를 볼 수 있습니다.

  • 프로젝트 수준 서비스 에이전트에 인벤토리 보고서를 읽고 쓰는 데 필요한 IAM 역할이 부여되었는지 확인합니다. 자세한 내용은 서비스 에이전트에 필요한 역할 부여를 참조하세요.

인벤토리 보고서 지연

문제: 인벤토리 보고서 생성이 지연됩니다.

해결 방법: 보고서 생성 시간은 다를 수 있습니다. 최대 24시간의 지연은 정상입니다.

데이터 세트가 채워지지 않음

문제: Storage Insights 데이터 세트 테이블이 비어 있습니다.

해결 방법: 연결된 BigQuery 데이터 세트에서 error_attributes_view에 오류 코드가 있는지 확인합니다. 자세한 내용은 데이터 세트 오류 문제 해결을 참조하세요.

데이터 세트를 쿼리할 때 'ref' 열의 null 값

문제: BigQuery에서 Storage Insights 데이터 세트를 쿼리할 때 ref 열이 null를 반환합니다.

해결 방법: /로 끝나는 객체의 경우 데이터 세트의 ref 열이 null입니다.

BigQuery에서 Storage Insights 데이터 세트를 쿼리할 때 ref 열이 null 값을 반환하는 경우 BigQuery를 사용하여 객체 데이터 및 메타데이터 분석에 설명된 대로 Cloud Storage 리소스에 대한 액세스 권한을 포함하여 필요한 연결 권한과 역할을 부여했는지 확인하세요.

객체 보강 오류

이 섹션에서는 객체 보강을 구성, 생성 또는 쿼리할 때 발생하는 일반적인 문제를 해결하는 방법을 설명합니다.

객체에 보강이 누락됨

문제: 객체 보강을 구성한 후 객체에 객체 보강이 표시되지 않습니다.

해결 방법: 다음을 확인합니다.

  • 서비스 에이전트 권한: 객체 보강 서비스 에이전트에 대상 버킷 (또는 프로젝트)에 대한 roles/storage.annotationGeneratorService 역할과 프로젝트에 대한 roles/storage.bucketViewer 역할을 부여해야 합니다. 자세한 내용은 서비스 에이전트에 권한 부여를 참조하세요.
  • 필터 및 범위 구성: FeatureConfig 리소스에 대상 버킷 이름이 명시적으로 포함되어 있는지 확인합니다. Cloud Storage는 FeatureConfig 리소스를 만든 후 생성된 버킷을 자동으로 포함하지 않습니다. 또한 버킷을 삭제하고 다시 만들거나 재배치하는 경우 FeatureConfig 리소스를 업데이트하여 다시 포함해야 합니다.
  • 모델 기본 요건 및 Content-Type 메타데이터: 객체가 사용 설정된 모델의 콘텐츠 유형 및 크기 제한을 충족하는지 확인합니다. Cloud Storage는 객체의 Content-Type 메타데이터 필드를 사용하여 적격성을 확인합니다 (이미지의 경우 BMP, GIF, ICO, JPEG, PNG, TIFF 또는 WEBP, PDF 분류의 경우 application/pdf). Content-Type 메타데이터가 누락되었거나 잘못된 경우 Cloud Storage는 메타데이터를 업데이트할 때까지 객체를 처리하지 않습니다. 또한 객체 보강 서비스는 20MiB보다 큰 객체를 건너뜁니다. 자세한 내용은 지원되는 모델 및 스키마를 참조하세요.
  • 처리 지연 시간: 비동기 처리에 충분한 시간을 허용합니다. 객체 보강 서비스는 객체를 비동기식으로 처리합니다. 새로 업로드된 객체의 보강은 일반적으로 몇 시간 이내에 표시됩니다. 반면 대규모 버킷의 기존 객체를 백필하는 데는 몇 시간 또는 며칠이 걸릴 수 있습니다.

BigQuery에 객체 보강이 표시되지 않음

문제: 객체 보강이 API에 표시되지만 BigQuery에는 표시되지 않습니다.

해결 방법: 다음을 확인합니다.

  • Storage Insights 데이터 세트 구성: 버킷에 대해 Storage Insights 데이터 세트를 구성했는지 확인합니다.
  • 일일 보고서 예약: 일일 데이터 세트 업데이트를 기다립니다. Storage Insights 데이터 세트는 24시간마다 업데이트됩니다. 따라서 새로 생성된 보강 정보가 BigQuery의 object_contexts_catalog_view 뷰에 표시되는 데 최대 24시간이 걸릴 수 있습니다.
  • IAM 권한: BigQuery에서 작업을 실행하고 데이터를 읽을 수 있는 권한 (예: roles/bigquery.jobUser 및 roles/bigquery.dataViewer)이 있는지 확인합니다. 쿼리 안내는 BigQuery에서 객체 보강 분석을 참조하세요.

확장된 객체 보강 데이터를 가져올 때 권한이 거부되었습니다.

문제: 확장된 객체 보강 데이터를 가져올 때 권한 오류가 발생합니다.

해결 방법: 경계 상자 좌표 또는 카테고리 신뢰도 점수와 같은 확장 데이터를 검색하려면 객체 또는 버킷에 대한 storage.objects.viewFullContext 권한이 있어야 합니다. 스토리지 객체 사용자(roles/storage.objectUser) 및 스토리지 관리자 (roles/storage.admin)와 같은 역할에 이 권한이 포함됩니다. 자세한 내용은 객체 보강 관리를 참조하세요.

기능 구성을 관리할 때 권한이 거부됨

문제: FeatureConfig를 만들거나 업데이트하거나 삭제할 때 권한 오류가 발생합니다.

해결책: 계정에 대상 프로젝트에 대한 필요한 권한이 있는 스토리지 관리자(roles/storage.admin) 역할 또는 커스텀 역할이 있는지 확인합니다. 이러한 필수 권한에는 storage.featureConfigs.create, storage.featureConfigs.update 또는 storage.featureConfigs.delete가 포함됩니다. 메서드별 권한은 객체 보강 구성 및 featureConfigs API 리소스를 참조하세요.

스토리지 일괄 작업 유효성 검사 오류

이 섹션에서는 storagebatchoperations.googleapis.com에 일괄 작업 요청을 제출할 때 발생하는 유효성 검사 오류를 설명합니다.

400: 잘못된 작업 ID 또는 리소스 이름

문제: 작업 생성 요청이 JOB_ID_INVALID 또는 RESOURCE_NAME_TOO_LONG 이유와 함께 400 Bad Request(INVALID_ARGUMENT) 응답을 반환합니다.

해결 방법: 작업 ID가 1~63자의 소문자 영숫자 문자 또는 하이픈 ([a-z0-9]([-a-z0-9]*[a-z0-9])?)으로 구성되어 있고 전체 작업 리소스 경로 (projects/PROJECT_ID/locations/LOCATION/jobs/JOB_ID)가 200바이트를 초과하지 않는지 확인합니다. 경로가 200바이트를 초과하면 작업 ID를 줄입니다. 자세한 내용은 작업 이름을 참조하세요.

400: 작업 설명이 한도를 초과함

문제: 작업 생성 요청이 DESCRIPTION_TOO_LONG 이유와 함께 400 Bad Request(INVALID_ARGUMENT) 응답을 반환합니다.

해결 방법: 작업 설명이 1,024바이트 이하인지 확인합니다. 이 한도를 초과하면 텍스트를 줄입니다. 자세한 내용은 작업 설명을 참조하세요.

400: 작업 소스 구성이 누락되었거나 잘못됨

문제: 작업 생성 요청이 다음 이유 중 하나와 함께 400 Bad Request(INVALID_ARGUMENT) 응답을 반환합니다.

  • SOURCE_NOT_SPECIFIED
  • BUCKET_LIST_EMPTY
  • TOO_MANY_BUCKETS
  • MULTI_BUCKET_NOT_SUPPORTED
  • BUCKET_NAME_REQUIRED
  • OBJECT_CONFIGURATION_REQUIRED

해결책: 작업에서 유효한 소스 구성(bucket_list 또는 project_source)을 지정하고 각 버킷에서 객체 선택 방법을 정의하는지 확인합니다. 자세한 내용은 일괄 작업 만들기 및 관리를 참조하세요.

400: 잘못된 버킷 또는 객체 이름

문제: 작업 생성 요청이 BUCKET_NAME_INVALID 또는 OBJECT_NAME_INVALID 이유와 함께 400 Bad Request(INVALID_ARGUMENT) 응답을 반환합니다.

해결 방법: 모든 버킷 및 객체 이름이 Cloud Storage 이름 지정 요구사항을 준수하는지 확인합니다. 자세한 내용은 버킷 이름 지정 가이드라인 및 객체 이름 지정 가이드라인을 참조하세요.

400: 프로젝트 소스 구성 오류

문제: 작업 생성 요청이 다음 이유 중 하나와 함께 400 Bad Request(INVALID_ARGUMENT) 응답을 반환합니다.

  • PROJECT_SOURCE_PROJECT_INVALID
  • PROJECT_SOURCE_DRY_RUN_FIELDS_EXCLUSIVE
  • PROJECT_SOURCE_DRY_RUN_ID_INVALID

해결 방법: 프로젝트 소스 구성이 형식 및 필드 독점 요구사항을 충족하는지 확인합니다. 테스트 실행 작업 ID를 지정하는 경우 다른 모든 project_source 매개변수를 생략합니다. 자세한 내용은 고급 필터를 사용하여 작업 만들기를 참조하세요.

400: 변환 매개변수가 충돌하거나 누락됨

문제: 작업 생성 요청이 다음 이유 중 하나와 함께 400 Bad Request(INVALID_ARGUMENT) 응답을 반환합니다.

  • TRANSFORMATION_NOT_SPECIFIED
  • REWRITE_OBJECT_MISSING_PARAMETERS
  • PUT_OBJECT_HOLD_MISSING_PARAMETERS
  • PUT_METADATA_MISSING_PARAMETERS

해결 방법: 모든 필수 매개변수와 함께 정확히 하나의 변환 유형을 지정합니다. 객체 보관을 구성하는 경우 버킷에 객체 잠금이 사용 설정되어 있고 타임스탬프가 RFC 3339 UTC 형식을 사용하는지 확인합니다. 변환별 파라미터 요구사항에 대한 자세한 내용은 작업 유형을 참조하세요.

400: 중복되는 객체 프리픽스

문제: 작업 생성 요청이 OBJECT_PREFIX_OVERLAP 또는 DUPLICATE_OBJECT_PREFIX 이유와 함께 400 Bad Request(INVALID_ARGUMENT) 응답을 반환합니다.

해결 방법: 중복 프리픽스를 삭제하고 included_object_prefixes의 프리픽스가 목록의 다른 항목의 프리픽스가 아닌지 확인합니다. 자세한 내용은 객체 프리픽스를 참조하세요.

400: 매니페스트 파일 형식 및 액세스 문제

문제: 작업 생성 요청이 MANIFEST_LOCATION_REQUIRED 또는 MANIFEST_LOCATION_INVALID 이유와 함께 400 Bad Request(INVALID_ARGUMENT) 응답을 반환하거나 작업이 매니페스트를 읽을 수 없습니다.

해결 방법: 매니페스트 URI가 유효한 CSV 경로(gs://<bucket_name>/<path>/<object_name>.csv)이고 스토리지 일괄 작업 서비스 에이전트에 매니페스트 버킷에 대한 roles/storage.objectViewer 역할이 있는지 확인합니다. CSV 형식 및 스키마 요구사항에 대한 자세한 내용은 매니페스트를 참조하세요.

400: Storage Insights 데이터 세트 탐색 오류

문제: 객체 검색에 Storage Insights 데이터 세트를 사용하면 다음 이유 중 하나로 400 Bad Request (INVALID_ARGUMENT 또는 FAILED_PRECONDITION) 응답이 반환됩니다.

  • BUCKET_DISCOVERY_SNAPSHOT_TOO_OLD
  • TARGET_LOCATIONS_REQUIRED_FOR_SNAPSHOT_TIME
  • BUCKET_DISCOVERY_TOO_MANY_BUCKETS

해결 방법: snapshot_time가 지난 48시간 이내인지 확인하고 버킷에 target_locations를 지정하고 탐색 쿼리가 1,000개 이하의 버킷과 일치하는지 확인합니다. 자세한 내용은 Storage Insights 데이터 세트를 사용하여 매니페스트 만들기를 참조하세요.

400: 자동 클래스가 사용 설정된 버킷에서 스토리지 클래스 변환 실패

문제: 작업 생성 요청이 AUTOCLASS_STORAGE_CLASS_TRANSFORMATION_UNSUPPORTED 이유와 함께 400 Bad Request(FAILED_PRECONDITION) 응답을 반환합니다.

해결 방법: 자동 클래스가 사용 설정된 버킷에서는 스토리지 클래스 변환을 실행할 수 없습니다. 자동 클래스가 없는 버킷을 타겟팅하거나 스토리지 클래스 변환을 삭제하세요. 자세한 내용은 자동 클래스 제한사항을 참조하세요.

400: 균일한 버킷 수준 액세스 버킷에서 객체 ACL 업데이트 실패

문제: 작업 생성 요청이 UBLA_OBJECT_ACL_UPDATE_UNSUPPORTED 이유와 함께 400 Bad Request(FAILED_PRECONDITION) 응답을 반환합니다.

해결 방법: 균일한 버킷 수준 액세스가 사용 설정된 버킷에서는 객체 ACL을 업데이트할 수 없습니다. 대신 버킷 또는 프로젝트 수준에서 IAM 역할을 사용하여 액세스를 관리하세요. 자세한 내용은 균일한 버킷 수준 액세스를 참조하세요.

스토리지 일괄 작업 런타임 및 실행 문제

이 섹션에서는 일괄 작업의 비동기 실행 중에 발생하는 문제를 설명합니다.

403: 실행 중 권한 오류

문제: 일괄 작업이 실행 중에 403 Forbidden(PERMISSION_DENIED) 오류로 인해 실패합니다.

해결 방법: 스토리지 일괄 작업 서비스 에이전트(service-PROJECT_NUMBER@gcp-sa-storagebatchoperations.iam.gserviceaccount.com)에 변환 유형에 필요한 IAM 역할을 부여합니다. 자세한 내용은 서비스 에이전트에 권한 부여를 참조하세요.

객체 다시 쓰기 중 CMEK 암호화 오류

문제: Cloud KMS 키 상태 또는 권한 오류로 인해 400 Bad Request 또는 403 Forbidden과 함께 객체 재작성이 실패합니다.

해결책: Cloud KMS 키가 Enabled이고 대상 버킷과 동일한 리전에 있으며 서비스 에이전트에 roles/cloudkms.cryptoKeyEncrypterDecrypter 역할이 있는지 확인합니다. 자세한 내용은 작업 유형: 객체 다시 쓰기를 참조하세요.

error_summaries의 높은 실패 횟수

문제: 일괄 작업이 0이 아닌 counters.failed_object_count 및 error_summaries의 오류 코드 (예: 404 NOT_FOUND, 412 FAILED_PRECONDITION, 403 PERMISSION_DENIED)로 완료됩니다.

해결 방법: --location 플래그 (예: gcloud storage batch-operations jobs describe JOB_ID --location=LOCATION)를 사용하여 gcloud storage batch-operations jobs describe를 실행하여 집계된 오류 분석을 확인하고 Cloud Logging에서 객체별 오류 로그를 확인합니다. 자세한 내용은 작업 세부정보 가져오기를 참조하세요.

2일이 지난 스냅샷으로 인해 스토리지 일괄 작업이 실패함

문제: CEL 필터 기반 스토리지 일괄 작업을 만들면 작업 생성이 실패합니다. 스냅샷 시간이 2일이 지났다는 오류 메시지가 표시됩니다.

해결 방법: 오래된 객체 상태에 대한 작업을 방지하기 위해 스토리지 일괄 작업은 작업 생성을 자동으로 실패 처리합니다. 이 오류는 선택한 스냅샷이 2일보다 오래된 경우에 발생합니다. 이 문제를 해결하려면 다음 방법 중 하나를 선택합니다.

  • 매니페스트 파일 사용: BigQuery에서 데이터 세트를 수동으로 쿼리합니다. 결과를 CSV 매니페스트 파일로 내보내고 파일을 Cloud Storage 버킷에 업로드합니다. 그런 다음 매니페스트 메서드를 사용하여 일괄 작업 작업을 만들어 이틀 제한을 피할 수 있습니다.
  • 데이터 세트 구성 확인: 데이터 세트 구성이 활성 상태이고 일시중지되지 않았는지 확인합니다. 데이터 세트 스냅샷이 성공적으로 실행되는지 확인합니다. 구성을 확인하는 방법은 데이터 세트 구성 보기를 참조하세요.
  • 타겟 위치 및 스냅샷 시간 재정의 사용: RFC 3339 형식의 스냅샷을 명시적으로 선택하여 2일간의 비활성 실패를 우회하려면 --target-snapshot-time 플래그를 지정합니다. --target-locations 플래그를 지정하여 스냅샷이 있는 위치로 작업을 제한합니다. 이러한 재정의를 사용하여 자동 전역 스냅샷이 업데이트되지 않는 동기화 지연을 해결할 수 있습니다. 따라서 더 최근의 리전 스냅샷을 수동으로 타겟팅할 수 있습니다. 명령어 문법은 고급 필터를 사용하여 작업 만들기를 참조하세요.

새로 구독한 프로젝트에서 CEL 필터 기반 스토리지 일괄 작업이 실패함

문제: 시스템에서 유효한 스냅샷을 찾을 수 없으므로 새로 구독한 프로젝트에서 CEL 필터 기반 스토리지 일괄 작업 작업을 실행하면 실패합니다.

해결 방법: Storage Intelligence 구독을 사용 설정한 후 24시간이 지나야 CEL 필터 기반 스토리지 일괄 작업 작업을 실행할 수 있습니다. 이 지연 시간 동안 시스템은 초기 메타데이터 스냅샷을 수행하고 시작 스냅샷 시간을 설정할 수 있습니다.

CEL 필터 기반 스토리지 일괄 작업이 권한 오류로 인해 실패하거나 런타임 오류가 발생함

문제: CEL 필터 기반 스토리지 일괄 작업이 실행 중에 실패하거나 런타임 권한 오류를 반환합니다.

해결 방법: 스토리지 일괄 작업은 사용자 인증 정보를 사용하여 객체를 처리합니다. 대상 버킷 및 객체에 필요한 IAM 리더 또는 쓰기 권한이 없으면 작업이 실패합니다. 이 문제는 CEL 필터가 액세스 권한이 없는 리소스를 선택할 때 발생합니다. 계정에 작업 범위 내의 모든 버킷 및 객체에 대한 스토리지 관리자 (roles/storage.admin), 스토리지 객체 관리자 (roles/storage.objectAdmin) 또는 이와 동등한 역할이 있는지 확인합니다. 역할을 부여하는 방법은 IAM 권한 사용을 참조하세요.

모니터링 및 로그 분석

Cloud Logging에서 객체별 실행 실패 및 오류 페이로드를 검사하는 방법에 대한 자세한 내용은 스토리지 일괄 작업 로그 보기를 참조하세요.

Storage Intelligence 어드바이저 문제

이 섹션에서는 Storage Intelligence Advisor를 사용할 때 자주 발생하는 문제를 해결하는 방법을 안내합니다.

Storage Intelligence 어드바이저 권한 거부 오류

문제: Storage Intelligence Advisor에 액세스할 때 Permission denied 오류가 발생하고 차트와 측정항목이 비어 있거나 권한 오류가 표시됩니다.

해결 방법: 이 문제는 Storage Intelligence Advisor를 보는 데 필요한 권한이 있는 IAM 역할이 없는 경우에 발생합니다. 관리자에게 보려는 프로젝트, 폴더 또는 조직에 대한 스토리지 관리자 (roles/storage.admin) 역할을 부여해 달라고 요청하세요. 필수 권한 목록은 필수 역할을 참조하세요.

영향을 받는 프로젝트를 볼 권한이 없습니다.

문제: 조직 또는 폴더 수준에서 발견 항목을 볼 때 발견 항목이 감지된 프로젝트 패널에 프로젝트 옆에 You've insufficient permission to access this project 메시지와 함께 경고 표시기가 표시됩니다.

해결 방법: 이 문제는 조직 또는 폴더 수준에서 Storage Intelligence Advisor를 볼 수 있는 권한이 있지만 해당 프로젝트에 필요한 IAM 권한이 없는 경우에 발생합니다. 프로젝트 관리자에게 영향을 받는 프로젝트에 대한 스토리지 관리자 (roles/storage.admin) 역할을 부여해 달라고 요청합니다.

Storage Intelligence 어드바이저가 비어 있거나 데이터가 누락됨

문제: Storage Intelligence Advisor 페이지가 로드되고, 선택한 리소스에 따라 프로젝트 한눈에 보기, 폴더 한눈에 보기 또는 조직 한눈에 보기로 라벨이 지정된 한눈에 보기 섹션의 차트, 측정항목 또는 주요 발견 사항 섹션이 비어 있거나 데이터가 오래되었습니다.

해결 방법: 이 문제는 다음과 같은 경우에 발생할 수 있습니다.

  • 데이터 처리 지연 시간: Storage Intelligence 측정항목 및 발견 항목은 일일 스냅샷과 스토리지 사용량 분석을 기반으로 합니다. 데이터가 Storage Intelligence 어드바이저에 표시되는 데 24~48시간이 걸릴 수 있습니다. 이러한 지연은 일반적으로 새 버킷을 만들거나 Storage Intelligence Advisor를 처음 볼 때 발생합니다. 최근 활동 데이터가 표시될 것으로 예상되는 경우 48시간 후에 다시 확인하세요.
  • 스토리지 리소스 없음: 선택한 프로젝트, 폴더 또는 조직에 선택한 기간의 버킷이나 객체가 포함되어 있지 않으면 Storage Intelligence 어드바이저가 비어 있습니다. 스토리지 리소스가 포함된 다른 프로젝트, 폴더 또는 조직을 선택하세요.
  • 잘못된 시간 필터: 시간 필터가 스토리지 활동이 발생하지 않은 범위로 설정되어 있습니다. 시간 필터를 스토리지 활동이 포함된 범위로 조정합니다.

Storage Intelligence 어드바이저에 발견 사항이 표시되지 않음

문제: 최근 스토리지 활동을 기반으로 주요 발견 항목 섹션에 발견 항목이 표시될 것으로 예상되지만 섹션이 비어 있습니다.

해결 방법: 이 문제는 Storage Intelligence Advisor가 선택한 기간에 대한 발견 항목을 생성하지 않는 경우에 발생합니다. 발견 항목이 없는 이유는 다음과 같습니다.

  • 일치하는 패턴 없음: 최근 분석 주기에서 발견 항목 패턴과 일치하는 스토리지 동작이 감지되지 않았습니다.
  • 데이터 처리 지연: 발견 항목은 스토리지 측정항목을 기반으로 하며, 처리하는 데 24~48시간이 걸립니다. 지난 24시간 동안 발생한 이벤트의 발견 항목은 다음 처리 주기가 완료된 후에 표시됩니다.

VPC 서비스 제어 사용 시 문제

문제: VPC 서비스 제어 서비스 경계 내의 프로젝트에서 Storage Intelligence Advisor에 액세스하려고 하면 액세스 거부 또는 권한 오류가 발생합니다.

해결 방법: 이 문제는 프로젝트, Google Cloud 콘솔, Storage Intelligence 리소스 간의 통신을 허용하도록 VPC 서비스 제어가 올바르게 구성되지 않은 경우에 발생합니다. 이 문제를 해결하려면 다음 요구사항을 검토하세요.

  • 제한된 서비스: 서비스 경계가 Cloud Storage API (storage.googleapis.com) 및 Storage Insights (storageinsights.googleapis.com) API를 제한하는지 확인합니다. 자세한 내용은 서비스 매개변수 나열 및 설명을 참조하세요.
  • 경계 구성: Storage Intelligence Advisor를 보는 데 사용하는 프로젝트가 모니터링하는 프로젝트와 동일한 서비스 경계에 있는지 확인합니다. 서로 다른 경계에 있는 경우 인그레스 및 이그레스 규칙을 구성하거나 경계 브리지를 사용해야 합니다.
  • 경계 외부에서 액세스: 경계 외부의 네트워크에서 Google Cloud 콘솔에 액세스하는 경우 사용자 계정과 사용 중인 공개 IP 주소 범위를 포함하는 인그레스 규칙 또는 액세스 수준을 만들어야 합니다.
  • 공유 VPC: 공유 VPC를 사용하는 경우 프로젝트가 서비스 프로젝트와 동일한 서비스 경계에 있는지 확인합니다. 자세한 내용은 공유 VPC를 참조하세요.
  • 감사 로그: 위반 분석기를 사용하여 감사 로그에서 VPC 서비스 제어 위반을 확인합니다. 위반 분석 도구를 사용하면 위반을 진단하고 RESOURCES_NOT_IN_SAME_SERVICE_PERIMETER 오류와 같은 원인을 파악할 수 있습니다.

다음 단계