Диагностика вашей среды (новая или обновленная)

При работе со службой агрегации могут возникать проблемы из-за множества факторов, включая форматирование отчетов, проблемы с доменом вывода и проблемы с координатором. Важно понимать источник ошибки и содержащиеся в ней метаданные, чтобы точно диагностировать проблему.

Темы руководства:

• Проверьте настройку API для измерения параметров клиента.
• Устранение неполадок в настройке источника отчетов
• Устранение неполадок в сводных отчетах
• Проверьте версию развертывания.

Проверьте настройку API для измерения параметров клиента.

После того, как вы убедитесь в правильности регистрации вашего исходного сервера, выполните следующие шаги:

1. Проверьте, как вы запускаете отчеты. Убедитесь, что получаете отчеты в правильном формате в зависимости от используемого API:

   • API для составления отчетов об атрибуции
     • Для API отчетов по атрибуции убедитесь, что источник ( событие и сводка ) успешно зарегистрирован. Для регистрации триггера ( событие и сводка ) проверьте корректность JSON-данных, передаваемых в Attribution-Reporting-Register-Trigger используя инструмент проверки заголовков . (Подробнее о сводных отчетах API отчетов по атрибуции )
   • API частной агрегации
     • Создание отчетов в рамках API частной агрегации можно выполнить с помощью функции contributeToHistogram . Убедитесь, что вы передаете ключ и значение сегмента. Ключ сегмента должен быть в формате BigInt . (Подробнее об API частной агрегации )

2. Если вы запускаете отчеты, как рекомендовано, но проблема все еще сохраняется, проверьте, нет ли ошибок в консоли разработчика Chrome на вкладках «Консоль» и «Сеть».

Если вам потребуется дополнительная помощь в устранении неполадок с этими клиентскими API, перейдите к нашим рекомендациям по отладке для API Attribution Reporting и Private Aggregation API + Shared Storage .

Устранение неполадок в настройке источника отчетов

Сервер-источник отчетов — это место, где вы указали соответствующие конечные точки .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, в формат AVRO и создания ключей выходного домена . (Примечание: файлы выходного домена должны представлять собой байтовую строку размером 16 байт в порядке байтов big-endian .)

2. Выполните действия, описанные в практическом руководстве для вашего поставщика общедоступного облачного сервиса, чтобы собрать отладочные отчеты и запустить задание службы агрегации, используя ключи вашего выходного домена: a. Google Cloud: выполните шаги 3.1.2–3.2.3 из практического руководства по службе агрегации Google Cloud. b. Amazon Web Services: выполните шаги 4.2–5.3 из практического руководства по службе агрегации AWS .

Если в ответе будет указано 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 и выходной домен, после чего переходите к следующим шагам .

Проверьте новую версию развертывания.

Убедитесь, что ваша версия Aggregation Service по-прежнему поддерживается. После того, как вы определите, какую версию используете, проверьте список релизов Aggregation Service и убедитесь, что ваша версия не имеет предупреждения о прекращении поддержки: This release has reached its end of support on { date } . Следующие инструкции по определению развернутой вами версии относятся к поддерживаемым публичным облакам.

Шаги для Google Cloud

1. Перейдите в раздел Compute Engine > Экземпляры виртуальных машин .
2. Щелкните по экземпляру виртуальной машины, в имени которого присутствует -worker- .
3. Найдите раздел Custom Metadata , а затем найдите ключ tee-image-reference .
   • Примечание: Каждая виртуальная машина, созданная в Google Cloud с помощью Terraform, должна содержать эти метаданные ( метаданные tee-image-reference в модуле worker ).
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 )

Этапы работы с Amazon Web Services

1. Перейдите в раздел «Экземпляры EC2» в консоли Amazon Web Services.
2. Щелкните по экземпляру с именем aggregation-service-operator-dev-env .
3. На странице экземпляра найдите раздел «Подробности» > «AMI (образ машины Amazon)».
4. Название вашей версии должно быть указано в пути к образу. Например, номер версии для следующего пути — v2.9.1 .
   • Примечание: Это актуально, если вы используете предварительно созданные ресурсы. Если нет, то это должно соответствовать тому, как вы лично назвали и пометили свой образ. (Пример: aggregation-service-enclave_2.9.1--2024-10-03T01-24-25Z )

Следующие шаги

Если вы не нашли решения проблемы с вашей службой агрегации, сообщите нам об этом, создав заявку на GitHub или заполнив форму технической поддержки .