تشخيص البنية الأساسية والتحقّق منها

مواضيع الدليل:

• تحديد المشاكل وحلّها في Terraform
• التحقّق من صحة إعداد السحابة الإلكترونية

تشخيص البنية الأساسية

تقدّم هذه الصفحة إرشادات حول كيفية تحديد المشاكل في البنية الأساسية لخدمة التجميع والتحقّق منها وحلّها. اتّبِع الخطوات لتحديد المشاكل وحلّها.

تحديد المشاكل وحلّها في Terraform

تُعدّ منصة "البنية الأساسية كرمز" (IaC) التي أنشأتها HashiCorp، والمعروفة باسم Terraform، المحرّك الرئيسي لنشر "خدمة التجميع" على السحابة الإلكترونية العامة التي تختارها. إذا لم تكن أداة Terraform مثبّتة، يمكنك الاطّلاع على مستندات HashiCorp حول كيفية الحصول على واجهة سطر الأوامر محليًا.

يمكنك أيضًا تثبيت tfenv إذا كنت بحاجة إلى التبديل بين إصدارات Terraform.

إذا لم تجد حلاً لمشكلتك في Aggregation Service، يُرجى إعلامنا بذلك من خلال الإبلاغ عن مشكلة على 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. لمزيد من الأسئلة ونصائح حول تحديد المشاكل وحلّها، يُرجى التواصل مع فريق دعم Cloud Terraform للحصول على مزيد من المعلومات أو الانتقال إلى قسم Google في بوابة Hashicorp Discuss.

Amazon Web Services

يمكنك العثور على مستندات تصحيح الأخطاء على موقع AWS الإلكتروني. ننصحك أيضًا بالاطّلاع على قسم AWS في بوابة HashiCorp Discuss.

لمزيد من الأسئلة حول Terraform، يُرجى الاطّلاع على بوابة منتدى HashiCorp. للحصول على نصائح حول تحديد المشاكل وحلّها في Terraform بشكل عام، يمكنك الاطّلاع على مستندات تصحيح الأخطاء.

يجب توخّي الحذر الشديد عند تعديل هذه الدلائل، لأنّ إزالتها ستؤدي إلى عدم تعرّف Terraform على الحالة بعد الآن. سيحاول إعادة توفير جميع الموارد وسيحدث خطأ عندما يكون لديك مورد يحمل الاسم نفسه بالضبط. إذا استمرت هذه المشكلة، يُرجى التواصل معنا من خلال نموذج الدعم الفني.

يجب توخّي الحذر الشديد عند تعديل هذه الدلائل، لأنّ إزالتها ستؤدي إلى عدم تعرّف Terraform على الحالة بعد الآن. سيحاول إعادة توفير جميع الموارد وسيحدث خطأ عندما يكون لديك مورد يحمل الاسم نفسه بالضبط. إذا استمرت هذه المشكلة، يُرجى التواصل معنا من خلال نموذج الدعم الفني.

التحقّق من صحة إعدادات Cloud

تأكَّد من نشر البنية الأساسية لخدمة التجميع بشكل صحيح في السحابة الإلكترونية العامة التي اخترتها. ولإجراء ذلك، سنستخدم عيّنات من تقارير تصحيح الأخطاء وننفّذ مهمة في وضع تصحيح الأخطاء. إذا تمكّنت "خدمة التجميع" من تلقّي طلب واجهة برمجة التطبيقات والردّ عليه، يعني ذلك أنّها تعمل بشكل سليم. إذا لم يسبق لك إعدادها، ننصحك باستخدام Postman أو cURL لإعداد طلبات واجهة برمجة التطبيقات إلى "خدمة التجميع". يُرجى العِلم أنّه يجب إيقاف أو ضبط أوضاع تصحيح الأخطاء على "خطأ" أثناء عمليات التجميع العادية.

بالإضافة إلى الخطوات التالية، للتحقّق من صحة البنية الأساسية لخدمة التجميع، عليك التحقّق من جميع مكوّنات السحابة الإلكترونية التي يتم توفيرها في السحابة الإلكترونية العامة.

الخطوات

1. لإنشاء نماذج من تقارير تصحيح الأخطاء وملفات النطاقات الناتجة، اتّبِع الخطوات ذات الصلة في دروس البرمجة:

   • Google Cloud: اتّبِع الخطوات من 3.1.1 إلى 3.1.4 في Aggregation Service Google Cloud Codelab.
   • ‫Amazon Web Services: اتّبِع الخطوات من 4.1 إلى 4.4 من Aggregation Service AWS Codelab

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 للاطّلاع على الرد. إذا تلقّيت الردّ التالي، يعني ذلك أنّه تم نشر "خدمة تجميع البيانات" بشكل صحيح.

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

1. انتقِل إلى Google Cloud: Compute Engine.
2. انقر على الأجهزة الافتراضية واختَر مثيل "خدمة التجميع".
3. انقر على التفاصيل > السجلات > التسجيل (أو ابحث عن "مستكشف السجلات").

Amazon Web Services

1. انتقِل إلى Amazon Web Services: EC2 Enclave.
2. انقر على أجهزة EC2 الافتراضية واختَر جهاز Aggregation Service الافتراضي.
3. انقر على الإجراءات > المراقبة وتحديد المشاكل وحلّها > الحصول على سجلّ النظام.

افحص الإشعارات لمعرفة ما إذا كان أي منها يتطابق مع إشعارات الخطأ الواردة في الإرشادات المتاحة للجميع على GitHub.

ملاحظة: إذا كنت قد أجريت ترقية للتو للإصدار الحالي من Aggregation Service، قد تستغرق عملية التوفير الكاملة بضع ساعات حتى تظهر صورة المثيل الصحيحة في مثيل خدمة الحوسبة النهائي. يُرجى التواصل معنا إذا لم يكن هذا هو الحال بالنسبة إليك.

الخطوات التالية

إذا لم تجد حلاً لمشكلة "خدمة التجميع"، يُرجى إعلامنا بذلك من خلال الإبلاغ عن مشكلة على GitHub أو إرسال نموذج الدعم الفني.