W tabelach poniżej znajdziesz szczegółowe informacje o wielu problemach i kodach stanu błędów wraz z potencjalnymi przyczynami ich wystąpienia oraz działaniami, które możesz podjąć, aby ograniczyć wdrożenie. Jeśli chcesz zapoznać się z pełnymi specyfikacjami błędów i sposobami ich usuwania w usłudze agregacji, zapoznaj się z naszą aktualną publiczną instrukcją.
Tematy przewodnika:
- Błędy dotyczące uprawnień i autoryzacji
- Błędy budżetu prywatności
- Błędy związane z czasem działania zadania
Uprawnienia i błędy autoryzacji
Problem | problemy z uprawnieniami podczas wykonywania poleceń terraform plan lub terraform apply w projekcie chmury publicznej. |
---|---|
Przykład błędu | Error: UnauthorizedOperation: You are not authorized to perform this operation. |
Rozdzielczość |
Sprawdź, czy masz prawidłowo uwierzytelnione konto w interfejsie wiersza poleceń (CLI) chmury publicznej, z której korzystasz. Amazon Web ServicesAby móc tworzyć instancje i inne usługi wymagane przez usługę agregacji, AWS wymaga uprawnień użytkownika. Po zastosowaniu tych zmian powinieneś mieć możliwość wykonania polecenia terraform plan i terraform apply bez żadnych problemów. Google Cloud PlatformW Google Cloud musisz się podszyć pod konto usługi, aby wdrożyć drugą połowę Terraform. Jeśli pominiesz ten krok, polecenie terraform apply może się nie uruchomić, ponieważ konto usługi wdrożeniowej ma wszystkie niezbędne uprawnienia do tworzenia zasobów. Więcej informacji znajdziesz w kroku 4 sekcji „Konfigurowanie środowiska wdrażania” w dokumentacji na GitHubie. |
Błędy budżetu na potrzeby prywatności
Błąd | PRIVACY_BUDGET_ERROR |
---|---|
Przyczyna | Oznacza to, że usługa nie mogła przetworzyć zgłoszeń z powodu błędu w usłudze budżetu prywatności. |
Czek | Ponownie uruchom zadanie, aby sprawdzić, czy błąd był sporadyczny, a potem skontaktuj się z nami za pomocą formularza pomocy technicznej. |
Błąd | PRIVACY_BUDGET_AUTHORIZATION_ERROR |
---|---|
Przyczyna | Możesz używać innego źródła danych niż to, które zostało podane podczas wdrożenia. |
Czek |
Sprawdź, czy witryna przesłana w polu Witryna powinna być zgodna z zarejestrowaną lub być jej subdomeną. Pamiętaj, że wdrożenie usługi agregacji odbywa się w domenie najwyższego poziomu, a po jej wdrożeniu wszystkie subdomeny mogą korzystać z usługi agregacji. |
Błąd | PRIVACY_BUDGET_AUTHENTICATION_ERROR |
---|---|
Przyczyna | Być może używasz nieaktualnego lub nieprawidłowego identyfikatora ARN. |
Czek |
Google Cloud Platform
Sprawdź, czy konto usługi używane w wdrożeniu usługi agregacji jest zgodne z kontem usługi podanym podczas rejestracji. Musi być identyczny, a nie należeć tylko do tego samego projektu. Amazon Web ServicesOczekujemy, że używasz tych samych koordynatorów, którzy zostali Ci przekazani w e-mailu. Jeśli nadal masz problemy, prześlij plik auto.tfvars i informacje o pochodzeniu raportu, a potem wypełnij formularz kontaktu z zespołem pomocy technicznej. |
Błąd | PRIVACY_BUDGET_EXHAUSTED |
---|---|
Przyczyna |
Błąd:
"result_info": {
"return_code": "PRIVACY_BUDGET_EXHAUSTED",
"return_message": "com.google.aggregate.adtech.worker.exceptions.AggregationJobProcessException:
Insufficient privacy budget for one or more aggregatable reports. No aggregatable report can appear
in more than one aggregation job. Information related to reports that do not have budget can be
found in the following file:
File path: Problem z wyczerpaniem budżetu na prywatność występuje, gdy próbujesz utworzyć raport zbiorczy, którego wspólny identyfikator został już uwzględniony w raporcie zbiorczym, który został już wcześniej utworzony. Ten błąd występuje z powodu reguły „Brak duplikatów”, która pozwala raportom podlegającym agregacji występować tylko w jednym zbiorze i tylko w jednym raporcie zbiorczym. Każdemu raportowi zostanie przypisany „identyfikator wspólny”, który będzie składał się z wartości pól interfejsu API |
Czek |
Aby sprawdzić i usunąć błąd, skorzystaj z pomocy w przypadku wyczerpania budżetu na ochronę prywatności, która jest dostępna w odpowiedzi na zgłoszenie. Utworzy to nowy plik pomocniczy JSON, który pozwoli Ci sprawdzić, które raporty przyczyniły się do błędu. Pamiętaj, że jeśli prawidłowo korzystasz z grupowania, możesz kwalifikować się do odzyskania budżetu (wyjaśnienie). Zaproponuj, aby przeczytali artykuł wyjaśniający i wypełnili formularz. Pamiętaj, że aby odzyskać budżet i ponownie wykonać zadanie, muszą przesłać prośbę, która zostanie zatwierdzona. |
Błąd | DEBUG_SUCCESS_WITH_PRIVACY_BUDGET_EXHAUSTED |
---|---|
Przyczyna |
Wskazuje to, że zadanie jest wykonywane w trybie debugowania. Element job_parameters w żądaniu createJob zawiera element debug_run: true . Gdy włączona jest flaga debug_run , możesz uruchomić raport kilka razy w celu debugowania. Ten komunikat o błędzie informuje, że zadanie nie zostałoby wykonane z powodu wyczerpania budżetu prywatności raportu, gdyby nie zostało uruchomione w trybie debugowania. Ten błąd będzie występował tylko w wersjach 2.10.0 i starszych.
|
Czek |
Treść żądania createJob będzie zawierać debug_run w sekcji job_parameters .
{
"job_request_id": "{job_request_id}",
"input_data_blob_prefix": "{input_prefix}",
"input_data_bucket_name": "{input_bucket}",
"output_data_blob_prefix": "{output_prefix}",
"output_data_bucket_name": "{output_bucket}",
"job_parameters": {
"output_domain_blob_prefix": "{output_domain_prefix}",
"output_domain_bucket_name": "{output_domain_bucket}",
"attribution_report_to": "{reporting_origin}",
"debug_run": "true"
}
}
|
Błędy zadań podczas wykonywania
Błąd | INVALID_JOB |
---|---|
Punkt końcowy | createJob |
Przyczyna | Może się tak zdarzyć, gdy podany epsilon do debugowania nie mieści się w zakresie (0,64] lub gdy nie udało się zweryfikować parametrów zlecenia. |
Czek |
Jaka wartość epsilon została użyta? Jakie parametry zadania zostały użyte w prośbie createJob i czy pasują one do Twojego środowiska? Czy są one prawidłowo sformatowane? Wprowadź niezbędne poprawki i ponownie uruchom zadanie.
|
Błąd | INTERNAL_ERROR |
---|---|
Punkt końcowy | getJob |
Przyczyna | Może to być problem z formatowaniem, który powoduje niepowodzenie przetwarzania domeny wyjściowej lub raportów. Może to być też problem z wdrożeniem usługi agregacji. |
Czek | Sprawdź, czy lokalizacja domeny wyjściowej to prawidłowa ścieżka. Ponownie uruchom zadanie. Jeśli błąd będzie się powtarzał, poproś o plik auto.tfvars i wynik planu Terraform, aby rozwiązać problemy z wdrażaniem usługi agregacji.
|
Błąd | RESULT_WRITE_ERROR |
---|---|
Punkt końcowy | getJob |
Przyczyna | Może się tak zdarzyć, gdy zapisywanie w katalogu wyjściowym nie powiedzie się tymczasowo lub z powodu braku uprawnień do zapisu w tym katalogu. Pamiętaj, że błędy zapisu zużywają budżet prywatności, a zadania nie można ponownie uruchomić. Może to spowodować wystąpienie innego błędu PRIVACY_BUDGET_EXHAUSTED . |
Czek | Czy ten błąd występuje w przypadku każdego zadania czy tylko sporadycznie? Jeśli występuje to w przypadku każdego zadania, sprawdź, czy masz włączone uprawnienia do zapisu w katalogu wyjściowym. Jeśli jest to błąd sporadyczny, uprawnienia powinny być prawidłowe. Jest to znany problem. Mimo że generowanie raportów podsumowujących może się nie udać, budżet ochrony prywatności i tak zostanie wykorzystany. W takiej sytuacji możesz poprosić o przywrócenie budżetu (tłumaczenie). |
Problem | Podczas wykonywania zadania i pobierania tokena usługi uwierzytelniania występują błędy 403 , a zadanie zawsze zwraca stan „RECEIVED” (Odebrano). |
---|---|
Błąd |
{
"job_status": "RECEIVED",
"request_received_at": "{utc timestamp}",
"request_updated_at": "{utc timestamp}",
"job_request_id": "0001",
"input_data_blob_prefix": "reports/",
"input_data_bucket_name": "{bucket_name}",
"output_data_blob_prefix": "summary/",
"output_data_bucket_name": "{bucket_name}",
"postback_url": "",
"job_parameters": {
"output_domain_bucket_name": "{bucket_name}",
"output_domain_blob_prefix": "output_domain/",
"attribution_report_to": |
Rozdzielczość |
Zadania, które utknęły w stanie Po zweryfikowaniu stanu rejestracji i wprowadzania sprawdź, co stało się z uruchomionym zadaniem. Amazon Web ServicesW takim przypadku enklawa AWS może nie być uruchomiona lub uległa awarii, przez co zadania nie są pobierane.
Zarządzana grupa instancji może nie być w dobrym stanie. Jeśli konfigurujesz usługę po raz pierwszy lub ją zniszczyłeś/a i ponownie utworzyłeś/a, sprawdź, czy Twoje konto usługi jest włączone.
|
Czy raport podsumowujący działa zgodnie z oczekiwaniami?
Może się zdarzyć, że wywołanie getJob zakończy się powodzeniem, ale usługa do agregacji zwróci problem z raportami podsumowującymi. Raport podsumowania jest w formacie AVRO i trzeba go przekonwertować na format JSON
. Po przekonwertowaniu na format JSON dane będą wyglądać mniej więcej tak.
{
"bucket": "\u0005Y",
"metric": 26308
}
Jeśli wystąpi jakikolwiek problem z konwersją AVRO, spróbuj użyć narzędzi AVRO i wykonaj to polecenie w raporcie AVRO.
java -jar avro-tools-1.11.1.jar tojson [report_name].avro > [report_name].json
Stabilne wersje możesz pobrać tutaj. Jeśli potrzebujesz dalszej pomocy, wykonaj kolejne czynności.
Następne kroki
Sprawdź, czy ktoś inny nie napotkał tego samego problemu w panelu stanu Privacy Sandbox lub w publicznym repozytorium GitHub.
Jeśli nie widzisz rozwiązania problemu z usługą agregacji, poinformuj nas o tym, przesyłając problem na GitHubie lub wypełniając formularz pomocy technicznej.