Diagnostica l'ambiente (nuovo o di cui è stato eseguito l'upgrade)

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Diversi fattori possono creare problemi durante l'utilizzo del servizio di aggregazione, tra cui la formattazione dei report, i problemi relativi al dominio di output e i problemi relativi al coordinatore. È importante comprendere l'origine dell'errore e gli eventuali metadati in esso contenuti per diagnosticare con precisione il problema.

Argomenti della guida:

• Verificare la configurazione dell'API di misurazione del cliente
• Risoluzione dei problemi relativi alla configurazione dell'origine report
• Risolvere i problemi relativi ai report aggregati
• Controllare la versione del deployment

Verificare la configurazione dell'API di misurazione del cliente

Dopo aver verificato che il server di origine sia stato registrato correttamente, completa i seguenti passaggi:

1. Controlla come attivi i report. Verifica di ricevere il formato del report corretto in base all'API utilizzata:

   • API Attribution Reporting
     • Per l'API Attribution Reporting, assicurati di aver registrato correttamente l'origine (Event e Summary). Per eseguire la registrazione dell'attivatore (Evento e Riepilogo), assicurati che il JSON passato a Attribution-Reporting-Register-Trigger sia corretto utilizzando lo strumento di convalida dell'intestazione. (scopri di più sui report di riepilogo dell'API Attribution Reporting)
   • API Private Aggregation
     • I report nell'API Private Aggregation possono essere completati utilizzando la funzione contributeToHistogram. Assicurati di passare la chiave e il valore del bucket. La chiave del bucket deve essere in formato BigInt. (scopri di più sull'API Private Aggregation)

2. Se attivi i report come consigliato, ma il problema persiste, controlla se sono stati rilevati errori nella Console per gli sviluppatori di Chrome sia nella scheda "Console" sia in quella "Rete".

Se hai bisogno di ulteriore assistenza per la risoluzione dei problemi relativi a queste API client, consulta le nostre linee guida per il debug dell'API Attribution Reporting e dell'API Private Aggregation + Shared Storage.

Risolvere i problemi relativi alla configurazione dell'origine report

Il server di origine dei report è il luogo in cui hai dichiarato gli endpoint .well-knowncorrispondenti corretti a cui verranno inviati i report aggregabili. Verifica che il server di origine dei report di cui è stato eseguito il deployment sia stato registrato e attivato correttamente.

L'origine report riceve i report?

Verifica che il server di origine dei report di cui è stato eseguito il deployment sia stato registrato e attivato correttamente. In questo server hai dichiarato gli endpoint .well-known corrispondenti corretti a cui verranno inviati i report aggregabili.

Dopo aver verificato che il server di origine sia stato registrato correttamente, completa i seguenti passaggi:

1. Controlla come attivi i report. Verifica di ricevere il formato del report corretto in base all'API utilizzata:

   • Report di riepilogo dell'API Attribution Reporting
   • API Private Aggregation

2. Se attivi i report come consigliato, ma il problema persiste, controlla se sono stati rilevati errori nella Console per gli sviluppatori di Chrome sia nella scheda "Console" sia in quella "Rete".

Se hai bisogno di ulteriore assistenza per la risoluzione dei problemi relativi a queste API client , consulta le linee guida per il debug dell'API Attribution Reporting e dell'API Private Aggregation + Shared Storage.

Risolvere i problemi relativi ai report aggregati

I report aggregati vengono generati dalle API di misurazione lato client e inviati alla tua origine report. Questi report devono essere convertiti in formato AVRO dall'endpoint per i report. Se si verificano problemi con questa conversione o se i report stessi non sono integri, potresti visualizzare errori nel servizio di aggregazione.

I report aggregabili vengono convertiti correttamente?

Verifica che l'endpoint dei report (.well-known/…) converta correttamente il report JSON aggregabile in AVRO.

Gli errori dell'API che potrebbero verificarsi a causa di questo problema sono i seguenti:

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

Per verificare:

1. Puoi utilizzare lo strumento aggregatable_report_converter per convertire i report aggregabili raccolti dall'endpoint .well-known in AVRO e creare le chiavi del dominio di output. Nota: i file di dominio di output devono essere una stringa di byte big endian di 16 byte.

2. Segui i passaggi del codelab per il tuo provider cloud pubblico per raccogliere i report di debug ed eseguire un job del servizio di aggregazione utilizzando le chiavi del dominio di output: a. Google Cloud: segui i passaggi da 3.1.2 a 3.2.3 del Codelab Google Cloud per il servizio di aggregazione. Amazon Web Services: segui i passaggi da 4.2 a 5.3 del Codelab AWS per il servizio di aggregazione.

Se viene restituita una risposta SUCCESS, la conversione funziona.

I report aggregabili sono intatti?

Verifica che il report aggregato, le chiavi di dominio di output e le informazioni condivise siano intatte. Per ulteriori informazioni, consulta i codici di esempio per convertire i report aggregabili e creare file di dominio.

Di seguito sono riportati gli errori dell'API che potresti visualizzare e che corrispondono a questo problema:

Per verificare:

1. Verifica il report aggregato:

   • Genera report aggregati e utilizza lo strumento aggregatable_report_converter per convertire il dominio di output in formato AVRO.
   • Esegui una richiesta createJob con questo report aggregabile e il file di dominio di output.
   • Se viene restituito SUCCESS, significa che il report aggregabile è intatto. Se viene restituito un errore, significa che hai un problema con il report aggregabile o con il report e il dominio.
   • Procedi controllando il file del dominio nel passaggio successivo.

2. Verifica il file del dominio di output:

   • Genera il file del dominio di output e utilizza lo strumento aggregatable_report_converter per creare il report aggregabile.
   • Esegui una richiesta createJob con questo report aggregabile e il file del dominio di output.
   • Se viene restituito SUCCESS, significa che il dominio di output è intatto e che c'è un problema con il codice per creare il report aggregabile.
   • Vai al passaggio successivo per controllare shared_info.

3. Verifica le informazioni condivise:

   • Assicurati di aver attivato i report di debug. I report con il debug abilitato avranno un debug_cleartext_payload campo disponibile.
   • Crea un report di debug da utilizzare con lo strumento di test locale e utilizzadebug_cleartext_payload come payload.
   • Esegui lo strumento di test locale con il file del tuo dominio. Se si tratta di un messaggio SUCCESS, significa che il file shared_info è stato manomesso.

Se sospetti ulteriori errori o manomissioni, raccogli il report aggregato JSON, la chiave del dominio, il report AVRO aggregato generato e il dominio di output, quindi vai ai passaggi successivi.

Controlla la nuova versione di deployment

Verifica che la tua versione di Aggregation Service sia ancora supportata. Una volta individuata la versione in uso, controlla l'elenco delle release del servizio di aggregazione e verifica che la tua versione non presenti l'avviso relativo al ritiro del supporto: This release has reached its end of support on { date }. Le seguenti istruzioni per determinare la versione di cui è stato eseguito il deployment sono valide per i cloud pubblici supportati.

Procedura per Google Cloud

1. Vai a Compute Engine > Istanze VM.
2. Fai clic sull'istanza della macchina virtuale con -worker- nel nome.
3. Individua la sezione Custom Metadata e poi la chiave tee-image-reference.
   • Nota: ogni VM di cui è stato eseguito il provisioning in Google Cloud da Terraform deve avere questi metadati (metadati tee-image-reference nel modulo worker).
4. Il valore di tee-image-reference conterrà il numero di versione. Ad esempio, il numero di versione del seguente percorso è v2.9.1. Si tratta di immagini predefinite che si trovano in Artifact Registry di un progetto Google Cloud.
   • Nota: questo valore è pertinente se utilizzi gli asset predefiniti. In caso contrario, deve corrispondere al nome e ai tag che hai assegnato personalmente all'immagine. (ad es. us.docker.pkg.dev/<gcp_project_name>/artifacts:aggregation-service- container-artifacts-worker_mp_go_prod:2.9.1)

Passaggi per Amazon Web Services

1. Vai a Istanze EC2 nella console Amazon Web Services.
2. Fai clic sull'istanza con il nome aggregation-service-operator-dev-env.
3. Nella pagina dell'istanza, vai a Dettagli > AMI (Amazon Machine Image)
4. Il nome della versione deve essere incluso nel percorso dell'immagine. Ad esempio, il numero di versione del seguente percorso è v2.9.1.
   • Nota: questo valore è pertinente se utilizzi gli asset predefiniti. In caso contrario, deve corrispondere al nome e ai tag che hai assegnato personalmente all'immagine. (ad es. aggregation-service-enclave_2.9.1--2024-10-03T01-24-25Z)

Passaggi successivi

Se non riesci a risolvere il problema relativo al servizio di aggregazione, comunicacelo inviando un problema GitHub o compilando il modulo di assistenza tecnica.