আপনার পরিবেশ নির্ণয় করুন (নতুন বা আপগ্রেড)

অ্যাগ্রিগেশন সার্ভিসের সাথে কাজ করার সময় একাধিক কারণ সমস্যা তৈরি করতে পারে, যার মধ্যে রয়েছে রিপোর্ট ফর্ম্যাটিং, আউটপুট ডোমেন সমস্যা এবং সমন্বয়কারী সমস্যা। সমস্যাটি সঠিকভাবে নির্ণয় করার জন্য ত্রুটির উৎস এবং এতে থাকা যেকোনো মেটাডেটা বোঝা গুরুত্বপূর্ণ।

গাইডের বিষয়গুলি:

• ক্লায়েন্ট পরিমাপ API সেটআপ যাচাই করুন
• আপনার রিপোর্টিং অরিজিন সেটআপের সমস্যা সমাধান করা হচ্ছে
• আপনার সামগ্রিক প্রতিবেদনের সমস্যা সমাধান করা
• আপনার ডিপ্লয়মেন্ট ভার্সনটি পরীক্ষা করুন

ক্লায়েন্ট পরিমাপ API সেটআপ যাচাই করুন

আপনার অরিজিন সার্ভারটি সঠিকভাবে নিবন্ধিত হয়েছে কিনা তা যাচাই করার পরে, নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:

1. আপনি কীভাবে রিপোর্ট ট্রিগার করছেন তা পরীক্ষা করুন। নিশ্চিত করুন যে আপনি কোন API ব্যবহার করছেন সেই অনুসারে সঠিক রিপোর্ট ফর্ম্যাটটি পাচ্ছেন:

   • অ্যাট্রিবিউশন রিপোর্টিং API
     • অ্যাট্রিবিউশন রিপোর্টিং API-এর জন্য, যাচাই করুন যে আপনি সোর্স ( Event and Summary ) সফলভাবে নিবন্ধিত করেছেন। ট্রিগার রেজিস্ট্রেশন ( Event and Summary ) সম্পাদন করতে, হেডার ভ্যালিডেশন টুল ব্যবহার করে Attribution-Reporting-Register-Trigger এ পাস করা JSON সঠিক কিনা তা যাচাই করুন। (আরও পড়ুন Attribution Reporting API Summary Reports )
   • ব্যক্তিগত সমষ্টি API
     • প্রাইভেট এগ্রিগেশন API-তে রিপোর্টিং contributeToHistogram ফাংশন ব্যবহার করে সম্পন্ন করা যেতে পারে। যাচাই করুন যে আপনি বাকেট কী এবং মান পাস করছেন। বাকেট কীটি BigInt ফর্ম্যাটে থাকা উচিত। (আরও পড়ুন প্রাইভেট এগ্রিগেশন API )

2. যদি আপনি সুপারিশ অনুসারে রিপোর্টগুলি ট্রিগার করেন, কিন্তু তবুও সমস্যাটি পান, তাহলে "কনসোল" এবং "নেটওয়ার্ক" উভয় ট্যাবে Chrome ডেভেলপার কনসোলে কোনও ত্রুটি পরিলক্ষিত হচ্ছে কিনা তা পরীক্ষা করে দেখুন।

এই ক্লায়েন্ট API গুলির জন্য যদি আপনার আরও সমস্যা সমাধানের সহায়তার প্রয়োজন হয়, তাহলে অ্যাট্রিবিউশন রিপোর্টিং API এবং প্রাইভেট অ্যাগ্রিগেশন API + শেয়ার্ড স্টোরেজ এর জন্য আমাদের ডিবাগিং নির্দেশিকা অনুসরণ করুন।

আপনার রিপোর্টিং অরিজিন সেটআপের সমস্যা সমাধান করা হচ্ছে

রিপোর্টিং অরিজিন সার্ভার হল সেই জায়গা যেখানে আপনি সঠিক .well-known এন্ডপয়েন্ট ঘোষণা করেছেন যেখানে সমষ্টিগত প্রতিবেদন পাঠানো হবে। যাচাই করুন যে আপনার স্থাপন করা রিপোর্টিং অরিজিন সার্ভারটি সঠিকভাবে নথিভুক্ত এবং নিবন্ধিত হয়েছে।

আপনার রিপোর্টিং অরিজিন কি রিপোর্ট পাচ্ছে?

আপনার ডিপ্লয়েড রিপোর্টিং অরিজিন সার্ভারটি সঠিকভাবে নথিভুক্ত এবং নিবন্ধিত হয়েছে কিনা তা যাচাই করুন। এই সার্ভারটি হল সেই জায়গা যেখানে আপনি সঠিক সংশ্লিষ্ট .well-known এন্ডপয়েন্টগুলি ঘোষণা করেছেন যেখানে সমষ্টিগত প্রতিবেদনগুলি পাঠানো হবে।

আপনার অরিজিন সার্ভারটি সঠিকভাবে নিবন্ধিত হয়েছে কিনা তা যাচাই করার পরে, নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:

1. আপনি কীভাবে রিপোর্ট ট্রিগার করছেন তা পরীক্ষা করুন। নিশ্চিত করুন যে আপনি কোন API ব্যবহার করছেন সেই অনুসারে সঠিক রিপোর্ট ফর্ম্যাটটি পাচ্ছেন:

   • অ্যাট্রিবিউশন রিপোর্টিং API সারাংশ রিপোর্ট
   • ব্যক্তিগত সমষ্টি API

2. যদি আপনি সুপারিশকৃত প্রতিবেদনগুলি ট্রিগার করেন কিন্তু তবুও সমস্যাটি পান, তাহলে "কনসোল" এবং "নেটওয়ার্ক" উভয় ট্যাবে Chrome ডেভেলপার কনসোলে কোনও ত্রুটি পরিলক্ষিত হচ্ছে কিনা তা পরীক্ষা করে দেখুন।

এই ক্লায়েন্ট API গুলির জন্য যদি আপনার আরও সমস্যা সমাধানের সহায়তার প্রয়োজন হয়, তাহলে অ্যাট্রিবিউশন রিপোর্টিং API এবং প্রাইভেট অ্যাগ্রিগেশন API + শেয়ার্ড স্টোরেজের জন্য ডিবাগিং নির্দেশিকা চালিয়ে যান।

আপনার সামগ্রিক প্রতিবেদনের সমস্যা সমাধান করা

ক্লায়েন্ট-সাইড পরিমাপ API দ্বারা সমষ্টিগত প্রতিবেদন তৈরি করা হয় এবং আপনার প্রতিবেদনের মূল স্থানে পাঠানো হয়। এই প্রতিবেদনগুলি আপনার প্রতিবেদনের শেষ বিন্দু অনুসারে AVRO ফর্ম্যাটে রূপান্তরিত করা উচিত। যদি এই রূপান্তরে কোনও সমস্যা থাকে, অথবা প্রতিবেদনগুলি নিজেই অক্ষত থাকে, তাহলে আপনি সমষ্টিগত পরিষেবাতে ত্রুটি দেখতে পেতে পারেন।

আপনার সমষ্টিগত প্রতিবেদনগুলি কি সঠিকভাবে রূপান্তরিত হচ্ছে?

আপনার রিপোর্টিং এন্ডপয়েন্ট ( .well-known/… ) প্রদত্ত সমষ্টিগত JSON রিপোর্টটিকে সঠিকভাবে AVRO তে রূপান্তর করছে কিনা তা যাচাই করুন।

এই সমস্যার কারণে যেসব API ত্রুটি দেখা দিতে পারে তা হল:

                "result_info": {
                    "return_code": "REPORTS_WITH_ERRORS_EXCEEDED_THRESHOLD",
                    "return_message": "Aggregation job failed early because the number of reports excluded from aggregation exceeded threshold.",
                    "error_summary": {
                        "error_counts": [
                            {
                                "category": "DECRYPTION_ERROR",
                                "count": 1,
                                "description": "Unable to decrypt the report. This may be caused by: tampered aggregatable report shared info, corrupt encrypted report, or other such issues."
                            },
                            {
                                "category": "NUM_REPORTS_WITH_ERRORS",
                                "count": 1,
                                "description": "Total number of reports that had an error. These reports were not considered in aggregation. See additional error messages for details on specific reasons."
                            }
                        ],
                        "error_messages": []
                    }
                }
            

                "result_info": {
                    "return_code": "REPORTS_WITH_ERRORS_EXCEEDED_THRESHOLD",
                    "return_message": "Aggregation job failed early because the number of reports excluded from aggregation exceeded threshold.",
                    "error_summary": {
                        "error_counts": [{
                            "category": "DECRYPTION_KEY_NOT_FOUND",
                            "count": 1,
                            "description": "Could not find decryption key on private key endpoint."
                        }, {
                            "category": "NUM_REPORTS_WITH_ERRORS",
                            "count": 1,
                            "description": "Total number of reports that had an error. These reports were not considered in aggregation. See additional error messages for details on specific reasons."
                        }],
                        "error_messages": []
                    }
                }
            

                sharedStorage.run('someOperation', {'privateAggregationConfig':
                {'aggregationCoordinatorOrigin': ' https://publickeyservice.msmt.gcp.privacysandboxservices.com'}});

            

                "result_info": {
                        "return_code": "REPORTS_WITH_ERRORS_EXCEEDED_THRESHOLD",
                        "return_message": "Aggregation job failed early because the number of reports excluded from aggregation exceeded threshold.",
                        "error_summary": {
                            "error_counts": [
                                {
                                    "category": "DECRYPTION_KEY_FETCH_ERROR",
                                    "count": 1,
                                    "description": "Fetching the decryption key for report decryption failed. This can happen using an unapproved aggregation service binary, running the aggregation service binary in debug mode, key corruption or service availability issues."
                                },
                                {
                                    "category": "NUM_REPORTS_WITH_ERRORS",
                                    "count": 1,
                                    "description": "Total number of reports that had an error. These reports were not considered in aggregation. See additional error messages for details on specific reasons."
                                }
                            ]
                        }
                }
            

যাচাই করার জন্য নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

1. আপনি aggregatable_report_converter টুল ব্যবহার করে .well-known endpoint থেকে সংগ্রহ করা aggregatable রিপোর্টগুলিকে AVRO তে রূপান্তর করতে পারেন এবং আউটপুট ডোমেইন কী তৈরি করতে পারেন। (দ্রষ্টব্য: আউটপুট ডোমেইন ফাইলগুলি 16-বাইট বিগ-এন্ডিয়ান bytestring হওয়া উচিত।)

2. আপনার পাবলিক ক্লাউড প্রোভাইডার আপনার ডিবাগ রিপোর্ট সংগ্রহ করতে এবং আপনার আউটপুট ডোমেন কী ব্যবহার করে একটি অ্যাগ্রিগেশন সার্ভিস কাজ চালানোর জন্য কোডল্যাবের ধাপগুলি অনুসরণ করুন: a. গুগল ক্লাউড: অ্যাগ্রিগেশন সার্ভিস গুগল ক্লাউড কোডল্যাবের ধাপ 3.1.2 থেকে 3.2.3 অনুসরণ করুন b. অ্যামাজন ওয়েব সার্ভিসেস: অ্যাগ্রিগেশন সার্ভিস AWS কোডল্যাবের ধাপ 4.2 থেকে 5.3 অনুসরণ করুন।

যদি এটি একটি SUCCESS প্রতিক্রিয়া প্রদান করে, তাহলে আপনার রূপান্তর কাজ করছে।

আপনার সমষ্টিগত প্রতিবেদনগুলি কি অক্ষত আছে?

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

এই সমস্যার সাথে সম্পর্কিত API ত্রুটিগুলি আপনি নিম্নলিখিত হিসাবে দেখতে পারেন:

যাচাই করার জন্য নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

1. সামগ্রিক প্রতিবেদন যাচাই করুন:

   • সমষ্টিগত প্রতিবেদন তৈরি করুন এবং আউটপুট ডোমেনকে AVRO ফর্ম্যাটে রূপান্তর করতে aggregatable_report_converter টুল ব্যবহার করুন।
   • এই সমষ্টিগত প্রতিবেদন এবং আউটপুট ডোমেন ফাইল দিয়ে একটি createJob অনুরোধ চালান।
   • যদি এটি SUCCESS রিটার্ন করে, তাহলে এর অর্থ হল অ্যাগ্রিগেটেবল রিপোর্টটি অক্ষত আছে। যদি এটি একটি ত্রুটি রিটার্ন করে, তাহলে হয় আপনার অ্যাগ্রিগেটেবল রিপোর্টে সমস্যা আছে, অথবা রিপোর্ট এবং ডোমেন উভয়ের সাথেই সমস্যা আছে।
   • পরবর্তী ধাপে ডোমেইন ফাইলটি পরীক্ষা করতে এগিয়ে যান।

2. আউটপুট ডোমেইন ফাইল যাচাই করুন:

   • আউটপুট ডোমেইন ফাইল তৈরি করুন এবং aggregatable_report_converter টুল ব্যবহার করে aggregatable রিপোর্ট তৈরি করুন।
   • এই সমষ্টিগত প্রতিবেদন এবং আউটপুট ডোমেন ফাইল দিয়ে একটি createJob অনুরোধ চালান।
   • যদি এটি SUCCESS রিটার্ন করে, তাহলে এর অর্থ হল আউটপুট ডোমেনটি অক্ষত এবং সমষ্টিগত প্রতিবেদন তৈরি করার জন্য আপনার কোডে একটি সমস্যা রয়েছে।
   • shared_info চেক করতে পরবর্তী ধাপে যান।

3. শেয়ার করা তথ্য যাচাই করুন:

   • আপনার ডিবাগ সক্ষম রিপোর্ট আছে কিনা তা যাচাই করুন। ডিবাগ সক্ষম রিপোর্টগুলিতে একটি debug_cleartext_payload ক্ষেত্র উপলব্ধ থাকবে।
   • স্থানীয় পরীক্ষার সরঞ্জামের সাথে ব্যবহারের জন্য একটি ডিবাগ রিপোর্ট তৈরি করুন এবং পেলোড হিসাবে debug_cleartext_payload ব্যবহার করুন।
   • আপনার ডোমেন ফাইলটি দিয়ে স্থানীয় পরীক্ষার সরঞ্জামটি চালান। যদি এটি একটি SUCCESS হয়, তাহলে এর অর্থ হল আপনার shared_info ফাইলটি নষ্ট হয়েছে।

যদি আপনার আরও কোনও ত্রুটি বা টেম্পারিং সন্দেহ হয়, তাহলে JSON সমষ্টিগত প্রতিবেদন, ডোমেন কী, জেনারেটেড সমষ্টিগত AVRO প্রতিবেদন এবং আউটপুট ডোমেন সংগ্রহ করুন এবং পরবর্তী ধাপগুলিতে এগিয়ে যান।

আপনার নতুন স্থাপনার সংস্করণটি পরীক্ষা করুন

আপনার অ্যাগ্রিগেশন সার্ভিসের সংস্করণটি এখনও সমর্থিত কিনা তা যাচাই করুন। আপনি কোন সংস্করণটি ব্যবহার করছেন তা নির্ধারণ করার পরে, অ্যাগ্রিগেশন সার্ভিস রিলিজের তালিকাটি পরীক্ষা করুন এবং নিশ্চিত করুন যে আপনার সংস্করণটিতে সমর্থনের শেষ সতর্কতা নেই: This release has reached its end of support on { date } । আপনি কোন সংস্করণটি স্থাপন করেছেন তা নির্ধারণের জন্য নিম্নলিখিত নির্দেশাবলী সমর্থিত পাবলিক ক্লাউডের জন্য।

গুগল ক্লাউডের জন্য ধাপগুলি

1. আপনার কম্পিউট ইঞ্জিন > ভিএম ইনস্ট্যান্স যেখানে আছে সেখানে নেভিগেট করুন।
2. নামে -worker- লিখে ভার্চুয়াল মেশিনের ইনস্ট্যান্সে ক্লিক করুন।
3. Custom Metadata বিভাগটি খুঁজুন এবং তারপর কী tee-image-reference খুঁজুন।
   • দ্রষ্টব্য: টেরাফর্ম দ্বারা গুগল ক্লাউডে প্রভিশন করা প্রতিটি ভিএম-এ এই মেটাডেটা থাকা উচিত ( কর্মী মডিউলে tee-image-reference মেটাডেটা )।
4. tee-image-reference এর মানটিতে সংস্করণ নম্বর থাকবে। উদাহরণস্বরূপ, নিম্নলিখিত পথের সংস্করণ নম্বর হল v2.9.1 । এগুলি হল পূর্বনির্মিত চিত্র যা একটি Google ক্লাউড প্রকল্পের আর্টিফ্যাক্ট রেজিস্ট্রিতে থাকে।
   • দ্রষ্টব্য: আপনি যদি পূর্বনির্মিত সম্পদ ব্যবহার করেন তবে এটি প্রাসঙ্গিক, যদি না করেন - এটি আপনার ব্যক্তিগত নাম এবং ট্যাগ করা ছবির সাথে মেলে। (উদাহরণ: us.docker.pkg.dev/<gcp_project_name>/artifacts:aggregation-service- container-artifacts-worker_mp_go_prod:2.9.1 )

অ্যামাজন ওয়েব পরিষেবার জন্য পদক্ষেপ

1. আপনার Amazon Web Services কনসোলে EC2 Instances- এ নেভিগেট করুন।
2. aggregation-service-operator-dev-env নামের ইনস্ট্যান্সটিতে ক্লিক করুন।
3. ইনস্ট্যান্স পৃষ্ঠায়, বিস্তারিত > AMI (Amazon Machine Image) খুঁজুন।
4. আপনার সংস্করণের নামটি চিত্রের পাথে অন্তর্ভুক্ত করা উচিত। উদাহরণস্বরূপ, নিম্নলিখিত পাথের সংস্করণ নম্বর হল v2.9.1 ।
   • দ্রষ্টব্য: আপনি যদি পূর্বনির্মিত সম্পদ ব্যবহার করেন তবে এটি প্রাসঙ্গিক, যদি না করেন - এটি আপনার ব্যক্তিগত নাম এবং ট্যাগ করা ছবির সাথে মেলে। (উদাহরণ: aggregation-service-enclave_2.9.1--2024-10-03T01-24-25Z )

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

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