Mendiagnosis & memvalidasi Infrastruktur Anda

Topik panduan:

Mendiagnosis infrastruktur Anda

Halaman ini memberikan panduan tentang cara memecahkan masalah dan memvalidasi infrastruktur Layanan Agregasi Anda. Ikuti langkah-langkah untuk mengidentifikasi dan menyelesaikan masalah.

Memecahkan masalah Terraform

Terraform, platform infrastruktur sebagai kode (IaC) yang dibuat oleh HashiCorp, adalah pendorong utama untuk men-deploy Layanan Agregasi ke cloud publik pilihan Anda. Jika Anda belum menginstal terraform, lihat dokumentasi HashiCorp tentang cara mendapatkan cli secara lokal.

Anda juga dapat mempertimbangkan untuk menginstal tfenv, jika kebutuhan Anda mengharuskan Anda untuk beralih versi terraform.

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

Jika Anda lebih suka beralih terraform secara manual:

rm -rf $(which terraform)
wget https://releases.hashicorp.com/terraform/1.2.3/terraform_1.2.3_linux_amd64.zip 
unzip terraform_1.2.3_linux_amd64.zip
mv terraform /usr/local/bin/terraform
terraform --version

Jika error Terraform tidak jelas, output dapat dilihat dengan mengaktifkan logging Terraform di level TRACE.

Google Cloud

Penyedia Terraform untuk Google Cloud dikembangkan bersama oleh HashiCorp dan Google. Untuk pertanyaan lebih lanjut dan saran pemecahan masalah, hubungi dukungan Terraform Cloud untuk mengetahui informasi selengkapnya atau buka bagian Google di portal Hashicorp Discuss.

Amazon Web Services

Dokumentasi proses debug dapat ditemukan di situs AWS. Sebaiknya Anda juga melihat bagian AWS di portal Diskusi HashiCorp.

Untuk pertanyaan lebih lanjut tentang Terraform, lihat portal komunitas HashiCorp. Saran pemecahan masalah untuk Terraform umum, baca dokumentasi proses debug.

Berhati-hatilah saat Anda mengubah direktori ini, karena penghapusannya akan menyebabkan terraform tidak lagi mengenali status. Tindakan ini akan mencoba menyediakan ulang semua resource dan menampilkan error saat Anda memiliki resource dengan nama yang sama persis. Jika masalah ini terus berlanjut, hubungi kami melalui formulir dukungan teknis.

Berhati-hatilah saat Anda mengubah direktori ini, karena penghapusannya akan menyebabkan terraform tidak lagi mengenali status. Tindakan ini akan mencoba menyediakan ulang semua resource dan menampilkan error jika Anda memiliki resource dengan nama yang sama persis. Jika masalah ini terus berlanjut, hubungi kami melalui formulir dukungan teknis

Memvalidasi Penyiapan Cloud

Verifikasi apakah Infrastruktur Layanan Agregasi di cloud publik yang Anda pilih telah di-deploy dengan benar. Untuk melakukannya, kita akan menggunakan contoh laporan debug dan menjalankan tugas dalam mode debug. Jika Layanan Agregasi dapat menerima permintaan API dan meresponsnya, kita tahu bahwa layanan tersebut sudah aktif dan berjalan. Jika belum menyiapkannya, sebaiknya gunakan Postman atau cURL untuk menyiapkan panggilan API ke Layanan Agregasi. Perhatikan bahwa mode debug harus dinonaktifkan, disetel ke salah, selama operasi agregasi normal Anda.

Selain langkah-langkah berikut, untuk memvalidasi lebih lanjut infrastruktur Layanan Agregasi, periksa semua komponen cloud yang disediakan di cloud publik Anda.

Langkah

  1. Untuk membuat contoh laporan debug dan file domain output, ikuti langkah-langkah yang relevan dalam codelab:

  2. Jalankan permintaan createJob dengan isi ini, ganti placeholder yang ditandai:

    {
  "job_request_id": "<job_request_id>",
  "input_data_blob_prefix": "<report_folder>/<report_name>.avro",
  "input_data_bucket_name": "<input_bucket_name>",
  "output_data_blob_prefix": "<output_folder>/<summary_report_prefix>",
  "output_data_bucket_name": "<output_bucket_name>",
  "job_parameters": {
    "output_domain_blob_prefix": "<output_domain_folder>/<output_domain>.avro",
    "output_domain_bucket_name": "<output_domain_bucket_name>",
    "attribution_report_to": "<reporting_origin_domain>",
    "report_error_threshold_percentage": "10", // example value
    "debug_run": "true" // optional, but should be false by default
  }
}

  3. Jalankan permintaan getJob untuk melihat respons. Jika Anda mendapatkan respons berikut, artinya Layanan Agregasi Anda telah di-deploy dengan benar.

    {
    "job_status": "FINISHED",
    "request_received_at": <utc_timestamp>,
    "request_updated_at": <utc_timestamp>,
    "job_request_id": "<job_request_id>",
    "input_data_blob_prefix": "<report_folder>/<input_report_prefix>.avro",
    "input_data_bucket_name": "<input_bucket_name>",
    "output_data_blob_prefix": "<output_folder>/<summary_report_prefix>",
    "output_data_bucket_name": "<output_bucket_name>",
    "postback_url": "",
    "result_info": {
        "return_code": "<return_code_and_message>",
        "return_message": "Aggregation job successfully processed",
        "error_summary": {
            "error_counts": [],
            "error_messages": []
        },
        "finished_at": <utc_timestamp>
    },
    "job_parameters": {
        "debug_run": "true", // optional, but should be false by default
        "output_domain_bucket_name": "<output_domain_bucket_name>",
        "output_domain_blob_prefix": "<output_domain_folder>/<output_domain>.avro",
        "attribution_report_to": "<reporting_origin_domain>"
    },
    "request_processing_started_at": <utc_timestamp>
}

Jika Anda tidak menerima respons dengan job_status: FINISHED, kumpulkan informasi selengkapnya dengan membuka resource compute engine atau EC2 dari cloud publik yang Anda pilih. Periksa instance Layanan Agregasi Anda dan periksa log serta catat informasi yang Anda lihat antara TEE container launcher initiating dan TEE container launcher exiting untuk diberikan kepada tim dukungan teknis kami.

Google Cloud

  1. Buka Google Cloud: Compute Engine.
  2. Klik VM instances dan pilih instance Layanan Agregasi Anda.
  3. Klik Details > Logs > Logging (atau telusuri Logs Explorer).

Amazon Web Services

  1. Buka Amazon Web Services: EC2 Enclave.
  2. Klik Instance EC2, lalu pilih instance Layanan Agregasi Anda.
  3. Klik Tindakan > Pantau dan pecahkan masalah > Dapatkan log sistem.

Periksa dan lihat apakah Anda menemukan error yang cocok dengan notifikasi error di panduan publik kami di GitHub.

Catatan: Jika Anda baru saja mengupgrade versi Layanan Agregasi saat ini, proses penyediaan penuh mungkin memerlukan waktu hingga beberapa jam agar gambar instance yang benar ditampilkan di instance layanan komputasi akhir Anda. Hubungi kami jika Anda tidak memilikinya.

Langkah Berikutnya

Jika Anda tidak melihat solusi untuk masalah Layanan Agregasi, beri tahu kami dengan melaporkan masalah GitHub atau mengirimkan formulir dukungan teknis.