अपने इन्फ़्रास्ट्रक्चर का डाइग्नोस्टिक्स करना और उसकी पुष्टि करना

गाइड के विषय:

अपने इन्फ़्रास्ट्रक्चर की गड़बड़ी का पता लगाना

इस पेज पर, एग्रीगेशन सेवा के इन्फ़्रास्ट्रक्चर से जुड़ी समस्याओं को हल करने और उसकी पुष्टि करने के बारे में जानकारी दी गई है. समस्याओं का पता लगाने और उन्हें ठीक करने के लिए, यह तरीका अपनाएं.

Terraform से जुड़ी समस्याओं को हल करना

HashiCorp ने इंफ़्रास्ट्रक्चर ऐज़ कोड (आईएसी) प्लैटफ़ॉर्म Terraform बनाया है. यह आपके चुने गए पब्लिक क्लाउड पर एग्रीगेशन सेवा को डिप्लॉय करने में अहम भूमिका निभाता है. अगर आपने terraform इंस्टॉल नहीं किया है, तो HashiCorp के दस्तावेज़ देखें. इनमें सीएलआई को स्थानीय तौर पर पाने का तरीका बताया गया है.

अगर आपको Terraform के वर्शन बदलने की ज़रूरत है, तो tfenv इंस्टॉल करें.

अगर आपको एग्रीगेशन सेवा से जुड़ी समस्या का समाधान नहीं मिलता है, तो हमें इसकी सूचना दें. इसके लिए, GitHub पर समस्या की शिकायत करें या तकनीकी सहायता फ़ॉर्म सबमिट करें.

अगर आपको मैन्युअल तरीके से टेराफ़ॉर्म पर स्विच करना है, तो:

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 से जुड़ी गड़बड़ी के बारे में साफ़ तौर पर नहीं बताया गया है, तो TRACE लेवल पर Terraform लॉगिंग चालू करके आउटपुट देखा जा सकता है.

Google Cloud

Google Cloud के लिए Terraform प्रोवाइडर को HashiCorp और Google ने मिलकर बनाया है. अगर आपको कोई और सवाल पूछना है या समस्या हल करने से जुड़ी सलाह चाहिए, तो ज़्यादा जानकारी के लिए Cloud Terraform की सहायता टीम से संपर्क करें. इसके अलावा, Hashicorp Discuss पोर्टल के Google सेक्शन पर जाएं.

Amazon वेब सेवाएं

डीबग करने से जुड़े दस्तावेज़, AWS की साइट पर देखे जा सकते हैं. हमारा सुझाव है कि आप HashiCorp Discuss पोर्टल का AWS सेक्शन भी देखें.

Terraform के बारे में ज़्यादा जानने के लिए, HashiCorp कम्यूनिटी पोर्टल पर जाएं. Terraform से जुड़ी सामान्य समस्याओं को हल करने के बारे में सलाह पाने के लिए, डीबग करने से जुड़ा दस्तावेज़ पढ़ें.

इन डायरेक्ट्री में बदलाव करते समय सावधानी बरतें, क्योंकि इन्हें हटाने पर Terraform, स्टेट को पहचान नहीं पाएगा. यह सभी संसाधनों को फिर से उपलब्ध कराने की कोशिश करेगा. अगर आपके पास ठीक उसी नाम का कोई संसाधन है, तो आपको गड़बड़ी का मैसेज मिलेगा. अगर यह समस्या बनी रहती है, तो तकनीकी सहायता फ़ॉर्म में जाकर हमसे संपर्क करें.

इन डायरेक्ट्री में बदलाव करते समय सावधानी बरतें, क्योंकि इन्हें हटाने पर Terraform, स्टेट को पहचान नहीं पाएगा. यह सभी संसाधनों को फिर से उपलब्ध कराने की कोशिश करेगा. अगर आपके पास ठीक उसी नाम का कोई संसाधन है, तो आपको गड़बड़ी का मैसेज मिलेगा. अगर यह समस्या बनी रहती है, तो तकनीकी सहायता फ़ॉर्म में जाकर हमसे संपर्क करें

Cloud Setup की पुष्टि करना

पुष्टि करें कि आपने जिस पब्लिक क्लाउड को चुना है उसमें एग्रीगेशन सेवा का इन्फ़्रास्ट्रक्चर सही तरीके से डिप्लॉय किया गया है. इसके लिए, हम डीबग रिपोर्ट के सैंपल का इस्तेमाल करेंगे और डीबग मोड में कोई जॉब चलाएंगे. अगर Aggregation Service, एपीआई अनुरोध को स्वीकार करके उसका जवाब दे पाती है, तो इसका मतलब है कि यह सेवा काम कर रही है. अगर आपने अब तक ऐसा नहीं किया है, तो हमारा सुझाव है कि आप 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 वाला जवाब नहीं मिलता है, तो अपने चुने गए पब्लिक क्लाउड के Compute Engine या EC2 संसाधन पर जाकर ज़्यादा जानकारी इकट्ठा करें. Aggregation Service के अपने इंस्टेंस की जांच करें. साथ ही, लॉग की जांच करें और 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 पर उपलब्ध सार्वजनिक दिशा-निर्देशों में, गड़बड़ी की सूचनाओं से मिलती-जुलती कोई जानकारी मिलती है.

ध्यान दें: अगर आपने Aggregation Service के मौजूदा वर्शन को अभी-अभी अपग्रेड किया है, तो पूरी प्रोविज़निंग प्रोसेस में कुछ घंटे लग सकते हैं. ऐसा इसलिए, ताकि सही इंस्टेंस इमेज आपके फ़ाइनल Compute Service इंस्टेंस में दिख सके. अगर आपके साथ ऐसा नहीं है, तो हमसे संपर्क करें.

अगले चरण

अगर आपको Aggregation Service से जुड़ी समस्या का समाधान नहीं मिलता है, तो हमें इसकी सूचना दें. इसके लिए, GitHub पर समस्या की शिकायत करें या तकनीकी सहायता फ़ॉर्म सबमिट करें.