আপনার একত্রীকরণ কাজ নির্ণয়

নিম্নলিখিত সারণীগুলি অগণিত সমস্যা এবং ত্রুটির স্থিতি কোডের বিশদ বিবরণ দেয় কারণ এবং ক্রিয়াগুলির সম্ভাব্য কারণগুলির সাথে আপনি আপনার স্থাপনা প্রশমিত করতে পারেন। আপনি যদি অ্যাগ্রিগেশন পরিষেবার জন্য সম্পূর্ণ ত্রুটির স্পেসিফিকেশন এবং প্রশমন পরীক্ষা করতে চান, আমাদের বর্তমান পাবলিক নির্দেশিকা দেখুন।

গাইড বিষয়:

অনুমতি এবং অনুমোদন ত্রুটি

ইস্যু আপনি যখন terraform plan এক্সিকিউট করছেন বা আপনার পাবলিক ক্লাউড প্রোজেক্টে terraform apply তখন অনুমতির সমস্যা।
উদাহরণ ত্রুটি Error: UnauthorizedOperation: You are not authorized to perform this operation.
রেজোলিউশন

আপনি যে পাবলিক ক্লাউড ব্যবহার করছেন তার cli (কমান্ড-লাইন ইন্টারফেস) এ আপনি সঠিকভাবে প্রমাণীকরণ করেছেন তা পরীক্ষা করুন।

আমাজন ওয়েব সার্ভিসেস

এগ্রিগেশন পরিষেবার জন্য প্রয়োজনীয় দৃষ্টান্ত এবং অন্যান্য পরিষেবাগুলি তৈরি করতে সক্ষম হওয়ার জন্য AWS-এর ব্যবহারকারীর অনুমতির প্রয়োজন৷ একবার আপনি এটি প্রয়োগ করলে, আপনি টেরাফর্ম পরিকল্পনা সম্পাদন করতে এবং কোনো সমস্যা ছাড়াই আবেদন করতে সক্ষম হবেন।

গুগল ক্লাউড প্ল্যাটফর্ম

Google ক্লাউডে, মনে রাখবেন যে আপনাকে Terraform এর দ্বিতীয়ার্ধ স্থাপন করার জন্য একটি পরিষেবা অ্যাকাউন্টের ছদ্মবেশী করতে হবে। আপনার টেরাফর্ম প্রয়োগ কমান্ড ব্যর্থ হতে পারে যদি আপনি এই পদক্ষেপটি এড়িয়ে যান কারণ স্থাপনার পরিষেবা অ্যাকাউন্টে সংস্থান তৈরি করার জন্য সমস্ত প্রয়োজনীয় অনুমতি রয়েছে। গিটহাব ডকুমেন্টেশনে "আপনার স্থাপনার পরিবেশ সেট আপ করুন" এর ধাপ 4 দেখুন।

গোপনীয়তা বাজেট ত্রুটি

ত্রুটি PRIVACY_BUDGET_ERROR
কারণ এটি নির্দেশ করবে যে গোপনীয়তা বাজেট পরিষেবার সাথে একটি ত্রুটির কারণে পরিষেবাটি প্রতিবেদনগুলি প্রক্রিয়া করতে অক্ষম ছিল৷
চেক করুন ত্রুটিটি বিরতিমূলক ছিল কিনা তা দেখার জন্য আপনি একবার কাজটি পুনরায় চেষ্টা করলে, প্রযুক্তিগত সহায়তা ফর্মের মাধ্যমে আমাদের সাথে যোগাযোগ করুন৷
ত্রুটি PRIVACY_BUDGET_AUTHORIZATION_ERROR
কারণ অনবোর্ডিং এর সময় তারা যা প্রদান করেছে তার থেকে আপনি হয়ত ভিন্ন রিপোর্টিং মূল ব্যবহার করছেন।
চেক করুন

নিশ্চিত করুন যে আপনি createJob অনুরোধের attribution_report_to ফিল্ডে যে সাইটটি জমা দিচ্ছেন সেটি একই সাইট যা অনবোর্ডিংয়ের সময় জমা দেওয়া হয়েছিল।

সাইটে যা অনবোর্ড করা হয়েছিল তার সাথে মিল বা একটি সাবডোমেন হওয়া উচিত। মনে রাখবেন যে অ্যাগ্রিগেশন পরিষেবা অনবোর্ডিং শীর্ষ স্তরের ডোমেনে পরিচালনা করা হয় এবং শীর্ষ স্তরের ডোমেন অনবোর্ড হয়ে গেলে সমস্ত সাবডোমেন একত্রিত পরিষেবা ব্যবহার করার যোগ্য৷

ত্রুটি PRIVACY_BUDGET_AUTHENTICATION_ERROR
কারণ আপনি হয়ত পুরানো বা ভুল ARN ব্যবহার করছেন।
চেক করুন গুগল ক্লাউড প্ল্যাটফর্ম

আপনার অ্যাগ্রিগেশন সার্ভিস ডিপ্লোয়মেন্টে ব্যবহৃত পরিষেবা অ্যাকাউন্টটি অনবোর্ডিংয়ের সময় দেওয়া পরিষেবা অ্যাকাউন্টের সাথে মেলে কিনা তা পরীক্ষা করুন। এটি অবশ্যই একই প্রকল্পের অন্তর্গত নয়, হুবহু মেলে।

আমাজন ওয়েব সার্ভিসেস

এটি প্রত্যাশিত যে আপনি একই সমন্বয়কারী ব্যবহার করছেন যা আপনার জন্য ইমেলের মাধ্যমে প্রদান করা হয়েছিল। আপনার যদি এখনও সমস্যা হয়, আপনার auto.tfvars ফাইল এবং প্রতিবেদনের মূল তথ্য সংগ্রহ করুন এবং প্রযুক্তিগত সহায়তা ফর্মে আমাদের সাথে যোগাযোগ করুন।

ত্রুটি PRIVACY_BUDGET_EXHAUSTED
কারণ ত্রুটি:
            "result_info": {
              "return_code": "PRIVACY_BUDGET_EXHAUSTED",
              "return_message": "com.google.aggregate.adtech.worker.exceptions.AggregationJobProcessException:
              Insufficient privacy budget for one or more aggregatable reports. No aggregatable report can appear
              in more than one aggregation job. Information related to reports that do not have budget can be
              found in the following file:
              File path: //
              Filename: privacy budget exhausted debugging information  \n
              com.google.aggregate.adtech.worker.aggregation.concurrent.ConcurrentAggregationProcessor.consumePrivacyBudgetUnits(ConcurrentAggregationProcessor.java:525) \n com.google.aggregate.adtech.worker.aggregation.concurrent.ConcurrentAggregationProcessor.process(ConcurrentAggregationProcessor.java:319) \n com.google.aggregate.adtech.worker.WorkerPullWorkService.run(WorkerPullWorkService.java:157)",
              "error_summary": {
                  "error_counts": [],
                  "error_messages": []
              },
              "finished_at": 
            }

গোপনীয়তা বাজেট ক্লান্তির সমস্যাটি ঘটে যখন আপনি একটি প্রতিবেদন ব্যাচ করার চেষ্টা করেন যার ভাগ করা আইডি ইতিমধ্যেই একটি সফল ব্যাচে অন্তর্ভুক্ত করা হয়েছে৷ এই ত্রুটিটি "কোনও সদৃশ নেই" নিয়মের কারণে ঘটে যেখানে সমষ্টিগত প্রতিবেদনগুলি শুধুমাত্র একটি ব্যাচে প্রদর্শিত হওয়ার অনুমতি দেওয়া হয় এবং শুধুমাত্র একটি সারাংশ প্রতিবেদনে অবদান রাখতে পারে৷

প্রতিটি প্রতিবেদনে একটি "শেয়ারড আইডি" বরাদ্দ করা হবে যাতে shared_info ক্ষেত্রগুলি API, reporting_origin , destination_site , source_registration_time (দিন অনুসারে কাটা হয়), scheduled_report_time (ঘন্টা অনুসারে কাটা হয়) এবং version থাকে। এর অর্থ হল একাধিক রিপোর্ট একই "শেয়ারড আইডি" এর অন্তর্গত হতে পারে যদি তারা শেয়ার shared_info ক্ষেত্রের একই বৈশিষ্ট্যগুলি ভাগ করে।

চেক করুন

আমরা সুপারিশ করি যে আপনি আপনার ত্রুটি পরিদর্শন এবং সমাধান করার জন্য কাজের প্রতিক্রিয়া থেকে প্রদত্ত গোপনীয়তা বাজেট নিঃশেষিত সমর্থন চেষ্টা করে দেখুন। এটি একটি নতুন হেল্পার JSON ফাইল প্রদান করে যা কি রিপোর্টগুলি ত্রুটিতে অবদান রেখেছে তা দেখতে দৃশ্যমানতা প্রদান করবে।

মনে রাখবেন যে আপনি যদি সঠিকভাবে ব্যাচিং করেন তবে আপনি বাজেট পুনরুদ্ধারের জন্য যোগ্য হতে পারেন ( ব্যাখ্যাকারী )। সুপারিশ করুন যে তারা ব্যাখ্যাকারীটি পড়ে এবং ফর্মটি পূরণ করে, কিন্তু মনে রাখবেন যে বাজেটটি সফলভাবে পুনরুদ্ধার করতে এবং আবার কাজ চালানোর জন্য তাদের অনুরোধ অনুমোদন করা প্রয়োজন।

ত্রুটি DEBUG_SUCCESS_WITH_PRIVACY_BUDGET_EXHAUSTED
কারণ এটি নির্দেশ করে যে আপনি ডিবাগ মোডে কাজটি চালাচ্ছেন। createJob অনুরোধের job_parameters এ debug_run: true আছে। যখন debug_run পতাকা সক্ষম করা হয়, আপনি ডিবাগিং উদ্দেশ্যে একাধিকবার প্রতিবেদনটি চালাতে পারেন। এই ত্রুটি বার্তাটি আপনাকে জানায় যে রিপোর্টের গোপনীয়তা বাজেট শেষ হয়ে যাওয়ার কারণে কাজটি ব্যর্থ হয়ে যেত যদি এটি ডিবাগ মোডে চালানো না হয়। এই ত্রুটি শুধুমাত্র রিলিজ v2.10.0 বা নীচে বৈধ হবে.
চেক করুন createJob রিকোয়েস্ট বডিতে job_parameters এ debug_run থাকবে। 
            {
              "job_request_id": "{job_request_id}",
              "input_data_blob_prefix": "{input_prefix}",
              "input_data_bucket_name": "{input_bucket}",
              "output_data_blob_prefix": "{output_prefix}",
              "output_data_bucket_name": "{output_bucket}",
              "job_parameters": {
                "output_domain_blob_prefix": "{output_domain_prefix}",
                "output_domain_bucket_name": "{output_domain_bucket}",
                "attribution_report_to": "{reporting_origin}",
                "debug_run": "true"
              }
            }

কাজের রানটাইম ত্রুটি

ত্রুটি INVALID_JOB
শেষবিন্দু createJob
কারণ এটি ঘটতে পারে যখন প্রদত্ত ডিবাগ গোপনীয়তা এপসিলন সীমার মধ্যে না থাকে (0.64], বা যখন কাজের পরামিতিগুলি যাচাইকরণে ব্যর্থ হয়৷
চেক করুন কি epsilon মান ব্যবহার করা হয়েছিল? createJob রিকোয়েস্টে কোন কাজের প্যারামিটার ব্যবহার করা হয়েছে এবং সেগুলি কি আপনার পরিবেশের সাথে মেলে? তারা সঠিকভাবে ফরম্যাট করা হয়? প্রয়োজনীয় সংশোধন করুন এবং কাজ পুনরায় চেষ্টা করুন.
ত্রুটি INTERNAL_ERROR
শেষবিন্দু getJob
কারণ একটি ফর্ম্যাটিং সমস্যা হতে পারে যা আউটপুট ডোমেন বা রিপোর্টের জন্য ব্যর্থ প্রক্রিয়াকরণের কারণ হতে পারে। আপনার একত্রিতকরণ পরিষেবা স্থাপনের সাথেও একটি সমস্যা হতে পারে।
চেক করুন নিশ্চিত করুন যে আউটপুট ডোমেন অবস্থান একটি বৈধ পথ। কাজ পুনরায় চেষ্টা করুন. ত্রুটি অব্যাহত থাকলে, তাদের সমষ্টি পরিষেবা স্থাপনার সমস্যা সমাধানের জন্য auto.tfvars ফাইল এবং Terraform প্ল্যান আউটপুট অনুরোধ করুন।
ত্রুটি RESULT_WRITE_ERROR
শেষবিন্দু getJob
কারণ এটি ঘটতে পারে যখন আউটপুট ডিরেক্টরিতে লেখা ব্যর্থ হয়, হয় ক্ষণস্থায়ীভাবে বা ডিরেক্টরিতে লেখার অনুমতি না থাকার কারণে। মনে রাখবেন যে লেখার ত্রুটিগুলি গোপনীয়তার বাজেট খরচ করে, এবং কাজটি পুনরায় চেষ্টা করা যাবে না। এটি PRIVACY_BUDGET_EXHAUSTED ত্রুটির আরেকটি ত্রুটির ফলাফলে অবদান রাখতে পারে৷
চেক করুন এই ত্রুটি কি প্রতিটি কাজের ক্ষেত্রে ঘটছে, নাকি শুধুমাত্র মাঝে মাঝে? যদি এটি প্রতিটি কাজের মধ্যে ঘটে থাকে তবে নিশ্চিত করুন যে আপনি আউটপুট ডিরেক্টরিতে লেখার অনুমতি সক্ষম করেছেন। যদি এটি একটি বিরতিহীন ব্যর্থতা হয় তবে অনুমতিগুলি সঠিক হওয়া উচিত। এটি একটি পরিচিত সমস্যা যে সারাংশ প্রতিবেদন লেখা ব্যর্থ হতে পারে কিন্তু গোপনীয়তা বাজেট এখনও গ্রাস করা হবে। এই ক্ষেত্রে, আপনি বাজেট পুনরুদ্ধারের অনুরোধ করতে পারেন ( ব্যাখ্যাকারী )।
ইস্যু একটি কাজ চালানোর সময় 403 ত্রুটির সম্মুখীন হওয়া এবং একটি প্রত্যয়ন পরিষেবা টোকেন পুনরুদ্ধার করা এবং চাকরিটি সর্বদা "RECEIVED" স্ট্যাটাস নিয়ে ফিরে আসে।
ত্রুটি 
            {
                "job_status": "RECEIVED",
                "request_received_at": "{utc timestamp}",
                "request_updated_at": "{utc timestamp}",
                "job_request_id": "0001",
                "input_data_blob_prefix": "reports/",
                "input_data_bucket_name": "{bucket_name}",
                "output_data_blob_prefix": "summary/",
                "output_data_bucket_name": "{bucket_name}",
                "postback_url": "",
                "job_parameters": {
                    "output_domain_bucket_name": "{bucket_name}",
                    "output_domain_blob_prefix": "output_domain/",
                    "attribution_report_to": 
                }
            }
রেজোলিউশন

চাকরি RECEIVED স্থিতিতে আটকে যাচ্ছে এবং 403 ত্রুটি সাধারণত ঘটে যখন পরিষেবা অ্যাকাউন্টটি এখনও অনবোর্ড করা হয়নি। যাচাই করুন যে আপনি যে পরিষেবা অ্যাকাউন্টটি ব্যবহার করছেন তা আপনার অনবোর্ডিং অনুরোধে যা দিয়েছেন তার সাথে মেলে। আপনি যদি একটি অনবোর্ডিং অনুরোধ সম্পূর্ণ না করে থাকেন, তাহলে অনুগ্রহ করে অনবোর্ডিং ফর্ম এবং তালিকাভুক্তি ফর্মগুলি পূরণ করুন৷

একবার আপনি আপনার তালিকাভুক্তি এবং অনবোর্ডিং স্ট্যাটাস যাচাই করে নিলে, আপনার চলমান চাকরির কী হয়েছে তা পরীক্ষা করুন।

আমাজন ওয়েব সার্ভিসেস

যখন এটি ঘটবে, সম্ভবত AWS ছিটমহলটি চলছে না বা বিপর্যস্ত হয়ে পড়েছে এবং এইভাবে কাজগুলি বাছাই করা হচ্ছে না।

  1. EC2 ইনস্ট্যান্স সেশন ম্যানেজারের সাথে সংযোগ করুন।
  2. এই AWS ডকুমেন্টেশন অনুসরণ করুন, যাতে সেশন ম্যানেজারের সাথে সংযোগ করার জন্য নিম্নলিখিত পদক্ষেপগুলি অন্তর্ভুক্ত রয়েছে৷
  3. AWS কনসোল ম্যানেজার > EC2 > ইনস্ট্যান্সে যান।
  4. চলমান অ্যাগ্রিগেশন সার্ভিসের ইনস্ট্যান্স আইডি নির্বাচন করুন।
  5. "সেশন ম্যানেজার" ট্যাব > "সংযোগ করুন" বোতাম নির্বাচন করুন। এটি আপনাকে আপনার উদাহরণের সাথে সংযুক্ত করবে।
  6. একবার এনক্লেভ ইনস্ট্যান্স চালু হলে, টার্মিনালে চালান:
    sudo nitro-cli describe-enclaves
    যদি এই কমান্ডটি প্রত্যাশিত হিসাবে লগগুলি না দেখায়, আবার চেষ্টা করার আগে নিম্নলিখিতটি চালান:
    sudo nitro-cli run-enclave --cpu-count=2 --memory=7000 --eif-path=/opt/google/worker/enclave.eif
  7. AWS এনক্লেভ ক্র্যাশ হয়েছে কিনা তা পরীক্ষা করতে, কমান্ডটি চালান: sudo journalctl -u aggregate-worker.service
  8. আপনি আউটপুট লগ ফাইলিং দেখতে হবে যেমন:
    Starting aggregate-worker.service - Watcher script for nitro enclave.
    কোনো ব্যর্থতা, ইত্যাদি থাকলে ত্রুটিগুলি এখানে দৃশ্যমান হওয়া উচিত।
গুগল ক্লাউড প্ল্যাটফর্ম

ম্যানেজড ইনস্ট্যান্স গ্রুপ (MIG) সুস্থ নাও হতে পারে। যদি এটি প্রথমবারের মতো সেটআপ হয়, অথবা আপনি adtech_setup Terraform ধ্বংস করে পুনরায় তৈরি করেন, নিশ্চিত করুন যে আপনার পরিষেবা অ্যাকাউন্ট অনবোর্ড করা হয়েছে। যদি পরিষেবা অ্যাকাউন্টটি অনবোর্ড করা না হয়, তাহলে এমআইজিগুলি স্বাস্থ্যকর হবে না।

  1. ক্লাউড কনসোল, কম্পিউট ইঞ্জিন > ইনস্ট্যান্স গ্রুপে নেভিগেট করুন
  2. আপনার স্ট্যাটাস কলামগুলি দেখুন (সবুজ চেক চিহ্নগুলি স্বাস্থ্যকর)
  3. ইনস্ট্যান্স গ্রুপগুলির একটিতে ক্লিক করুন এবং সমস্যাটি সম্পর্কে আরও জানতে ত্রুটি ট্যাবটি দেখুন। VM-স্তরের তথ্য অ্যাক্সেস করতে ইনস্ট্যান্স নামের উপর ক্লিক করুন।
  4. আপনি ইনস্ট্যান্স গ্রুপের সাথে ইন্টারঅ্যাক্ট করতে এবং একই তথ্য পেতে আপনার টার্মিনাল ব্যবহার করতে পারেন। তালিকা-ত্রুটি কমান্ড চেষ্টা করুন:
    gcloud compute instance-groups managed list-errors --region=
    নিম্নলিখিত একটি উদাহরণ আউটপুট. 
                      INSTANCE_URL: https://www.googleapis.com/compute/v1/projects/aggservice-sandbox/zones/us-central1-c/instances/collector-operator-demo-env-67hd
                  ACTION: VERIFYING
                  ERROR_CODE: WAITING_FOR_HEALTHY_TIMEOUT_EXCEEDED
                  ERROR_MESSAGE: Waiting for HEALTHY state timed out (autohealingPolicy.initialDelay=200 sec) for instance projects/aggservice-sandbox/zones/us-central1-c/instances/collector-operator-demo-env-67hd and health check projects/aggservice-sandbox/global/healthChecks/operator-demo-env-collector-auto-heal-hc.
                  TIMESTAMP: 
                  INSTANCE_TEMPLATE: https://www.googleapis.com/compute/v1/projects/aggservice-sandbox/global/instanceTemplates/operator-demo-env-collector
                  VERSION_NAME: primary
আপনি যদি সমস্যাগুলি দেখতে থাকেন তবে এটি সংরক্ষণ করুন এবং এটি আমাদের দলকে সরবরাহ করুন। পরবর্তী পদক্ষেপগুলি চালিয়ে যান।

আপনার সারাংশ রিপোর্ট প্রত্যাশিত রূপান্তরিত হয়?

একটি পরিস্থিতি দেখা দিতে পারে যেখানে আপনার getJob কলটি সফল হয়েছে, কিন্তু অ্যাগ্রিগেশন সার্ভিস দ্বারা ফেরত দেওয়া সারাংশ রিপোর্টে একটি সমস্যা রয়েছে। সংক্ষিপ্ত প্রতিবেদনটি AVRO ফর্ম্যাট করা হয়েছে এবং JSON ফর্ম্যাটে রূপান্তর করতে হবে৷ একবার json ফরম্যাটে রূপান্তরিত হলে, এটি নীচের মত দেখাবে।

{
  "bucket": "\u0005Y",
  "metric": 26308
}

যদি AVRO রূপান্তরে কোনো সমস্যা হয়, তাহলে AVRO টুলগুলি ব্যবহার করার চেষ্টা করুন এবং AVRO রিপোর্টে নিম্নলিখিত কমান্ডটি ব্যবহার করুন। java -jar avro-tools-1.11.1.jar tojson [report_name].avro > [report_name].json স্থিতিশীল সংস্করণগুলি এখান থেকে ডাউনলোড করা যেতে পারে। আপনার আরও সহায়তার প্রয়োজন হলে, আমাদের পরবর্তী পদক্ষেপগুলি চালিয়ে যান।

পরবর্তী পদক্ষেপ

গোপনীয়তা স্যান্ডবক্স স্ট্যাটাস ড্যাশবোর্ডে বা সর্বজনীন GitHub সংগ্রহস্থলে অন্য কেউ একই সমস্যার সম্মুখীন হয়েছে কিনা তা পরীক্ষা করুন।

আপনি যদি আপনার অ্যাগ্রিগেশন পরিষেবা সংক্রান্ত সমস্যার সমাধান দেখতে না পান, তাহলে একটি GitHub সমস্যা ফাইল করে বা প্রযুক্তিগত সহায়তা ফর্ম জমা দিয়ে আমাদের জানান।