Dzienniki błędów
Intelligent Recommendations tworzy dziennik błędów dla każdego obiektu danych, który jest przetwarzany przez usługę w komputerze Azure Data Lake Storage. Dziennik błędów jest zapisywany z powrotem na konto Data Lake Storage. Jeśli masz problemy z konfiguracją danych, skorzystaj z tego artykułu, aby poznać błędy zgłaszane w dzienniku i dowiedzieć się, jak je poprawić.
W tym artykule wymieniono rodzaje błędów w dzienniku wykrytych przez usługę Intelligent Recommendations, ich znaczenie oraz wskazówki, jak je rozwiązać.
Gdy błędy zostaną skorygowane, Intelligent Recommendations automatycznie pobiera nowe dane i przetwarza zmiany podczas kolejnego okresowego cyklu modelowania. Aby dowiedzieć się więcej o tym procesie, przejdź do tematu Ręczne wywoływanie modelowania.
Typy błędów
Skorzystaj z poniższej tabeli, aby poznać różne typy błędów, które mogą być zwracane przez Intelligent Recommendations.
Niektóre typy błędów powodują zatrzymanie przetwarzania wiersza, podczas gdy inne typy błędów mogą powodować zatrzymanie przetwarzania w całości.
W przypadku błędów, które powodują usunięcie wiersza z przetwarzania, jeśli jest to powszechne w danych wejściowych, może to skutkować niską jakością produktu lub nawet pustymi wynikami.
| Typ błędu | opis | Sugerowane rozwiązanie |
|---|---|---|
| AttributeValueNotAllowed | Atrybut używa wartości zarezerwowanej lub przeznaczonej do rezerwacji. | Wartość „0” jest zarezerwowana w systemie. Jeśli jest to możliwe, zmień wartość tego atrybutu. Aby uzyskać więcej informacji, zobacz Encje katalogu danych. |
| DataTypeMismatch | Format określonego typu danych jest niepoprawny. | Dokładnie sprawdź formatowanie i upewnij się, że w pliku model.json lub w kontrakcie dotyczącym danych nie ma żadnych niewłaściwych znaków ani spacji. Więcej informacji na temat formatowania można znaleźć w wytycznych dotyczących formatowania kontraktów danych. |
| EmptyMandatoryAttribute | Jeden z obowiązkowych atrybutów w wierszu jest pusty. | Wypełnij brakujące dane. |
| InvalidGuidIdFormat | Jeśli system jest ustawiony do pracy z typami identyfikatorów GUID ItemID, wszystkie identyfikatory powinny być identyfikatorami GUID. | Ujmij spójność typu ItemID we wszystkich wierszach. |
| InvalidIdFormat | Jeśli system jest ustawiony do pracy z typami alfanumerycznymi (16) ItemID, wszystkie identyfikatory powinny być alfanumeryczne (16). | Ujmij spójność typu ItemID we wszystkich wierszach. |
| ImageContentIsEmpty | Pobrany obraz jest pusty. | Sprawdź adres URL obrazu. |
| ImageDownloadFailed | Obrazy muszą znajdować się w usłudze Data Lake Storage i być chronione za pomocą uwierzytelniania (dostęp nieanonimowy). | Sprawdź adres URL obrazu. |
| ImageMalwareDetected | Złośliwe oprogramowanie wykryło problem ze zdjęciem. | Sprawdź adres URL obrazu. |
| ImageNotFound | Obraz nie został znaleziony w podanym adresie URL. | Sprawdź adres URL obrazu. |
| ImageSizeLargerThanAllowed | Obraz jest większy niż maksymalny dozwolony. | Sprawdź adres URL obrazu. |
| ImageUnexpectedContentType | Adres URL obrazu zawiera nieoczekiwane typ zawartości. | Sprawdź adres URL obrazu. |
| MalwareDetected | Sprawdź pliki obrazu. Mogą być zarażone. | Sprawdź adres URL obrazu. |
| InvalidListName | Upewnij się, że nazwa listy jest zgodna z dokumentacją. | Aby uzyskać więcej informacji, zobacz Rekomendacje wzbogacania encji danych. |
| InvalidDateFormat | W danych wejściowych ItemsAndVariformat data wydania nie ma obsługiwanego formatu daty i godzin yyyy-MM-ddTHH:mm:ss.fffZ. |
Potwierdź, że format daty i godzina spełnia wymagania schematu kontraktu danych lub pozostaw datę wydania pustą. |
| InvalidListAvailabilityRange | Data rozpoczęcia powinna być wcześniejsza niż Data zakończenia i nie powinna być pusta. | Sprawdź terminy dostępności. Aby uzyskać więcej informacji, zobacz Encje katalogu danych. |
| UniqueAttributeCountExceedsThreshold | Niektóre atrybuty są ograniczone pod względem unikatowych wartości. Ten błąd oznacza, że usługa Intelligent Recommendations osiągnęła rozmiar danych przekraczający obsługiwane limity. | Jeśli ten błąd występuje i nie można go rozwiązać, przejdź do pomocy technicznej. |
| CsvInvalidFormat | Encja danych wejściowych może mieć zły format CSV. | Plik dziennika błędów wskaże klientowi lokalizację błędu i więcej szczegółów na jego temat. Aby uzyskać więcej informacji, zobacz Wytyczne dotyczące formatu danych kontraktu danych w danych. |
| MissingAttribute | Określona encja danych nie zawiera wszystkich wymaganych atrybutów. | Aby uzyskać więcej informacji na temat atrybutów wymaganych określonych obiektów danych, zobacz omówienie kontraktu danych. |
| MandatoryInputIsMisssing | Brak pliku model.json. | Sprawdź ponownie, czy pliki model.json zostały poprawnie przekazane do konta magazynu poniżej ir_root magazynu. Następnie sprawdź, czy parametry połączenia zasobu modelowania wskazują folder zawierający plik model.json. Jeśli Twój plik model.json został zmodyfikowany, jest uszkodzony lub go brakuje, możesz pobrać nowy model model.json file z kontraktu danych i dodaj go do folderu ir_root. |
| MulitpleFilterTypes | Reco_ItemAndVariantFilters zawiera nazwę filtru z więcej niż jednym typem filtrów. | Przejrzyj umowę dotyczącą danych i potwierdź, że wszystkie wartości związane z określoną nazwą FilterName mają ten sam typ FilterType. Aby uzyskać więcej informacji, zobacz wytyczne dotyczące filtrów elementów i wariantów. |
| NonNumericFilterValue | Filtry numeryczne zakładają, że wszystkie wartości są numeryczne. | Zmień filtr na dane liczbowe. |
| TotalLineCountExceedsThreshold | Encje danych wejściowych przekroczą obecnie wartość progową liczby wierszy. | Usługa ma domyślny próg dla liczby unikatowych wartości i kombinacji dla pewnych encji i wartości danych. Sprawdź pliki dziennika, aby zobaczyć, gdzie występuje błąd, i postępuj zgodnie z wytycznymi dotyczącymi formatowania kontraktu danych, aby zidentyfikować właściwy progi dla każdej jednostki danych. |
| UnexpectedColumnCount | Brakuje lub jest więcej kolumn niż dozwolonych w kontrakcie danych. Niektóre kolumny mogą mieć wartości opcjonalne i mogą zostać pozostawione puste, ale aby usługa działała prawidłowo, wszystkie kolumny muszą być obecne. | W przypadku kolumn nie obowiązkowych lub brak dostępnych danych pozostaw kolumnę pustą. Nie usuwaj kolumn. Schemat wejściowy powinien mieć dokładnie 12 kolumn. Nieprawidłowo zmienione ciągi znaków mogą zawierać przecinki i zakłócać liczbę kolumn. Nie edytuj pliku model.json, ponieważ może to spowodować zerwanie umowy dotyczącej danych. Jeśli Twój plik model.json został zmodyfikowany lub uszkodzony, możesz pobrać nowy plik model.json z umowy o dane. |
| UniqueAttributeCountExceedsThreshold | Jednostki danych wejściowych obecnie przekraczają próg liczby unikalnych wartości/kombinacji. | Usługa ma domyślny próg dla liczby unikatowych wartości i kombinacji dla pewnych encji i wartości danych. Sprawdź pliki dziennika, aby zobaczyć, gdzie występuje błąd, i postępuj zgodnie z wytycznymi dotyczącymi formatowania kontraktu danych, aby zidentyfikować właściwy progi dla każdej jednostki danych. |
| UnsupportedFilterType | Usługa podejrzewa, że używasz nieobsługiwanego typu filtra. | Upewnij się, że typ filtru jest jedną z obsługiwanych wartości w dokumentacji. Aby uzyskać więcej informacji, przejdź do encji danych katalogu. |
| DistinctValueViolation | ItemsAndVariants.csv ma zduplikowane identyfikatory wariantów. Sprawdź dzienniki pod kątem identyfikatora wariantu elementu z duplikatami. | Jeśli w kontrakcie dotyczącym danych zostaną zidentyfikowane duplikaty, usługa przestanie przetwarzać odpowiednią jednostkę danych, więc scenariusz wykorzystujący tę jednostkę danych nie zostanie przetworzony. Ten błąd będzie wyzwalany między pierwszymi minutami lub w ciągu godziny, w zależności od ilości danych. Aby rozwiązać problemy, należy usunąć duplikaty i ponownie uruchomić cykl modelowania. |
| DistinctValueViolation | Plik Interakcje.csv zawiera dwa różne elementy główne o tym samym identyfikatorze wariantu. Należy sprawdzić, czy w dziennikach są identyfikatory elementów o tym samym identyfikatorze wariantu. | Jeśli w kontrakcie dotyczącym danych zostaną zidentyfikowane duplikaty, usługa przestanie przetwarzać odpowiednią jednostkę danych, więc scenariusz wykorzystujący tę jednostkę danych nie zostanie przetworzony. Ten błąd będzie wyzwalany między pierwszymi minutami lub w ciągu godziny, w zależności od ilości danych. Aby rozwiązać problemy, należy usunąć duplikaty i ponownie uruchomić cykl modelowania. |
| UniqueAttributesCombinationExceedsThreshold | Istnieje kombinacja danych wejściowych, która przekroczyła limit. Na przykład: itemId, variantId unique count cross limit. | Sprawdź pliki dziennika, aby zobaczyć, gdzie występuje błąd, i postępuj zgodnie z wytycznymi dotyczącymi formatowania kontraktu danych, aby zidentyfikować właściwy progi dla każdej jednostki danych. |
| MaxUniqueAttributeCountPerItemExceedsThreshold | Kombinacja danych wejściowych przekroczyła limit dostępny dla każdego produktu. Na przykład liczba różnych obrazów dla poszczególnych elementów jest ograniczana. | Sprawdź pliki dziennika, aby zobaczyć, gdzie występuje błąd, i postępuj zgodnie z wytycznymi dotyczącymi formatowania kontraktu danych, aby zidentyfikować właściwy progi dla każdej jednostki danych. |
| Wewnętrznie | Błąd ogólny; każdy błąd inny niż wymienione, którego nie udało się zidentyfikować. | Jeśli ten błąd występuje i nie można go rozwiązać, proszę Skontaktuj się z naszym zespołem. |
Przykładowy plik dziennika
Oto przykład pliku dziennika. Odpowiedź zawiera następujące sekcje:
- TotalRecordCount: Łączna liczba wierszy przetwarzanych poprawnie.
- TotalDroppedRecords liczba wierszy, które zostały przerwane z powodu problemów z konfiguracją danych.
- Błędy: Typy błędów wykrytych i pogrupowane w kategorie. Każdy typ błędu zawiera łączną liczbę wierszy i przykład błędnie sformatowanych danych.
W przykładzie poniżej można zauważyć, że są zwracane dwa typy błędów. Pierwszy błąd „EmptyMandatoryAttribute” pokazuje, że obecnie istnieje element ItemId z pustym ciągiem. Drugi błąd „InvalidIdFormat” odwołuje się do nieprawidłowego formatu ItemId i przykładów, w których ItemId są nieprawidłowo skonfigurowane.
{
"TotalRecordCount": 12803,
"TotalDroppedRecords": 69,
"Errors": [
{
"ErrorCategory": "EmptyMandatoryAttribute",
"ColumnName": "ItemId",
"ErrorCount": 1,
"Samples": [
""
]
},
{
"ErrorCategory": "InvalidIdFormat",
"ColumnName": "ItemId",
"ErrorCount": 68,
"Samples": [
"6.92E+13",
"4.18E+171",
"5.74E+13",
"6.70E+36",
"9.95E+11",
"5.13E+23",
"9.26E+14",
"1.02E+11",
"5.43E+14",
"9.07E+80"
]
}
]
}
Nadal potrzebujesz pomocy?
Jeśli problemy nie występują w tabeli, należy sięgać do pomocy technicznej, aby uzyskać informacje na temat sposobu dotarcia do zespołu pomocy technicznej dotyczącej Intelligent Recommendations.
Zobacz też
Konfigurowanie rejestrowania błęduOmówienie kontraktu danychOdnośnik Intelligent Recommendations APIKody stanu APIPrzewodnik szybkiego startu: Skonfiguruj i uruchom Intelligent Recommendations z przykładowymi danymiDeployment overview