Chẩn đoán và xác thực Cơ sở hạ tầng

Chủ đề hướng dẫn:

Chẩn đoán cơ sở hạ tầng

Trang này cung cấp hướng dẫn về cách khắc phục sự cố và xác thực cơ sở hạ tầng Dịch vụ tổng hợp. Làm theo các bước để xác định và giải quyết vấn đề.

Khắc phục sự cố Terraform

Terraform, nền tảng cơ sở hạ tầng dưới dạng mã (IaC) do HashiCorp tạo ra, là động lực chính để triển khai Dịch vụ tổng hợp vào đám mây công cộng mà bạn chọn. Nếu bạn chưa cài đặt terraform, hãy xem tài liệu của HashiCorp về cách lấy cli cục bộ.

Bạn cũng có thể cân nhắc cài đặt tfenv nếu cần chuyển đổi các phiên bản terraform.

Nếu bạn không thấy giải pháp cho vấn đề về Dịch vụ tổng hợp, hãy thông báo cho chúng tôi bằng cách gửi vấn đề trên GitHub hoặc gửi biểu mẫu hỗ trợ kỹ thuật.

Nếu bạn muốn chuyển đổi terraform theo cách thủ công:

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

Nếu lỗi Terraform không rõ ràng, bạn có thể xem đầu ra bằng cách bật ghi nhật ký Terraform ở cấp TRACE.

Google Cloud

Nhà cung cấp Terraform cho Google Cloud được HashiCorp và Google cùng phát triển. Nếu bạn có thêm câu hỏi và cần được tư vấn về cách khắc phục sự cố, hãy liên hệ với nhóm hỗ trợ Cloud Terraform để biết thêm thông tin hoặc truy cập vào phần Google của cổng Hashicorp Discuss.

Amazon Web Services

Bạn có thể xem tài liệu gỡ lỗi trên trang web AWS. Bạn cũng nên xem phần AWS của cổng thông tin HashiCorp Discuss.

Nếu bạn có câu hỏi khác về Terraform, hãy xem cổng thông tin cộng đồng HashiCorp. Để biết lời khuyên chung về cách khắc phục sự cố đối với Terraform, hãy đọc tài liệu gỡ lỗi của họ.

Hãy hết sức cẩn thận khi bạn sửa đổi các thư mục này, vì việc xoá chúng sẽ khiến terraform không nhận ra trạng thái nữa. Thao tác này sẽ cố gắng cung cấp lại tất cả các tài nguyên và báo lỗi khi bạn có một tài nguyên có tên hoàn toàn giống nhau. Nếu vấn đề này vẫn tiếp diễn, hãy liên hệ với chúng tôi qua biểu mẫu hỗ trợ kỹ thuật.

Hãy hết sức cẩn thận khi bạn sửa đổi các thư mục này, vì việc xoá chúng sẽ khiến terraform không nhận ra trạng thái nữa. Thao tác này sẽ cố gắng cung cấp lại tất cả các tài nguyên và báo lỗi khi bạn có một tài nguyên có tên hoàn toàn giống nhau. Nếu vấn đề này vẫn tiếp diễn, hãy liên hệ với chúng tôi qua biểu mẫu hỗ trợ kỹ thuật

Xác thực chế độ thiết lập đám mây

Xác minh xem Cơ sở hạ tầng Dịch vụ tổng hợp trong đám mây công khai mà bạn chọn đã được triển khai đúng cách hay chưa. Để làm việc này, chúng ta sẽ sử dụng các báo cáo gỡ lỗi mẫu và chạy một công việc ở chế độ gỡ lỗi. Nếu Dịch vụ tổng hợp có thể nhận được yêu cầu API và phản hồi, thì tức là dịch vụ này đang hoạt động. Nếu chưa thiết lập, bạn nên sử dụng Postman hoặc cURL để thiết lập các lệnh gọi API đến Dịch vụ tổng hợp. Xin lưu ý rằng bạn nên tắt chế độ gỡ lỗi, đặt thành false trong các thao tác tổng hợp thông thường.

Ngoài các bước sau, để xác thực thêm cơ sở hạ tầng Dịch vụ tổng hợp, hãy tìm hiểu tất cả các thành phần đám mây được cung cấp trong đám mây công khai của bạn.

Các bước

  1. Để tạo báo cáo gỡ lỗi mẫu và tệp miền đầu ra, hãy làm theo các bước có liên quan của lớp học lập trình:

  2. Chạy yêu cầu createJob với nội dung này, thay thế các phần giữ chỗ được đánh dấu:

    {
  "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. Chạy một yêu cầu getJob để xem phản hồi. Nếu bạn nhận được phản hồi sau đây, tức là Dịch vụ tổng hợp của bạn đã được triển khai đúng cách.

    {
    "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>
}

Nếu bạn không nhận được phản hồi có job_status: FINISHED, hãy thu thập thêm thông tin bằng cách chuyển đến tài nguyên công cụ tính toán hoặc EC2 của đám mây công khai mà bạn đã chọn. Kiểm tra phiên bản Dịch vụ tổng hợp và kiểm tra nhật ký, đồng thời ghi lại thông tin bạn thấy giữa TEE container launcher initiating và TEE container launcher exiting để cung cấp cho nhóm hỗ trợ kỹ thuật của chúng tôi.

Google Cloud

  1. Chuyển đến Google Cloud: Compute Engine.
  2. Nhấp vào VM instances (Các phiên bản máy ảo) rồi chọn phiên bản Aggregation Service (Dịch vụ tổng hợp) của bạn.
  3. Nhấp vào Details (Chi tiết) > Logs (Nhật ký) > Logging (Ghi nhật ký) (hoặc tìm kiếm Trình khám phá nhật ký).

Amazon Web Services

  1. Chuyển đến Amazon Web Services: EC2 Enclave.
  2. Nhấp vào EC2 instances (Các phiên bản EC2) rồi chọn phiên bản Aggregation Service (Dịch vụ tổng hợp) của bạn.
  3. Nhấp vào Thao tác > Giám sát và khắc phục sự cố > Lấy nhật ký hệ thống.

Kiểm tra và xem bạn có thấy thông báo lỗi nào trùng khớp trong hướng dẫn công khai của chúng tôi trên GitHub hay không.

Lưu ý: Nếu bạn vừa nâng cấp phiên bản hiện tại của Aggregation Service, thì toàn bộ quy trình cung cấp có thể mất đến vài giờ để hình ảnh phiên bản chính xác xuất hiện trong phiên bản dịch vụ điện toán cuối cùng của bạn. Liên hệ với chúng tôi nếu bạn không gặp trường hợp này.

Các bước tiếp theo

Nếu bạn không thấy giải pháp cho vấn đề về Aggregation Service, hãy thông báo cho chúng tôi bằng cách gửi vấn đề trên GitHub hoặc gửi biểu mẫu hỗ trợ kỹ thuật.