Mendiagnosis Tugas Agregasi

Tabel berikut menjelaskan berbagai masalah dan kode status error dengan kemungkinan penyebab dan tindakan yang dapat Anda lakukan untuk memitigasi deployment. Jika Anda ingin melihat spesifikasi & mitigasi error lengkap untuk Layanan Agregasi, lihat panduan publik kami saat ini.

Topik panduan:

Error Izin & Otorisasi

Masalah Masalah izin saat Anda menjalankan terraform plan atau terraform apply ke project cloud publik Anda.
Contoh Error Error: UnauthorizedOperation: You are not authorized to perform this operation.
Resolusi

Pastikan Anda telah diautentikasi dengan benar ke CLI (command-line interface) cloud publik yang Anda gunakan.

Amazon Web Services

AWS memerlukan izin pengguna untuk dapat membuat instance dan layanan lain yang diperlukan untuk Layanan Agregasi. Setelah menerapkannya, Anda akan dapat melakukan terraform plan dan apply tanpa masalah.

Google Cloud Platform

Di Google Cloud, perhatikan bahwa Anda harus meniru identitas akun layanan untuk men-deploy paruh kedua Terraform. Perintah terraform apply Anda mungkin gagal jika Anda melewati langkah ini karena akun layanan deployment memiliki semua izin yang diperlukan untuk membuat resource. Lihat langkah 4 di "Siapkan lingkungan deployment Anda" di dokumentasi GitHub.

Error Anggaran Privasi

Error PRIVACY_BUDGET_ERROR
Penyebab Hal ini menunjukkan bahwa layanan tidak dapat memproses laporan karena terjadi error pada layanan anggaran privasi.
Cek Setelah Anda mencoba lagi tugas untuk melihat apakah error bersifat sementara, hubungi kami melalui formulir dukungan teknis.
Error PRIVACY_BUDGET_AUTHORIZATION_ERROR
Penyebab Anda mungkin menggunakan asal pelaporan yang berbeda dengan yang mereka berikan selama aktivasi.
Cek

Pastikan situs yang Anda kirimkan di kolom attribution_report_to permintaan createJob adalah situs yang sama dengan yang dikirimkan selama aktivasi.

Situs harus cocok dengan atau merupakan subdomain dari situs yang diaktifkan. Perhatikan bahwa aktivasi Layanan Agregasi ditangani di domain tingkat teratas, dan semua subdomain memenuhi syarat untuk menggunakan Layanan Agregasi setelah domain tingkat teratas diaktifkan.
Error PRIVACY_BUDGET_AUTHENTICATION_ERROR
Penyebab Anda mungkin menggunakan ARN yang sudah tidak berlaku atau salah.
Cek Google Cloud Platform

Pastikan akun layanan yang digunakan dalam deployment Layanan Agregasi Anda cocok dengan akun layanan yang diberikan selama aktivasi. ID ini harus sama persis, bukan hanya termasuk dalam project yang sama.

Amazon Web Services

Anda diharapkan menggunakan koordinator yang sama dengan yang diberikan kepada Anda melalui email. Jika Anda masih mengalami masalah, kumpulkan file auto.tfvars dan informasi asal pelaporan Anda, lalu hubungi kami melalui formulir dukungan teknis.
Error PRIVACY_BUDGET_EXHAUSTED
Penyebab Error: 
            "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": 
            }

Masalah kehabisan Anggaran Privasi terjadi saat Anda mencoba membuat batch laporan yang ID bersamanya telah disertakan dalam batch yang berhasil sebelumnya. Error ini terjadi karena aturan"Tidak ada duplikat" yang hanya mengizinkan laporan yang dapat diagregasi muncul dalam satu batch dan hanya dapat berkontribusi pada satu laporan ringkasan.

Setiap laporan akan diberi "ID bersama" yang akan terdiri dari API kolom shared_info, reporting_origin, destination_site, source_registration_time (dipangkas menurut hari), scheduled_report_time (dipangkas menurut jam), dan version. Artinya, beberapa laporan dapat termasuk dalam "ID bersama" yang sama jika memiliki atribut yang sama di kolom shared_info.
Cek

Sebaiknya Anda mencoba dukungan Anggaran Privasi Habis yang diberikan dari respons tugas untuk memeriksa dan menyelesaikan error Anda. Hal ini menyediakan file JSON helper baru yang akan memberikan visibilitas ke laporan yang menyebabkan error.

Perhatikan bahwa jika Anda melakukan pengelompokan dengan benar, Anda mungkin memenuhi syarat untuk pemulihan anggaran (penjelasan). Sarankan mereka membaca penjelasan dan mengisi formulir, tetapi perhatikan bahwa permintaan mereka harus disetujui agar berhasil memulihkan anggaran dan menjalankan tugas lagi.
Error DEBUG_SUCCESS_WITH_PRIVACY_BUDGET_EXHAUSTED
Penyebab Hal ini menunjukkan bahwa Anda menjalankan tugas dalam mode debug. job_parameters dalam permintaan createJob berisi debug_run: true. Jika tanda debug_run diaktifkan, Anda dapat menjalankan laporan beberapa kali untuk tujuan proses debug. Pesan error ini memberi tahu Anda bahwa tugas akan gagal karena anggaran privasi laporan habis jika tidak dijalankan dalam mode debug. Error ini hanya akan valid dalam rilis v2.10.0 atau yang lebih lama.
Cek Isi permintaan createJob akan berisi debug_run di job_parameters. 
            {
              "job_request_id": "{job_request_id}",
              "input_data_blob_prefix": "{input_prefix}",
              "input_data_bucket_name": "{input_bucket}",
              "output_data_blob_prefix": "{output_prefix}",
              "output_data_bucket_name": "{output_bucket}",
              "job_parameters": {
                "output_domain_blob_prefix": "{output_domain_prefix}",
                "output_domain_bucket_name": "{output_domain_bucket}",
                "attribution_report_to": "{reporting_origin}",
                "debug_run": "true"
              }
            }

Error Runtime Tugas

Error INVALID_JOB
Endpoint createJob
Penyebab Hal ini dapat terjadi jika epsilon privasi debug yang diberikan tidak berada dalam batas (0,64], atau jika parameter tugas gagal divalidasi.
Cek Nilai epsilon apa yang digunakan? Parameter tugas apa yang digunakan dalam permintaan createJob, dan apakah parameter tersebut cocok dengan lingkungan Anda? Apakah diformat dengan benar? Lakukan koreksi yang diperlukan dan coba lagi tugasnya.
Error INTERNAL_ERROR
Endpoint getJob
Penyebab Dapat berupa masalah pemformatan yang menyebabkan kegagalan pemrosesan untuk domain atau laporan output. Juga dapat menjadi masalah pada deployment Layanan Agregasi Anda.
Cek Pastikan lokasi domain output adalah jalur yang valid. Coba lagi tugas tersebut. Jika error tetap terjadi, minta file auto.tfvars dan output rencana Terraform untuk memecahkan masalah deployment Layanan Agregasi mereka.
Error RESULT_WRITE_ERROR
Endpoint getJob
Penyebab Hal ini dapat terjadi jika penulisan ke direktori output gagal, baik secara sementara maupun karena kurangnya izin tulis pada direktori. Perhatikan bahwa error penulisan menggunakan anggaran privasi, dan tugas tidak dapat dicoba lagi. Hal ini dapat berkontribusi pada hasil error lain dari error PRIVACY_BUDGET_EXHAUSTED.
Cek Apakah error ini terjadi pada setiap tugas, atau hanya sesekali? Jika hal ini terjadi di setiap tugas, pastikan Anda telah mengaktifkan izin tulis di direktori output. Jika ini adalah kegagalan sementara, izinnya sudah benar. Menulis laporan ringkasan dapat gagal, tetapi anggaran privasi akan tetap digunakan. Hal ini merupakan masalah umum. Dalam hal ini, Anda dapat meminta pemulihan anggaran (penjelasan).
Masalah Menemukan error 403 saat menjalankan tugas dan mengambil token layanan pengesahan, serta tugas selalu ditampilkan kembali dengan status "DITERIMA".
Error 
            {
                "job_status": "RECEIVED",
                "request_received_at": "{utc timestamp}",
                "request_updated_at": "{utc timestamp}",
                "job_request_id": "0001",
                "input_data_blob_prefix": "reports/",
                "input_data_bucket_name": "{bucket_name}",
                "output_data_blob_prefix": "summary/",
                "output_data_bucket_name": "{bucket_name}",
                "postback_url": "",
                "job_parameters": {
                    "output_domain_bucket_name": "{bucket_name}",
                    "output_domain_blob_prefix": "output_domain/",
                    "attribution_report_to": 
                }
            }
Resolusi

Pekerjaan yang macet dalam status RECEIVED dan error 403 biasanya terjadi saat akun layanan belum diaktifkan. Pastikan akun layanan yang Anda gunakan cocok dengan yang Anda berikan dalam permintaan aktivasi. Jika Anda belum menyelesaikan permintaan aktivasi, harap isi formulir aktivasi dan formulir pendaftaran.

Setelah Anda memverifikasi status pendaftaran dan aktivasi, periksa apa yang terjadi pada tugas yang sedang berjalan.

Amazon Web Services

Jika hal ini terjadi, kemungkinan enclave AWS tidak berjalan atau error sehingga tugas tidak diambil.

  1. Hubungkan ke Session Manager instance EC2.
  2. Ikuti dokumentasi AWS ini, yang mencakup langkah-langkah berikut untuk terhubung ke Session Manager.
  3. Buka AWS Console Manager > EC2 > Instances.
  4. Pilih ID Instance yang menjalankan Layanan Agregasi.
  5. Pilih tab "Session Manager" > tombol "Connect". Tindakan ini akan menghubungkan Anda ke instance.
  6. Setelah instance Enclave berjalan, jalankan di terminal:
    sudo nitro-cli describe-enclaves
    Jika perintah ini tidak menampilkan log seperti yang diharapkan, jalankan perintah berikut sebelum mencoba lagi:
    sudo nitro-cli run-enclave --cpu-count=2 --memory=7000 --eif-path=/opt/google/worker/enclave.eif
  7. Untuk memeriksa apakah AWS enclave telah error, jalankan perintah: sudo journalctl -u aggregate-worker.service
  8. Anda akan melihat log output yang masuk seperti:
    Starting aggregate-worker.service - Watcher script for nitro enclave.
    Error akan terlihat di sini jika ada kegagalan, dll.
Google Cloud Platform

Grup instance terkelola (MIG) mungkin tidak responsif. Jika ini adalah penyiapan pertama kali, atau Anda menghancurkan dan membuat ulang Terraform adtech_setup, pastikan akun layanan Anda telah diaktifkan. Jika akun layanan tidak diaktifkan, MIG tidak akan responsif.

  1. Konsol Cloud, buka Compute Engine > Instance groups
  2. Periksa kolom status Anda (tanda centang hijau menunjukkan kondisi baik)
  3. Klik salah satu grup instance, lalu lihat tab Error untuk mempelajari masalah lebih lanjut. Klik Nama instance untuk mengakses informasi tingkat VM.
  4. Anda juga dapat menggunakan Terminal untuk berinteraksi dengan Grup instance dan mendapatkan informasi yang sama. Coba perintah list-errors:
    gcloud compute instance-groups managed list-errors --region=
    Berikut adalah contoh outputnya. 
                      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
Jika Anda masih melihat masalah, simpan informasi ini dan berikan kepada tim kami. Lanjutkan ke langkah berikutnya.

Apakah laporan ringkasan Anda berkonversi seperti yang diharapkan?

Situasi dapat muncul saat panggilan getJob Anda berhasil, tetapi ada masalah dengan laporan ringkasan yang ditampilkan oleh Layanan Agregasi. Laporan ringkasan diformat AVRO dan harus dikonversi ke format JSON. Setelah dikonversi ke format json, tampilannya akan mirip dengan berikut.

{
  "bucket": "\u0005Y",
  "metric": 26308
}

Jika konversi AVRO mengalami masalah, coba gunakan alat AVRO dan gunakan perintah berikut pada laporan AVRO. java -jar avro-tools-1.11.1.jar tojson [report_name].avro > [report_name].json Versi stabil dapat didownload dari sini. Jika Anda memerlukan bantuan lebih lanjut, lanjutkan ke langkah berikutnya.

Langkah Berikutnya

Periksa apakah ada orang lain yang mengalami masalah yang sama di Dasbor Status Privacy Sandbox atau di repositori GitHub publik.

Jika Anda tidak melihat penyelesaian masalah Layanan Penggabungan, beri tahu kami dengan melaporkan masalah GitHub atau mengirimkan formulir dukungan teknis.