다음 표에는 다양한 문제와 오류 상태 코드가 나와 있으며, 그 원인과 배포를 완화하기 위해 취할 수 있는 조치도 나와 있습니다. 집계 서비스의 전체 오류 사양 및 완화를 확인하려면 현재 공개 가이드를 확인하세요.
가이드 주제:
권한 및 승인 오류
문제 | 공개 클라우드 프로젝트에 terraform plan 또는 terraform apply 를 실행할 때 권한 문제가 발생합니다. |
---|---|
오류 예시 | Error: UnauthorizedOperation: You are not authorized to perform this operation. |
해상도 |
사용 중인 퍼블릭 클라우드의 CLI (명령줄 인터페이스)에 올바르게 인증되었는지 확인합니다. Amazon Web ServicesAWS에서는 집계 서비스에 필요한 인스턴스 및 기타 서비스를 만들 수 있는 사용자 권한이 필요합니다. 이를 적용하면 문제없이 Terraform 계획을 실행하고 적용할 수 있습니다. Google Cloud PlatformGoogle Cloud에서는 Terraform의 후반부를 배포하려면 서비스 계정을 가장해야 합니다. 배포 서비스 계정에 리소스를 만드는 데 필요한 모든 권한이 있으므로 이 단계를 건너뛰면 terraform apply 명령어가 실패할 수 있습니다. GitHub 문서의 '배포 환경 설정' 4단계를 참고하세요. |
개인 정보 보호 예산 오류
오류 | PRIVACY_BUDGET_ERROR |
---|---|
원인 | 이는 개인 정보 보호 예산 서비스의 오류로 인해 서비스에서 보고서를 처리할 수 없음을 나타냅니다. |
확인 | 작업을 다시 시도하여 오류가 간헐적으로 발생하는지 확인한 후 기술 지원 양식을 통해 문의해 주세요. |
오류 | PRIVACY_BUDGET_AUTHORIZATION_ERROR |
---|---|
원인 | 온보딩 중에 제공한 것과 다른 보고 출처를 사용하고 있을 수 있습니다. |
확인 |
사이트가 온보딩된 사이트와 일치하거나 그 하위 도메인이어야 합니다. 집계 서비스 온보딩은 최상위 도메인에서 처리되며 최상위 도메인이 온보딩되면 모든 하위 도메인이 집계 서비스를 사용할 수 있습니다. |
오류 | PRIVACY_BUDGET_AUTHENTICATION_ERROR |
---|---|
원인 | 오래되었거나 잘못된 ARN을 사용하고 있을 수 있습니다. |
확인 |
Google Cloud Platform
집계 서비스 배포에 사용 중인 서비스 계정이 온보딩 중에 제공된 서비스 계정과 일치하는지 확인합니다. 동일한 프로젝트에 속하는 것뿐만 아니라 정확히 일치해야 합니다. Amazon Web Services이메일을 통해 제공된 동일한 코디네이터를 사용하고 계실 것으로 예상됩니다. 그래도 문제가 해결되지 않으면 auto.tfvars 파일과 보고 출처 정보를 수집한 후 기술 지원 양식을 통해 Google에 문의하세요. |
오류 | PRIVACY_BUDGET_EXHAUSTED |
---|---|
원인 |
오류:
"result_info": {
"return_code": "PRIVACY_BUDGET_EXHAUSTED",
"return_message": "com.google.aggregate.adtech.worker.exceptions.AggregationJobProcessException:
Insufficient privacy budget for one or more aggregatable reports. No aggregatable report can appear
in more than one aggregation job. Information related to reports that do not have budget can be
found in the following file:
File path: 공유 ID가 이전에 성공적으로 처리된 일괄 처리에 이미 포함된 보고서를 일괄 처리하려고 하면 개인 정보 보호 예산 소진 문제가 발생합니다. 이 오류는 집계 가능한 보고서가 단일 일괄 처리에만 표시되고 하나의 요약 보고서에만 기여할 수 있는 '중복 없음' 규칙으로 인해 발생합니다. 각 보고서에는 |
확인 |
작업 응답에서 제공되는 개인 정보 보호 예산 소진 지원을 사용하여 오류를 검사하고 해결해 보시기 바랍니다. 이렇게 하면 오류의 원인이 된 보고서를 확인할 수 있는 새 도우미 JSON 파일이 제공됩니다. 올바르게 일괄 처리하는 경우 예산을 복구할 수 있습니다 (설명). 설명을 읽고 양식을 작성하도록 안내하되 예산을 복구하고 작업을 다시 실행하려면 요청이 승인되어야 한다고 안내합니다. |
오류 | DEBUG_SUCCESS_WITH_PRIVACY_BUDGET_EXHAUSTED |
---|---|
원인 |
이는 디버그 모드에서 작업을 실행하고 있음을 나타냅니다. createJob 요청의 job_parameters 에는 debug_run: true 가 포함됩니다. debug_run 플래그가 사용 설정된 경우 디버깅 목적으로 보고서를 여러 번 실행할 수 있습니다. 이 오류 메시지는 디버그 모드에서 실행되지 않았다면 보고서의 개인 정보 보호 예산이 소진되어 작업이 실패했음을 알려줍니다. 이 오류는 v2.10.0 이하 버전에서만 유효합니다.
|
확인 |
createJob 요청 본문에는 job_parameters 에 debug_run 가 포함됩니다.
{
"job_request_id": "{job_request_id}",
"input_data_blob_prefix": "{input_prefix}",
"input_data_bucket_name": "{input_bucket}",
"output_data_blob_prefix": "{output_prefix}",
"output_data_bucket_name": "{output_bucket}",
"job_parameters": {
"output_domain_blob_prefix": "{output_domain_prefix}",
"output_domain_bucket_name": "{output_domain_bucket}",
"attribution_report_to": "{reporting_origin}",
"debug_run": "true"
}
}
|
작업 런타임 오류
오류 | INVALID_JOB |
---|---|
엔드포인트 | createJob |
원인 | 이는 제공된 디버그 개인 정보 보호 에피론이 범위 (0.64] 내에 있지 않거나 작업 매개변수의 유효성 검사에 실패할 때 발생할 수 있습니다. |
확인 |
어떤 에피론 값이 사용되었나요? createJob 요청에 사용된 작업 매개변수는 무엇이며 환경과 일치하나요? 형식이 올바른가요? 필요한 사항을 수정하고 작업을 다시 시도합니다.
|
오류 | INTERNAL_ERROR |
---|---|
엔드포인트 | getJob |
원인 | 출력 도메인 또는 보고서 처리 실패를 유발하는 형식 문제일 수 있습니다. 집계 서비스 배포에 문제가 있을 수도 있습니다. |
확인 | 출력 도메인 위치가 유효한 경로인지 확인합니다. 작업을 다시 시도합니다. 오류가 계속되면 auto.tfvars 파일과 Terraform 계획 출력을 요청하여 집계 서비스 배포 문제를 해결합니다.
|
오류 | RESULT_WRITE_ERROR |
---|---|
엔드포인트 | getJob |
원인 | 이는 출력 디렉터리에 대한 쓰기가 일시적으로 실패하거나 디렉터리에 대한 쓰기 권한이 없기 때문에 발생할 수 있습니다. 쓰기 오류는 개인 정보 보호 예산을 소비하며 작업을 다시 시도할 수 없습니다. 이로 인해 PRIVACY_BUDGET_EXHAUSTED 오류의 또 다른 오류 결과가 발생할 수 있습니다. |
확인 | 이 오류가 모든 작업에서 발생하나요, 아니면 간헐적으로만 발생하나요? 모든 작업에서 이 문제가 발생하는 경우 출력 디렉터리에 쓰기 권한을 사용 설정했는지 확인합니다. 간헐적인 실패인 경우 권한이 올바른 것입니다. 요약 보고서 작성에 실패할 수 있지만 개인 정보 보호 예산은 계속 사용된다는 알려진 문제입니다. 이 경우 예산 복구를 요청할 수 있습니다 (설명). |
문제 | 작업을 실행하고 증명 서비스 토큰을 검색하는 동안 403 오류가 발생하고 작업이 항상 '수신됨' 상태로 다시 반환됩니다. |
---|---|
오류 |
{
"job_status": "RECEIVED",
"request_received_at": "{utc timestamp}",
"request_updated_at": "{utc timestamp}",
"job_request_id": "0001",
"input_data_blob_prefix": "reports/",
"input_data_bucket_name": "{bucket_name}",
"output_data_blob_prefix": "summary/",
"output_data_bucket_name": "{bucket_name}",
"postback_url": "",
"job_parameters": {
"output_domain_bucket_name": "{bucket_name}",
"output_domain_blob_prefix": "output_domain/",
"attribution_report_to": |
해상도 |
작업이 등록 및 온보딩 상태를 확인한 후 실행 중인 작업에 어떤 문제가 있는지 확인합니다. Amazon Web Services이 경우 AWS 엔클레이브가 실행 중이 아니거나 비정상 종료되어 작업이 선택되지 않을 수 있습니다.
관리형 인스턴스 그룹 (MIG)이 정상 상태가 아닐 수 있습니다. 처음 설정하는 경우 또는
|
요약 보고서의 전환수가 예상대로 발생하나요?
getJob 호출은 성공했지만 집계 서비스에서 반환한 요약 보고서에 문제가 있는 상황이 발생할 수 있습니다. 요약 보고서는 AVRO 형식이며 JSON
형식으로 변환해야 합니다. JSON 형식으로 변환하면 다음과 유사하게 표시됩니다.
{
"bucket": "\u0005Y",
"metric": 26308
}
AVRO 변환에 문제가 있는 경우 AVRO 도구를 사용하고 AVRO 보고서에서 다음 명령어를 사용하세요.
java -jar avro-tools-1.11.1.jar tojson [report_name].avro > [report_name].json
안정화 버전은 여기에서 다운로드할 수 있습니다. 추가 지원이 필요한 경우 다음 단계를 진행하세요.
다음 단계
개인 정보 보호 샌드박스 상태 대시보드 또는 공개 GitHub 저장소에서 다른 사용자에게도 동일한 문제가 발생했는지 확인합니다.
집계 서비스 문제의 해결 방법을 찾을 수 없는 경우 GitHub 문제를 제출하거나 기술 지원 양식을 제출하여 알려주세요.