診斷匯總工作

確認您已正確驗證所用公有雲的 CLI (命令列介面)。

AWS 需要使用者權限，才能建立執行個體和匯總服務所需的其他服務。套用後，您應該就能順利執行 Terraform 計畫和套用作業。

請注意，在 Google Cloud 中，您必須模擬服務帳戶，才能部署 Terraform 的後半部分。如果您略過這個步驟，terraform apply 指令可能會失敗，因為部署服務帳戶擁有建立資源的所有必要權限。請參閱 GitHub 說明文件中的「設定部署環境」一節的步驟 4。

確認您在 createJob 要求的 attribution_report_to 欄位中提交的網站，與加入程序中提交的網站相同。

網站應與已加入的網站相符，或為後者的子網域。請注意，匯總服務的啟用程序是在頂層網域進行，頂層網域啟用後，所有子網域都能使用匯總服務。

確認在 Aggregation Service 部署作業中使用的服務帳戶，與加入程序期間提供的服務帳戶相符。必須完全相符，而不只是屬於相同專案。

您應使用電子郵件中提供的相同協調員。如果問題仍未解決，請收集 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 已包含在先前成功的批次中，就會發生隱私權預算用盡的問題。發生這項錯誤的原因是「沒有重複項目」規則，根據這項規則，可匯總的報表只能出現在單一批次中，且只能提供給一份摘要報表。

每份報表都會獲派「共用 ID」，其中包含 shared_info 欄位 API、reporting_origin、destination_site、source_registration_time (以天為單位截斷)、scheduled_report_time (以小時為單位截斷) 和 version。也就是說，如果多份報表共用 shared_info 欄位的相同屬性，這些報表就會屬於同一個「共用 ID」。

建議您試用作業回應提供的隱私權預算用盡支援，檢查並解決錯誤。這會提供新的輔助 JSON 檔案，方便您查看哪些報表導致錯誤。

請注意，如果批次處理正確，您可能符合預算復原資格 (說明)。建議他們閱讀說明文章並填寫表單，但請注意，他們的要求必須獲得核准，才能順利恢復預算並再次執行工作。

如果服務帳戶尚未完成啟用程序，工作通常會停滯在 RECEIVED 狀態，並發生 403 錯誤。確認您使用的服務帳戶與加入程序要求中提供的帳戶相符。如果您尚未完成新手上路申請，請填寫新手上路表單和註冊表單。

確認註冊和新手上路狀態後，請檢查執行中的工作發生了什麼情況。

發生這種情況時，可能是 AWS Enclave 未執行或已當機，因此工作不會被選取。

1. 連線至 EC2 執行個體 Session Manager。
2. 請參閱這份 AWS 說明文件，瞭解如何連線至 Session Manager，包括下列步驟：
3. 前往 AWS 控制台管理員 > EC2 > 執行個體。
4. 選取正在執行的匯總服務執行個體 ID。
5. 依序選取「工作階段管理員」分頁標籤 >「連線」按鈕。系統會將您連線至執行個體。
6. Enclave 執行個體啟動後，請在終端機中執行下列指令：
   sudo nitro-cli describe-enclaves
   如果這個指令未如預期顯示記錄，請先執行下列指令，然後再試一次：
   sudo nitro-cli run-enclave --cpu-count=2 --memory=7000 --eif-path=/opt/google/worker/enclave.eif
   
7. 如要檢查 AWS Enclave 是否當機，請執行下列指令： 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