หัวข้อในคู่มือ:
วินิจฉัยโครงสร้างพื้นฐาน
หน้านี้ให้คำแนะนำเกี่ยวกับวิธีแก้ปัญหาและตรวจสอบโครงสร้างพื้นฐานของ บริการรวบรวมข้อมูล ทำตามขั้นตอนเพื่อระบุและ แก้ไขปัญหา
การแก้ปัญหาเกี่ยวกับ Terraform
Terraform ซึ่งเป็นแพลตฟอร์มโครงสร้างพื้นฐานเป็นโค้ด (IaC) ที่สร้างโดย HashiCorp เป็น ตัวขับเคลื่อนหลักในการติดตั้งใช้งานบริการรวบรวมข้อมูลในระบบคลาวด์สาธารณะที่คุณเลือก หากยังไม่ได้ติดตั้ง Terraform โปรดดูเอกสารประกอบของ HashiCorp เกี่ยวกับวิธี รับ CLI ในเครื่อง
นอกจากนี้ คุณอาจพิจารณาติดตั้ง tfenv หาก คุณจำเป็นต้องเปลี่ยนเวอร์ชัน Terraform
หากไม่เห็นวิธีแก้ไขปัญหาเกี่ยวกับบริการรวบรวมข้อมูล โปรดแจ้งให้เราทราบโดยการส่งปัญหาใน GitHub หรือส่งแบบฟอร์มขอรับการสนับสนุนด้านเทคนิค
หากต้องการเปลี่ยน Terraform ด้วยตนเอง ให้ทำดังนี้
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
หากข้อผิดพลาดของ Terraform ไม่ชัดเจน คุณจะดูเอาต์พุตได้โดยเปิดใช้การบันทึก Terraform ที่ระดับ TRACE
Google Cloud
ผู้ให้บริการ Terraform สำหรับ Google Cloud พัฒนาร่วมกันระหว่าง HashiCorp และ Google หากมีคำถามเพิ่มเติมและคำแนะนำในการแก้ปัญหา โปรดติดต่อทีมสนับสนุนของ Terraform ในระบบคลาวด์เพื่อขอข้อมูลเพิ่มเติม หรือไปที่ส่วนของ Google ในพอร์ทัล Hashicorp Discuss
Amazon Web Services
ดูเอกสารการแก้ไขข้อบกพร่องได้ที่เว็บไซต์ของ AWS นอกจากนี้ เราขอแนะนำให้คุณดูส่วน AWS ของพอร์ทัล HashiCorp Discuss
หากมีคำถามเพิ่มเติมเกี่ยวกับ Terraform โปรดดูพอร์ทัลชุมชน HashiCorp หากต้องการคำแนะนำในการแก้ปัญหา Terraform ทั่วไป โปรดอ่านเอกสารการแก้ไขข้อบกพร่อง
โปรดใช้ความระมัดระวังอย่างยิ่งเมื่อแก้ไขไดเรกทอรีเหล่านี้ เนื่องจากหากนำออก จะทำให้ Terraform ไม่รู้จักสถานะอีกต่อไป โดยจะพยายามจัดสรรทรัพยากรทั้งหมดอีกครั้งและแสดงข้อผิดพลาดเมื่อคุณมีทรัพยากรที่มีชื่อเดียวกัน ทุกประการ หากยังพบปัญหานี้อยู่ โปรดติดต่อเราในแบบฟอร์มขอรับการสนับสนุนด้านเทคนิค
โปรดใช้ความระมัดระวังอย่างยิ่งเมื่อแก้ไขไดเรกทอรีเหล่านี้ เนื่องจากหากนำออก จะทำให้ Terraform ไม่รู้จักสถานะอีกต่อไป โดยจะพยายามจัดสรรทรัพยากรทั้งหมดอีกครั้งและแสดงข้อผิดพลาดเมื่อคุณมีทรัพยากรที่มีชื่อเดียวกัน ทุกประการ หากยังพบปัญหานี้อยู่ โปรดติดต่อเราใน แบบฟอร์มขอรับการสนับสนุนด้านเทคนิค
ตรวจสอบการตั้งค่าระบบคลาวด์
ตรวจสอบว่าโครงสร้างพื้นฐานของบริการรวบรวมข้อมูลในระบบคลาวด์สาธารณะที่คุณเลือก
ได้รับการติดตั้งใช้งานอย่างถูกต้อง โดยเราจะใช้รายงานการแก้ไขข้อบกพร่องตัวอย่างและเรียกใช้
งานในโหมดแก้ไขข้อบกพร่อง หากบริการรวบรวมข้อมูลรับคำขอ API
และตอบกลับได้ แสดงว่าบริการพร้อมใช้งาน หากยังไม่ได้ตั้งค่า เราขอแนะนําให้ใช้ Postman
หรือ cURL เพื่อตั้งค่าการเรียก API ไปยังบริการรวบรวมข้อมูล โปรดทราบว่าควรปิดโหมดแก้ไขข้อบกพร่อง
และตั้งค่าเป็น "false" ในระหว่างการดำเนินการรวบรวมข้อมูลตามปกติ
นอกเหนือจากขั้นตอนต่อไปนี้แล้ว ให้ตรวจสอบคอมโพเนนต์ระบบคลาวด์ที่ได้รับการจัดสรร ในระบบคลาวด์สาธารณะเพื่อตรวจสอบโครงสร้างพื้นฐานของบริการรวบรวมข้อมูลเพิ่มเติม
ขั้นตอน
หากต้องการสร้างรายงานการแก้ไขข้อบกพร่องตัวอย่างและไฟล์โดเมนเอาต์พุต ให้ทำตามขั้นตอนที่เกี่ยวข้องของ Codelab
- Google Cloud: ทำตามขั้นตอนที่ 3.1.1 ถึง 3.1.4 ของ Aggregation Service Google Cloud Codelab
- Amazon Web Services: ทำตามขั้นตอนที่ 4.1 ถึง 4.4 ของ Codelab ของ Aggregation Service ใน AWS
เรียกใช้คำขอ
createJobที่มีเนื้อหานี้ โดยแทนที่ตัวยึดตำแหน่งที่ไฮไลต์{ "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 } }เรียกใช้คำขอ
getJobเพื่อดูการตอบกลับ หากคุณได้รับการตอบกลับต่อไปนี้ แสดงว่าคุณได้ติดตั้งใช้งานบริการรวมข้อมูลอย่างถูกต้องแล้ว{ "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> }
หากไม่ได้รับการตอบกลับพร้อม job_status: FINISHED
ให้รวบรวมข้อมูลเพิ่มเติมโดยไปที่ทรัพยากร Compute Engine หรือ EC2 ของ
ระบบคลาวด์สาธารณะที่คุณเลือก ตรวจสอบอินสแตนซ์ของบริการรวบรวมข้อมูล และตรวจสอบ
บันทึก แล้วบันทึกข้อมูลที่คุณเห็นระหว่าง
TEE container launcher initiating และ TEE container launcher exiting
เพื่อส่งให้ทีมสนับสนุนด้านเทคนิคของเรา
Google Cloud
- ไปที่ Google Cloud: Compute Engine
- คลิก VM instances แล้วเลือกอินสแตนซ์ Aggregation Service
- คลิกรายละเอียด > บันทึก > การบันทึก (หรือค้นหา Logs Explorer)
Amazon Web Services
- ไปที่ Amazon Web Services: EC2 Enclave
- คลิก EC2 instances แล้วเลือกอินสแตนซ์ของบริการรวบรวมข้อมูล
- คลิกการดำเนินการ > ตรวจสอบและแก้ปัญหา > รับบันทึกของระบบ
ตรวจสอบและดูว่าคุณพบการแจ้งเตือนข้อผิดพลาดที่ตรงกันในคำแนะนำแบบสาธารณะบน GitHub หรือไม่
หมายเหตุ: หากคุณเพิ่งอัปเกรด Aggregation Service เวอร์ชันปัจจุบัน กระบวนการจัดสรรทั้งหมดอาจใช้เวลาถึง 2 ชั่วโมงเพื่อให้ อิมเมจอินสแตนซ์ที่ถูกต้องแสดงในอินสแตนซ์บริการประมวลผลสุดท้าย โปรดติดต่อเราหากคุณไม่ได้อยู่ในกรณีนี้
ขั้นตอนถัดไป
หากไม่เห็นวิธีแก้ปัญหาเกี่ยวกับบริการรวบรวมข้อมูล โปรดแจ้งให้เราทราบโดย ส่งปัญหาใน GitHub หรือส่งแบบฟอร์มขอรับการสนับสนุนด้านเทคนิค