محیط خود را تشخیص دهید (جدید یا ارتقا یافته)

bookmark_border با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

عوامل متعددی می‌توانند در حین کار با Aggregation Service مشکلاتی را ایجاد کنند، از جمله قالب‌بندی گزارش‌ها، مشکلات دامنه خروجی و مشکلات هماهنگ‌کننده. برای تشخیص دقیق مشکل، درک منبع خطا و هر ابرداده ای که در آن وجود دارد، مهم است.

موضوعات راهنما:

• تنظیم API اندازه گیری مشتری را تأیید کنید
• عیب یابی تنظیم مبدا گزارش شما
• عیب یابی گزارش های انبوه شما
• نسخه استقرار خود را بررسی کنید

تنظیم API اندازه گیری مشتری را تأیید کنید

پس از اینکه تأیید کردید سرور اصلی شما به درستی ثبت شده است، مراحل زیر را انجام دهید:

1. بررسی کنید که چگونه گزارش‌ها را راه‌اندازی می‌کنید. تأیید کنید که فرمت گزارش صحیحی را دریافت می کنید که بر اساس آن API استفاده می شود:

   • Attribution Reporting API
     • برای Attribution Reporting API، مطمئن شوید که منبع را با موفقیت ثبت کرده اید ( رویداد و خلاصه ). برای انجام ثبت Trigger ( رویداد و خلاصه )، مطمئن شوید که JSON ارسال شده به Attribution-Reporting-Register-Trigger با استفاده از ابزار اعتبارسنجی هدر صحیح است. ( گزارش‌های خلاصه API گزارش Attribution Reporting را بیشتر بخوانید)
   • Private Aggregation API
     • گزارش دهی در Private Aggregation API را می توان با استفاده از تابع contributeToHistogram تکمیل کرد. مطمئن شوید که کلید سطل و مقدار را ارسال می کنید. کلید سطل باید در قالب BigInt باشد. (بیشتر بخوانید Private Aggregation API )

2. اگر گزارش‌ها را همانطور که توصیه می‌شود راه‌اندازی می‌کنید، اما همچنان مشکل را مشاهده می‌کنید، بررسی کنید که آیا خطاهایی در کنسول برنامه‌نویس Chrome در تب «کنسول» و «شبکه» مشاهده شده است یا خیر.

اگر به پشتیبانی عیب‌یابی بیشتری برای این APIهای سرویس گیرنده نیاز دارید، به راهنمای رفع اشکال ما برای API Reporting Attribute و API Aggregation خصوصی + ذخیره‌سازی مشترک ادامه دهید.

عیب یابی تنظیم مبدا گزارش شما

سرور مبدأ گزارش جایی است که شما نقاط پایانی .well-known متناظر صحیح را اعلام کرده‌اید که گزارش‌های جمع‌آوری‌شده به آنجا ارسال می‌شوند. بررسی کنید که سرور مبدا گزارش مستقر شما به درستی ثبت و ثبت شده است.

آیا منبع گزارش شما گزارش هایی دریافت می کند؟

بررسی کنید که سرور مبدا گزارش مستقر شما به درستی ثبت و ثبت شده است. این سرور جایی است که شما نقاط پایانی .well-known مربوطه را به درستی اعلام کرده‌اید که گزارش‌های جمع‌آوری‌شده به آن‌ها ارسال می‌شود.

پس از اینکه تأیید کردید سرور اصلی شما به درستی ثبت شده است، مراحل زیر را انجام دهید:

1. بررسی کنید که چگونه گزارش‌ها را راه‌اندازی می‌کنید. تأیید کنید که فرمت گزارش صحیحی را دریافت می کنید که بر اساس آن API استفاده می شود:

   • گزارش‌های خلاصه API Reporting Attribution
   • Private Aggregation API

2. اگر گزارش‌ها را همانطور که توصیه می‌شود راه‌اندازی می‌کنید اما همچنان مشکل را مشاهده می‌کنید، بررسی کنید که آیا خطاهایی در کنسول برنامه‌نویس Chrome در تب «کنسول» و «شبکه» مشاهده شده است یا خیر.

اگر به پشتیبانی عیب‌یابی بیشتری برای این APIهای سرویس گیرنده نیاز دارید، دستورالعمل‌های اشکال‌زدایی را برای API گزارش Attribute و API Aggregation خصوصی + ذخیره‌سازی مشترک ادامه دهید.

عیب یابی گزارش های انبوه شما

گزارش‌های انبوه توسط 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 به AVRO و ایجاد کلیدهای دامنه خروجی استفاده کنید. (توجه: فایل‌های دامنه خروجی باید یک بایت تست 16 بایتی باشند.)

2. برای جمع‌آوری گزارش‌های اشکال‌زدایی و اجرای یک کار سرویس جمع‌آوری با استفاده از کلیدهای دامنه خروجی، مراحل موجود در نرم‌افزار کد را برای ارائه‌دهنده ابر عمومی خود دنبال کنید: الف. Google Cloud: مراحل 3.1.2 تا 3.2.3 سرویس Aggregation Google Cloud Codelab b را دنبال کنید. خدمات وب آمازون: مراحل 4.2 تا 5.3 سرویس تجمیع AWS Codelab را دنبال کنید.

اگر این یک پاسخ SUCCESS را برگرداند، تبدیل شما کار می کند.

آیا گزارش های انبوه شما دست نخورده است؟

بررسی کنید که گزارش انبوه، کلیدهای دامنه خروجی و اطلاعات مشترک دست نخورده باشند. در صورت تمایل به اطلاعات بیشتر، برای تبدیل گزارش های جمع آوری و ایجاد فایل های دامنه به کدهای نمونه مراجعه کنید.

خطاهای API که ممکن است مشاهده کنید که با این مشکل مطابقت دارند به شرح زیر است:

برای تایید مراحل زیر را کامل کنید:

1. تایید گزارش کل:

   • گزارش های انبوه تولید کنید و از ابزار aggregatable_report_converter برای تبدیل دامنه خروجی به فرمت AVRO استفاده کنید.
   • یک درخواست 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 Cloud

1. به جایی بروید که Compute Engine > نمونه‌های VM .
2. روی نمونه ماشین مجازی با -worker- در نام کلیک کنید.
3. بخش Custom Metadata پیدا کنید و سپس کلید tee-image-reference پیدا کنید.
   • توجه: هر VM ارائه شده در Google Cloud توسط Terraform باید این ابرداده را داشته باشد ( متاداده tee-image-reference در ماژول کارگر ).
4. مقدار tee-image-reference حاوی شماره نسخه خواهد بود. به عنوان مثال، شماره نسخه مسیر زیر v2.9.1 است. اینها تصاویر از پیش ساخته شده ای هستند که در رجیستری مصنوع پروژه Google Cloud زندگی می کنند.
   • توجه: اگر از دارایی‌های از پیش ساخته شده استفاده می‌کنید، این موضوع مرتبط است، اگر از آن استفاده نمی‌کنید - این باید با آنچه شما شخصاً نامگذاری کرده‌اید و تصویر خود را برچسب‌گذاری کرده‌اید مطابقت داشته باشد. (مثال: us.docker.pkg.dev/<gcp_project_name>/artifacts:aggregation-service- container-artifacts-worker_mp_go_prod:2.9.1 )

مراحل خدمات وب آمازون

1. در کنسول خدمات وب آمازون خود به EC2 Instances بروید.
2. روی نمونه با نام aggregation-service-operator-dev-env کلیک کنید.
3. در صفحه نمونه، جزئیات > AMI (تصویر ماشین آمازون) را پیدا کنید
4. نام نسخه شما باید در مسیر تصویر درج شود. به عنوان مثال، شماره نسخه مسیر زیر v2.9.1 است.
   • توجه: اگر از دارایی‌های از پیش ساخته شده استفاده می‌کنید، این موضوع مرتبط است، اگر از آن استفاده نمی‌کنید - این باید با آنچه شما شخصاً نامگذاری کرده‌اید و تصویر خود را برچسب‌گذاری کرده‌اید مطابقت داشته باشد. (مثال: aggregation-service-enclave_2.9.1--2024-10-03T01-24-25Z )

مراحل بعدی

اگر راه‌حلی برای مشکل سرویس تجمیع خود نمی‌بینید، با ثبت مشکل GitHub یا ارسال فرم پشتیبانی فنی به ما اطلاع دهید.