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

bookmark_border সেভ করা পৃষ্ঠা গুছিয়ে রাখতে 'সংগ্রহ' ব্যবহার করুন আপনার পছন্দ অনুযায়ী কন্টেন্ট সেভ করুন ও সঠিক বিভাগে রাখুন।

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

গাইড বিষয়:

• ক্লায়েন্ট পরিমাপ API সেটআপ যাচাই করুন
• আপনার রিপোর্টিং মূল সেটআপের সমস্যা সমাধান করা হচ্ছে
• আপনার সমষ্টিগত প্রতিবেদনের সমস্যা সমাধান করা
• আপনার স্থাপনার সংস্করণ পরিদর্শন করুন

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

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

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

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

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

2. আপনার ডিবাগ রিপোর্ট সংগ্রহ করতে এবং আপনার আউটপুট ডোমেন কী ব্যবহার করে একটি অ্যাগ্রিগেশন সার্ভিস কাজ চালানোর জন্য আপনার পাবলিক ক্লাউড প্রদানকারীর কোডল্যাবের ধাপগুলি অনুসরণ করুন: ক. গুগল ক্লাউড: অ্যাগ্রিগেশন সার্ভিস গুগল ক্লাউড কোডল্যাবের 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 টুল ব্যবহার করুন।
   • এই সমষ্টিগত প্রতিবেদন এবং আউটপুট ডোমেন ফাইলের সাথে একটি 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 } । আপনি কোন সংস্করণটি স্থাপন করেছেন তা নির্ধারণের জন্য নিম্নলিখিত নির্দেশাবলী সমর্থিত পাবলিক ক্লাউডের জন্য।

Google ক্লাউডের জন্য পদক্ষেপ

1. যেখানে আপনার কম্পিউট ইঞ্জিন > VM দৃষ্টান্ত রয়েছে সেখানে নেভিগেট করুন।
2. ভার্চুয়াল মেশিন ইনস্ট্যান্সে -worker- নামে ক্লিক করুন।
3. Custom Metadata বিভাগটি খুঁজুন এবং তারপর কী tee-image-reference সনাক্ত করুন।
   • দ্রষ্টব্য: টেরাফর্মের দ্বারা Google ক্লাউডে প্রবিধান করা প্রতিটি VM-তে এই মেটাডেটা থাকা উচিত ( কর্মী মডিউলে 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 ইনস্ট্যান্সে নেভিগেট করুন।
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 সমস্যা ফাইল করে বা প্রযুক্তিগত সহায়তা ফর্ম জমা দিয়ে আমাদের জানান।