集計ジョブを診断する

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

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

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

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

各レポートには、shared_info フィールド API、reporting_origin、destination_site、source_registration_time（日付で切り捨て）、scheduled_report_time（時間で切り捨て）、version で構成される「共有 ID」が割り当てられます。つまり、複数のレポートが 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] > [インスタンス グループ] に移動します。
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