집계 작업 진단

사용 중인 퍼블릭 클라우드의 CLI (명령줄 인터페이스)에 올바르게 인증되었는지 확인합니다.

AWS에서는 집계 서비스에 필요한 인스턴스와 기타 서비스를 만들 수 있는 사용자 권한이 필요합니다. 이 단계를 적용하면 문제없이 Terraform 계획을 실행하고 적용할 수 있습니다.

Google Cloud에서 Terraform의 후반부를 배포하려면 서비스 계정을 가장해야 합니다. 이 단계를 건너뛰면 배포 서비스 계정에 리소스를 만드는 데 필요한 모든 권한이 있으므로 Terraform 적용 명령어가 실패할 수 있습니다. GitHub 문서의 '배포 환경 설정'의 4단계를 참고하세요.

createJob 요청의 attribution_report_to 필드에 제출하는 사이트가 온보딩 중에 제출된 사이트와 동일한지 확인합니다.

사이트가 온보딩된 사이트와 일치하거나 온보딩된 사이트의 하위 도메인이어야 합니다. 집계 서비스 온보딩은 최상위 도메인에서 처리되며, 최상위 도메인이 온보딩되면 모든 하위 도메인이 집계 서비스를 사용할 수 있습니다.

집계 서비스 배포에 사용되는 서비스 계정이 온보딩 중에 제공된 서비스 계정과 일치하는지 확인합니다. 동일한 프로젝트에 속하는 것뿐만 아니라 정확히 일치해야 합니다.

이메일을 통해 제공된 것과 동일한 코디네이터를 사용해야 합니다. 문제가 계속되면 auto.tfvars 파일과 보고 출처 정보를 수집하여 기술 지원 양식을 통해 문의해 주세요.

            "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: //
              Filename: privacy budget exhausted debugging information  \n
              com.google.aggregate.adtech.worker.aggregation.concurrent.ConcurrentAggregationProcessor.consumePrivacyBudgetUnits(ConcurrentAggregationProcessor.java:525) \n com.google.aggregate.adtech.worker.aggregation.concurrent.ConcurrentAggregationProcessor.process(ConcurrentAggregationProcessor.java:319) \n com.google.aggregate.adtech.worker.WorkerPullWorkService.run(WorkerPullWorkService.java:157)",
              "error_summary": {
                  "error_counts": [],
                  "error_messages": []
              },
              "finished_at": 
            }
          

개인 정보 보호 예산 소진 문제는 공유 ID가 이전에 성공한 일괄 처리에 이미 포함된 보고서를 일괄 처리하려고 할 때 발생합니다. 이 오류는 집계 가능한 보고서가 단일 배치에만 표시될 수 있고 하나의 요약 보고서에만 기여할 수 있는 '중복 없음' 규칙으로 인해 발생합니다.

각 보고서에는 shared_info 필드 API, reporting_origin, destination_site, source_registration_time (일별로 잘림), scheduled_report_time (시간별로 잘림), version으로 구성된 '공유 ID'가 할당됩니다. shared_info 필드의 속성이 동일한 경우 여러 보고서가 동일한 '공유 ID'에 속할 수 있습니다.

작업 응답에서 제공되는 개인 정보 보호 예산 소진 지원을 사용하여 오류를 검사하고 해결하는 것이 좋습니다. 이렇게 하면 오류에 기여한 보고서를 파악할 수 있는 새로운 도우미 JSON 파일이 제공됩니다.

일괄 처리를 올바르게 수행하면 예산 복구 (설명)가 가능할 수 있습니다. 설명서를 읽고 양식을 작성하도록 제안하되, 예산을 복구하고 작업을 다시 실행하려면 요청이 승인되어야 한다고 언급합니다.

작업이 RECEIVED 상태로 멈추고 403 오류가 발생하는 것은 일반적으로 서비스 계정이 아직 온보딩되지 않은 경우입니다. 사용 중인 서비스 계정이 온보딩 요청에 제공한 계정과 일치하는지 확인합니다. 온보딩 요청을 완료하지 않은 경우 온보딩 양식과 등록 양식을 작성하세요.

등록 및 온보딩 상태를 확인한 후 실행 중인 작업에 어떤 문제가 발생했는지 확인합니다.

이 경우 AWS 엔클레이브가 실행되지 않거나 비정상 종료되어 작업이 선택되지 않을 수 있습니다.

1. EC2 인스턴스 세션 관리자에 연결합니다.
2. 세션 관리자에 연결하는 다음 단계를 포함하는 이 AWS 문서를 따르세요.
3. AWS 콘솔 관리자 > EC2 > 인스턴스로 이동합니다.
4. 실행 중인 집계 서비스의 인스턴스 ID를 선택합니다.
5. '세션 관리자' 탭 > '연결' 버튼을 선택합니다. 그러면 인스턴스에 연결됩니다.
6. 엔클레이브 인스턴스가 실행되면 터미널에서 다음을 실행합니다.
   sudo nitro-cli describe-enclaves
   이 명령어에 로그가 예상대로 표시되지 않으면 다시 시도하기 전에 다음을 실행합니다.
   sudo nitro-cli run-enclave --cpu-count=2 --memory=7000 --eif-path=/opt/google/worker/enclave.eif
   
7. AWS 엔클레이브가 비정상 종료되었는지 확인하려면 다음 명령어를 실행합니다. sudo journalctl -u aggregate-worker.service
8. 다음과 같은 출력 로그가 표시됩니다.
   Starting aggregate-worker.service - Watcher script for nitro enclave.
   실패 등이 있는 경우 여기에 오류가 표시됩니다.

관리형 인스턴스 그룹 (MIG)이 비정상일 수 있습니다. 처음 설정하는 경우 또는 adtech_setup Terraform을 삭제하고 다시 만든 경우 서비스 계정이 온보딩되었는지 확인합니다. 서비스 계정이 온보딩되지 않으면 MIG가 정상 상태가 아닙니다.

1. Cloud 콘솔에서 Compute Engine > 인스턴스 그룹으로 이동합니다.
2. 상태 열을 확인합니다 (녹색 체크표시는 정상임).
3. 인스턴스 그룹 중 하나를 클릭하고 '오류' 탭을 확인하여 문제에 대해 자세히 알아봅니다. 인스턴스 이름을 클릭하여 VM 수준 정보에 액세스합니다.
4. 터미널을 사용하여 인스턴스 그룹과 상호작용하고 동일한 정보를 가져올 수도 있습니다. list-errors 명령어를 사용해 보세요.
   gcloud compute instance-groups managed list-errors --region=
   다음은 출력 예시입니다.

                     INSTANCE_URL: https://www.googleapis.com/compute/v1/projects/aggservice-sandbox/zones/us-central1-c/instances/collector-operator-demo-env-67hd
                     ACTION: VERIFYING
                     ERROR_CODE: WAITING_FOR_HEALTHY_TIMEOUT_EXCEEDED
                     ERROR_MESSAGE: Waiting for HEALTHY state timed out (autohealingPolicy.initialDelay=200 sec) for instance projects/aggservice-sandbox/zones/us-central1-c/instances/collector-operator-demo-env-67hd and health check projects/aggservice-sandbox/global/healthChecks/operator-demo-env-collector-auto-heal-hc.
                     TIMESTAMP: 
                     INSTANCE_TEMPLATE: https://www.googleapis.com/compute/v1/projects/aggservice-sandbox/global/instanceTemplates/operator-demo-env-collector
                     VERSION_NAME: primary