集計ジョブを診断する

利用しているパブリック クラウドの CLI（コマンドライン インターフェース）に正しく認証されていることを確認します。

AWS では、アグリゲーション サービスに必要なインスタンスやその他のサービスを作成するために、ユーザー権限が必要です。これを適用すると、問題なく terraform plan と apply を実行できるようになります。

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 が以前に成功したバッチにすでに含まれているレポートをバッチ処理しようとしたときに発生します。このエラーは、集計可能なレポートが 1 つのバッチにのみ表示され、1 つのサマリー レポートにのみ貢献できるという「重複なし」ルールが原因で発生します。

各レポートには「共有 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. [セッション マネージャー] タブ > [接続] ボタンを選択します。これでインスタンスに接続されます。
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] > [インスタンス グループ] に移動します。
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