Ortamınızı teşhis etme (yeni veya yükseltilmiş)

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Rapor biçimlendirme, çıkış alanı sorunları ve koordinatör sorunları dahil olmak üzere birden fazla faktör, toplama hizmetiyle çalışırken sorun oluşturabilir. Sorunu doğru şekilde teşhis etmek için hata kaynağını ve içerdiği meta verileri anlamak önemlidir.

Rehber konuları:

• İstemci Measurement Protocol API kurulumunu doğrulama
• Raporlama kaynağı ayarlarınızla ilgili sorunları giderme
• Toplu raporlarınızla ilgili sorunları giderme
• Dağıtım sürümünüzü inceleme

İstemci ölçüm API'si kurulumunu doğrulama

Kaynak sunucunuzun doğru şekilde kaydedildiğini doğruladıktan sonra aşağıdaki adımları tamamlayın:

1. Raporları nasıl tetiklediğinizi kontrol edin. Kullanılan API'ye göre doğru rapor biçimini aldığınızı onaylayın:

   • Attribution Reporting API
     • Attribution Reporting API için kaynağı (Etkinlik ve Özet) başarıyla kaydettiğinizden emin olun. Tetikleyici kaydı (Etkinlik ve Özet) gerçekleştirmek için Attribution-Reporting-Register-Trigger alanına iletilen JSON'un doğru olduğundan emin olmak üzere başlık doğrulama aracını kullanın. (Attribution Reporting API Özet Raporları hakkında daha fazla bilgi edinin.)
   • Private Aggregation API
     • Private Aggregation API'de raporlama, contributeToHistogram işlevi kullanılarak tamamlanabilir. Paket anahtarını ve değerini ilettiğinizden emin olun. Paket anahtarı BigInt biçiminde olmalıdır. (Private Aggregation API hakkında daha fazla bilgi edinin.)

2. Önerildiği şekilde raporları tetikliyorsanız ancak sorun yaşamaya devam ediyorsanız Chrome Geliştirici Konsolu'ndaki hem "Konsol" hem de "Ağ" sekmesinde hata olup olmadığını kontrol edin.

Bu istemci API'leri için daha fazla sorun giderme desteğine ihtiyacınız varsa Attribution Reporting API ve Private Aggregation API + Shared Storage için hata ayıklama kılavuzumuza göz atın.

Raporlama kaynağı ayarlarınızla ilgili sorunları giderme

Raporlama kaynak sunucusu, birleştirilebilir raporların gönderileceği doğru .well-known uç noktalarını belirttiğiniz yerdir. Dağıtılan raporlama kaynak sunucunuzun doğru şekilde kaydedildiğini ve tescil edildiğini doğrulayın.

Raporlama kaynağınız rapor alıyor mu?

Dağıtılan raporlama kaynak sunucunuzun düzgün bir şekilde kaydedildiğini ve tescil edildiğini doğrulayın. Bu sunucu, birleştirilebilir raporların gönderileceği doğru .well-known uç noktalarını belirttiğiniz yerdir.

Kaynak sunucunuzun doğru şekilde kaydedildiğini doğruladıktan sonra aşağıdaki adımları tamamlayın:

1. Raporları nasıl tetiklediğinizi kontrol edin. Kullanılan API'ye göre doğru rapor biçimini aldığınızı onaylayın:

   • Attribution Reporting API Özet Raporları
   • Private Aggregation API

2. Önerildiği şekilde raporları tetikliyorsanız ancak sorun devam ediyorsa Chrome Geliştirici Konsolu'ndaki hem "Konsol" hem de "Ağ" sekmesinde hata olup olmadığını kontrol edin.

Bu istemci API'leri için daha fazla sorun giderme desteğine ihtiyacınız varsa Attribution Reporting API ve Private Aggregation API + Shared Storage için hata ayıklama kılavuzlarına göz atın.

Toplu raporlarınızla ilgili sorunları giderme

Toplu raporlar, istemci tarafı ölçüm API'leri tarafından oluşturulur ve raporlama kaynağınıza gönderilir. Bu raporlar, raporlama uç noktanız tarafından AVRO biçimine dönüştürülmelidir. Bu dönüşümle ilgili sorunlar varsa veya raporların kendisi bozuksa Toplama Hizmeti'nde hatalar görebilirsiniz.

Toplanabilir raporlarınız doğru şekilde dönüştürülüyor mu?

Raporlama uç noktanızın (.well-known/…), verilen birleştirilebilir JSON raporunu doğru şekilde AVRO olarak dönüştürdüğünü doğrulayın.

Bu sorun nedeniyle ortaya çıkabilecek API hataları şunlardır:

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

Aşağıdaki adımları uygulayarak doğrulama yapın:

1. .well-known uç noktasından topladığınız birleştirilebilir raporları AVRO'ya dönüştürmek ve çıktı alan adı anahtarlarını oluşturmak için aggregatable_report_converter aracını kullanabilirsiniz. (Not: Çıkış alan dosyaları 16 baytlık büyük endian bayt dizesi olmalıdır.)

2. Herkese açık bulut sağlayıcınızın hata ayıklama raporlarınızı toplayabilmesi ve çıkış alan adı anahtarlarınızı kullanarak bir Toplama Hizmeti işi çalıştırabilmesi için codelab'deki adımları uygulayın: a. Google Cloud: Toplama Hizmeti Google Cloud Codelab'in 3.1.2 ile 3.2.3 arasındaki adımlarını uygulayın. b. Amazon Web Services: Aggregation Service AWS Codelab'in 4.2 ile 5.3 arasındaki adımlarını uygulayın.

Bu işlem SUCCESS yanıtı döndürüyorsa dönüşümünüz çalışıyor demektir.

Toplanabilir raporlarınız bozulmadı mı?

Toplu raporunuzun, çıkış alan anahtarlarınızın ve paylaşılan bilgilerinizin bozulmadığını doğrulayın. Daha fazla bilgi edinmek için birleştirilebilir raporları dönüştürmek ve alan dosyaları oluşturmak üzere örnek kodlara bakın.

Bu sorunla ilgili olarak karşılaşabileceğiniz API hataları şunlardır:

Aşağıdaki adımları uygulayarak doğrulama yapın:

1. Toplu raporu doğrulama:

   • Toplu raporlar oluşturun ve çıktı alanını AVRO biçimine dönüştürmek için aggregatable_report_converter aracını kullanın.
   • Bu toplanabilir rapor ve çıkış alan dosyasıyla bir createJob isteği çalıştırın.
   • Bu işlem sonucunda SUCCESS döndürülürse toplanabilir rapor bozulmamış demektir. Bu işlem hata döndürüyorsa toplanabilir raporunuzla veya hem rapor hem de alanınızla ilgili bir sorununuz var demektir.
   • Sonraki adımda alan dosyasını kontrol edin.

2. Çıkış alan dosyasını doğrulama:

   • Çıkış alan dosyası oluşturun ve birleştirilebilir raporu oluşturmak için aggregatable_report_converter aracını kullanın.
   • Bu toplanabilir rapor ve çıkış alan dosyasıyla bir createJob isteği çalıştırın.
   • Bu işlem SUCCESS döndürüyorsa çıkış alanı bozulmamış demektir ve birleştirilebilir raporu oluşturma kodunuzda bir sorun vardır.
   • shared_info adresini kontrol etmek için sonraki adıma geçin.

3. Paylaşılan bilgileri doğrulama:

   • Raporlarda hata ayıklama özelliğini etkinleştirdiğinizden emin olun. Hata ayıklama özelliği etkinleştirilen raporlarda debug_cleartext_payload alanı bulunur.
   • Yerel test aracıyla kullanılacak bir hata ayıklama raporu oluşturun ve yük olarak debug_cleartext_payload kullanın.
   • Yerel test aracını alan dosyanızla çalıştırın. Bu bir SUCCESS ise shared_info dosyanızla oynanmış demektir.

Başka bir hata veya müdahale olduğundan şüpheleniyorsanız JSON toplu raporunu, alan anahtarını, oluşturulan toplu AVRO raporunu ve çıkış alanını toplayın ve sonraki adımlara geçin.

Yeni dağıtım sürümünüzü inceleme

Toplama Hizmeti sürümünüzün hâlâ desteklendiğini doğrulayın. Kullandığınız sürümü belirledikten sonra Toplama Hizmeti sürümlerinin listesini kontrol edin ve sürümünüzde destek sonu uyarısı bulunmadığını onaylayın: This release has reached its end of support on { date }. Hangi sürümü dağıttığınızı belirlemeyle ilgili aşağıdaki talimatlar, desteklenen herkese açık bulutlar içindir.

Google Cloud için adımlar

1. Compute Engine > Sanal makine örnekleri'ne gidin.
2. Adında -worker- bulunan sanal makine örneğini tıklayın.
3. Custom Metadata bölümünü ve ardından tee-image-reference anahtarını bulun.
   • Not: Terraform tarafından Google Cloud'da temel hazırlığı yapılan her sanal makinede bu meta veriler (çalışan modülündeki tee-image-reference meta verileri) bulunmalıdır.
4. tee-image-reference değerinde sürüm numarası yer alır. Örneğin, aşağıdaki yolun sürüm numarası v2.9.1'tür. Bunlar, bir Google Cloud projesinin Artifact Registry'sinde bulunan önceden oluşturulmuş görüntülerdir.
   • Not: Bu, önceden oluşturulmuş öğeleri kullanıyorsanız geçerlidir. Aksi takdirde, bu ad, resminizi kişisel olarak adlandırıp etiketlediğiniz adla eşleşmelidir. (örnek: us.docker.pkg.dev/<gcp_project_name>/artifacts:aggregation-service- container-artifacts-worker_mp_go_prod:2.9.1)

Amazon Web Services için adımlar

1. Amazon Web Services konsolunuzda EC2 Örnekleri'ne gidin.
2. aggregation-service-operator-dev-env adlı örneği tıklayın.
3. Örnek sayfasında Ayrıntılar > AMI (Amazon Makine Görüntüsü)'nü bulun.
4. Sürüm adınız resim yoluna eklenmelidir. Örneğin, aşağıdaki yolun sürüm numarası v2.9.1'tür.
   • Not: Bu, önceden oluşturulmuş öğeleri kullanıyorsanız geçerlidir. Aksi takdirde, bu ad, resminizi kişisel olarak adlandırıp etiketlediğiniz adla eşleşmelidir. (örnek: aggregation-service-enclave_2.9.1--2024-10-03T01-24-25Z)

Sonraki Adımlar

Toplama Hizmeti sorununuzun çözümünü görmüyorsanız GitHub sorunu bildirerek veya teknik destek formunu göndererek bizi bilgilendirin.