تشخیص & زیرساخت خود را تأیید کنید

مباحث راهنما:

زیرساخت خود را تشخیص دهید

این صفحه راهنمایی‌هایی در مورد نحوه عیب‌یابی و اعتبارسنجی زیرساخت سرویس تجمیع شما ارائه می‌دهد. مراحل شناسایی و حل مشکلات را دنبال کنید.

عیب‌یابی Terraform

Terraform، پلتفرم زیرساخت به عنوان کد (IaC) ایجاد شده توسط HashiCorp، محرک اصلی برای استقرار سرویس تجمیع در ابر عمومی انتخابی شما است. اگر Terraform را نصب نکرده‌اید، مستندات HashiCorp را در مورد نحوه دریافت cli به صورت محلی بررسی کنید.

اگر نیازهای شما ایجاب می‌کند که نسخه‌های terraform را تغییر دهید، می‌توانید نصب tfenv را نیز در نظر بگیرید.

اگر راه‌حلی برای مشکل سرویس تجمیع خود مشاهده نکردید، با ثبت مشکل در گیت‌هاب یا ارسال فرم پشتیبانی فنی ، به ما اطلاع دهید.

اگر ترجیح می‌دهید 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 ، خروجی را مشاهده کرد.

گوگل کلود

ارائه دهنده Terraform برای Google Cloud به طور مشترک بین HashiCorp و گوگل توسعه داده شده است. برای سوالات بیشتر و مشاوره عیب یابی، با پشتیبانی Cloud Terraform تماس بگیرید یا به بخش گوگل در پورتال Hashicorp Discuss مراجعه کنید.

خدمات وب آمازون

مستندات اشکال‌زدایی را می‌توان در سایت AWS یافت. همچنین توصیه می‌کنیم بخش AWS پورتال HashiCorp Discuss را بررسی کنید.

برای سوالات بیشتر در مورد Terraform، به پورتال انجمن HashiCorp مراجعه کنید. برای مشاوره عیب‌یابی عمومی Terraform، مستندات اشکال‌زدایی آنها را مطالعه کنید.

هنگام تغییر این دایرکتوری‌ها بسیار مراقب باشید، زیرا حذف آنها باعث می‌شود که Terraform دیگر وضعیت را تشخیص ندهد. سعی می‌کند تمام منابع را دوباره تأمین کند و وقتی منبعی دقیقاً با همان نام دارید، خطا می‌دهد. اگر این مشکل همچنان ادامه داشت، از طریق فرم پشتیبانی فنی با ما تماس بگیرید.

هنگام تغییر این دایرکتوری‌ها بسیار مراقب باشید، زیرا حذف آنها باعث می‌شود که Terraform دیگر وضعیت را تشخیص ندهد. سعی می‌کند تمام منابع را دوباره تأمین کند و وقتی منبعی دقیقاً با همان نام دارید، خطا می‌دهد. اگر این مشکل همچنان ادامه داشت، از طریق فرم پشتیبانی فنی با ما تماس بگیرید.

تنظیمات ابری خود را اعتبارسنجی کنید

بررسی کنید که آیا زیرساخت سرویس تجمیع شما در ابر عمومی انتخابی‌تان به درستی مستقر شده است یا خیر. برای انجام این کار، از گزارش‌های اشکال‌زدایی نمونه استفاده می‌کنیم و یک کار را در حالت اشکال‌زدایی اجرا می‌کنیم. اگر سرویس تجمیع بتواند درخواست API را دریافت و پاسخ دهد، می‌دانیم که فعال و در حال اجرا است. اگر قبلاً یکی را تنظیم نکرده‌اید، توصیه می‌کنیم از Postman یا cURL برای تنظیم فراخوانی‌های API خود به سرویس تجمیع استفاده کنید. توجه داشته باشید که حالت‌های اشکال‌زدایی باید در طول عملیات تجمیع عادی شما خاموش و روی false تنظیم شوند.

علاوه بر مراحل زیر، برای اعتبارسنجی بیشتر زیرساخت سرویس تجمیع خود، تمام اجزای ابری که در ابر عمومی شما تأمین می‌شوند را بررسی کنید.

مراحل

  1. برای تولید گزارش‌های اشکال‌زدایی نمونه و فایل‌های دامنه خروجی، مراحل مربوطه در codelabs را دنبال کنید:

  2. یک درخواست 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
  }
}

  3. برای مشاهده پاسخ، یک درخواست getJob اجرا کنید. اگر پاسخ زیر را دریافت می‌کنید، به این معنی است که سرویس Aggregation شما به درستی مستقر شده است.

    {
    "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 دریافت نکردید، با مراجعه به موتور محاسباتی یا منبع EC2 ابر عمومی انتخابی خود، اطلاعات بیشتری جمع‌آوری کنید. نمونه سرویس تجمیع خود و گزارش‌ها را بررسی کنید و اطلاعاتی را که بین TEE container launcher initiating و TEE container launcher exiting مشاهده می‌کنید، ثبت کنید تا در اختیار تیم پشتیبانی فنی ما قرار دهید.

گوگل کلود

  1. به Google Cloud: Compute Engine بروید.
  2. روی نمونه‌های ماشین مجازی کلیک کنید و نمونه سرویس تجمیع خود را انتخاب کنید.
  3. روی جزئیات > گزارش‌ها > گزارش‌گیری کلیک کنید (یا Logs Explorer را جستجو کنید).

خدمات وب آمازون

  1. به سرویس‌های وب آمازون بروید: EC2 Enclave .
  2. روی نمونه‌های EC2 کلیک کنید و نمونه سرویس تجمیع خود را انتخاب کنید.
  3. روی اقدامات > نظارت و عیب‌یابی > دریافت گزارش سیستم کلیک کنید.

بررسی کنید و ببینید آیا اعلان‌های خطایی مطابق با راهنمای عمومی ما در GitHub پیدا می‌کنید یا خیر.

توجه: اگر به تازگی نسخه فعلی سرویس تجمیع خود را ارتقا داده‌اید، فرآیند کامل آماده‌سازی ممکن است تا چند ساعت طول بکشد تا تصویر نمونه صحیح در نمونه نهایی سرویس محاسباتی شما منعکس شود. اگر این مورد برای شما صدق نمی‌کند، با ما تماس بگیرید .

مراحل بعدی

اگر راه‌حلی برای مشکل سرویس تجمیع خود مشاهده نکردید، با ثبت مشکل در گیت‌هاب یا ارسال فرم پشتیبانی فنی ، به ما اطلاع دهید.