Diagnostica tu entorno (nuevo o actualizado)

Varios factores pueden generar problemas cuando se trabaja con el Servicio de agregación, incluidos los problemas de formato de los informes, los problemas de dominio de salida y los problemas del coordinador. Es importante comprender la fuente del error y los metadatos que contiene para diagnosticar el problema con precisión.

Temas de la guía:

• Verifica la configuración de la API de medición del cliente
• Cómo solucionar problemas con la configuración del origen de informes
• Cómo solucionar problemas relacionados con tus informes agregados
• Inspecciona la versión de tu implementación

Verifica la configuración de la API de medición del cliente

Después de verificar que tu servidor de origen se registró correctamente, completa los siguientes pasos:

1. Verifica cómo activas los informes. Confirma que recibes el formato de informe correcto según la API que se usa:

   • API de Attribution Reporting
     • En el caso de la API de Attribution Reporting, verifica que hayas registrado correctamente la fuente (Evento y Resumen). Para realizar el registro del activador (Evento y Resumen), verifica que el JSON que se pasó a Attribution-Reporting-Register-Trigger sea correcto con la herramienta de validación de encabezados. (Más información sobre los informes de resumen de la API de Attribution Reporting)
   • API de Private Aggregation
     • Los informes en la API de Private Aggregation se pueden completar con la función contributeToHistogram. Verifica que estés pasando la clave y el valor del bucket. La clave del bucket debe tener el formato BigInt. (Obtén más información sobre la API de Private Aggregation).

2. Si activas los informes según lo recomendado, pero el problema persiste, verifica si se observan errores en la consola para desarrolladores de Chrome en las pestañas "Console" y "Network".

Si necesitas más ayuda para solucionar problemas con estas APIs de cliente, consulta nuestra guía de depuración para la API de Attribution Reporting y la API de Private Aggregation + Shared Storage.

Soluciona problemas de la configuración del origen de informes

El servidor de origen de informes es donde declaraste los extremos .well-known correspondientes correctos a los que se enviarán los informes agregables. Verifica que tu servidor de origen de informes implementado se haya inscrito y registrado correctamente.

¿Tu origen de informes recibe informes?

Verifica que tu servidor de origen de informes implementado se haya inscrito y registrado correctamente. Este servidor es donde declaraste los extremos .well-known correspondientes correctos a los que se enviarán los informes agregables.

Después de verificar que tu servidor de origen se registró correctamente, completa los siguientes pasos:

1. Verifica cómo activas los informes. Confirma que recibes el formato de informe correcto según la API que se usa:

   • Informes de resumen de la API de Attribution Reporting
   • API de Private Aggregation

2. Si activas los informes según lo recomendado, pero el problema persiste, verifica si se observan errores en la consola para desarrolladores de Chrome en las pestañas "Console" y "Network".

Si necesitas más ayuda para solucionar problemas con estas APIs de cliente , continúa con la guía de depuración para la API de Attribution Reporting y la API de Private Aggregation + Shared Storage.

Cómo solucionar problemas relacionados con tus informes agregados

Las APIs de medición del cliente generan informes agregados y los envían a tu origen de informes. Tu extremo de informes debe convertir estos informes al formato AVRO. Si hay problemas con esta conversión o si los informes no están intactos, es posible que veas errores en el Servicio de agregación.

¿Tus informes agregables registran conversiones correctamente?

Verifica que tu extremo de informes (.well-known/…) convierta correctamente el informe JSON agregable proporcionado en AVRO.

Los errores de API que surgirían debido a este problema son los siguientes:

                "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."
                                }
                            ]
                        }
                }
            

Para verificarlo, completa los siguientes pasos:

1. Puedes usar la herramienta aggregatable_report_converter para convertir los informes agregables que recopilaste del extremo .well-known a AVRO y crear las claves de dominio de salida. (Nota: Los archivos de dominio de salida deben ser una cadena de bytes big-endian de 16 bytes).

2. Sigue los pasos del codelab para tu proveedor de nube pública y recopila tus informes de depuración, y ejecuta un trabajo del Servicio de agregación con tus claves de dominio de salida: a. Google Cloud: Sigue los pasos del 3.1.2 al 3.2.3 del Codelab de Google Cloud del servicio de agregación. b. Amazon Web Services: Sigue los pasos del 4.2 al 5.3 del Codelab de AWS del servicio de agregación.

Si se muestra una respuesta SUCCESS, tu conversión funciona correctamente.

¿Tus informes agregables están intactos?

Verifica que tu informe agregado, las claves de dominio de salida y la información compartida estén intactos. Consulta los códigos de ejemplo para convertir informes agregables y crear archivos de dominio si deseas obtener más información.

Los errores de API que puedes ver y que corresponden a este problema son los siguientes:

Para verificarlo, completa los siguientes pasos:

1. Verifica el informe agregado:

   • Genera informes agregados y usa la herramienta aggregatable_report_converter para convertir el dominio de salida al formato AVRO.
   • Ejecuta una solicitud createJob con este informe agregable y el archivo de dominio de salida.
   • Si se devuelve SUCCESS, significa que el informe agregable está intacto. Si se muestra un error, significa que tienes un problema con tu informe agregable o con el informe y el dominio.
   • En el siguiente paso, verifica el archivo del dominio.

2. Verifica el archivo de dominio de salida:

   • Genera el archivo de dominio de salida y usa la herramienta aggregatable_report_converter para crear el informe agregable.
   • Ejecuta una solicitud createJob con este informe agregable y el archivo de dominio de salida.
   • Si devuelve SUCCESS, significa que el dominio de salida está intacto y que hay un problema con tu código para crear el informe agregable.
   • Continúa con el siguiente paso para verificar el shared_info.

3. Verifica la información compartida:

   • Verifica que tengas habilitados los informes de depuración. Los informes con la depuración habilitada tendrán disponible el campo debug_cleartext_payload.
   • Crea un informe de depuración para usarlo con la herramienta de pruebas locales y usa debug_cleartext_payload como carga útil.
   • Ejecuta la herramienta de pruebas locales con tu archivo de dominio. Si es un SUCCESS, significa que se manipuló tu archivo shared_info.

Si sospechas que hay más errores o manipulaciones, recopila el informe agregado en formato JSON, la clave del dominio, el informe agregado AVRO generado y el dominio de salida, y continúa con los próximos pasos.

Inspecciona la nueva versión de la implementación

Verifica que tu versión del Servicio de agregación siga siendo compatible. Una vez que hayas determinado qué versión usas, consulta la lista de versiones del Servicio de agregación y confirma que tu versión no tenga la advertencia de fin de asistencia:This release has reached its end of support on { date }. Las siguientes instrucciones para determinar qué versión implementaste son para las nubes públicas compatibles.

Pasos para Google Cloud

1. Navega a Compute Engine > Instancias de VM.
2. Haz clic en la instancia de máquina virtual con -worker- en el nombre.
3. Busca la sección Custom Metadata y, luego, la clave tee-image-reference.
   • Nota: Cada VM aprovisionada en Google Cloud por Terraform debe tener estos metadatos (metadatos de tee-image-reference en el módulo de trabajador).
4. El valor de tee-image-reference contendrá el número de versión. Por ejemplo, el número de versión de la siguiente ruta de acceso es v2.9.1. Son imágenes prediseñadas que se encuentran en el registro de Artifact Registry de un proyecto de Google Cloud.
   • Nota: Esto es relevante si usas los recursos compilados previamente. De lo contrario, debe coincidir con el nombre y las etiquetas que le asignaste personalmente a tu imagen. (ejemplo: us.docker.pkg.dev/<gcp_project_name>/artifacts:aggregation-service- container-artifacts-worker_mp_go_prod:2.9.1)

Pasos para Amazon Web Services

1. Navega a Instancias de EC2 en la consola de Amazon Web Services.
2. Haz clic en la instancia con el nombre aggregation-service-operator-dev-env.
3. En la página de la instancia, busca Detalles > AMI (Amazon Machine Image).
4. El nombre de la versión debe incluirse en la ruta de acceso a la imagen. Por ejemplo, el número de versión de la siguiente ruta es v2.9.1.
   • Nota: Esto es relevante si usas los recursos compilados previamente. De lo contrario, debe coincidir con el nombre y las etiquetas que le asignaste personalmente a tu imagen. (ejemplo: aggregation-service-enclave_2.9.1--2024-10-03T01-24-25Z)

Próximos pasos

Si no ves una solución para tu problema con el Servicio de agregación, infórmanos al respecto. Para ello, presenta un problema en GitHub o envía el formulario de asistencia técnica.