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

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

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

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

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

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

يمكنك أيضًا تثبيت 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 في Cloud للحصول على مزيد من المعلومات أو الانتقال إلى قسم Google في بوابة Discuss الخاصة بشركة Hashicorp.

Amazon Web Services

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

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

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

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

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

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

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

الخطوات

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

  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، اجمع المزيد من المعلومات من خلال الانتقال إلى محرك الحوسبة أو مورد 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 واختَر مثيل "خدمة التجميع".
  3. انقر على الإجراءات > التتبّع وتحديد المشاكل وحلّها > الحصول على سجلّ النظام.

راجِع الإشعارات بحثًا عن أي إشعارات تتطابق مع الإشعارات الواردة في الإرشادات العامة على GitHub.

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

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

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