診斷匯總工作

請確認您已在所使用的公用雲端服務中，正確驗證 CLI (指令列介面)。

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

請注意，在 Google Cloud 中，您必須假冒服務帳戶才能部署 Terraform 的後半部。如果您略過這個步驟，您的 terraform apply 指令可能會失敗，因為部署服務帳戶已具備建立資源所需的所有權限。請參閱 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 已包含在先前成功匯出的工作群組的報表，就會發生隱私預算用盡的問題。這項錯誤是因為「不重複」規則：匯總報表只能出現在單一批次中，且只能納入一份摘要報表。

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

建議您嘗試使用工作回應提供的隱私權預算用盡支援功能，檢查並解決錯誤。這會提供新的輔助 JSON 檔案，讓您瞭解哪些報表導致錯誤。

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

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

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

發生這種情況時，AWS 特區可能未執行或已停止運作，因此無法接收工作。

1. 連線至 EC2 執行個體的 Session Manager。
2. 請按照這份 AWS 說明文件操作，其中包含連線至 Session Manager 的步驟。
3. 依序前往 AWS 控制台管理工具 > EC2 > 執行個體。
4. 選取執行中的匯總服務的執行個體 ID。
5. 依序選取「Session Manager」分頁標籤 >「Connect」按鈕。這樣就能連線至執行個體。
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 特區是否已停止運作，請執行以下指令： 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」>「Instance groups」(執行個體群組)
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