Protokoly chyb
Intelligent Recommendations vytváří protokol chyb pro každý datový objekt, který služba zpracovává ve vašem Azure Data Lake Storage. Protokol chyb je zapsán zpět do účtu Data Lake Storage. Pokud máte problémy s konfigurací dat, použijte tento článek, abyste porozuměli chybám hlášeným v protokolu a jak je opravit.
Tento článek uvádí typy chyb v protokolu nalezených službou Intelligent Recommendations, co znamenají a tipy, jak je vyřešit.
Když jsou chyby opraveny, Intelligent Recommendations automaticky převezme nová data a zpracuje změny během příštího periodického modelovacího cyklu. Chcete-li se dozvědět více o tomto procesu, přejděte do části Ruční spuštění modelování.
Typy chyb
Následující tabulka vám pomůže pochopit různé typy chyb, které mohou být vráceny Intelligent Recommendations.
Některé typy chyb způsobují vyřazení řádku ze zpracování, zatímco jiné typy chyb mohou být fatální a způsobit, že se proces přípravy úplně zastaví.
Chyby, které způsobí vyřazení řádku ze zpracování, pokud jsou ve vstupních datech rozšířené, mohou mít za následek špatnou kvalitu produktu, nebo dokonce prázdné výsledky.
| Typ chyby | Popis | Navrhované řešení |
|---|---|---|
| AttributeValueNotAllowed | Atribut používá vyhrazenou nebo nesprávnou hodnotu. | Hodnota „0“ je vyhrazena v systému. Pokud je to možné, změňte hodnotu tohoto atributu. Další informace získáte v části Datové entity katalogu. |
| DataTypeMismatch | Formát zadaného datového typu je nesprávný. | Pečlivě zkontrolujte formátování a ujistěte se, že v souboru model.json nebo datové smlouvě nejsou žádné nesprávné znaky nebo mezery. Další informace o formátování naleznete v našich Pokynech pro formátování smlouvy o datech. |
| EmptyMandatoryAttribute | Jeden z povinných atributů v řádku je prázdný. | Doplňte chybějící data. |
| InvalidGuidIdFormat | Pokud je systém nastaven na práci s typy GUID ItemID, všechna ID by měla být GUID. | Zajistěte, aby byl typ ItemID konzistentní ve všech řádcích. |
| InvalidIdFormat | Pokud je systém nastaven na práci s alfanumerickými (16) typy ItemID, všechna ID musí být alfanumerická (16). | Zajistěte, aby byl typ ItemID konzistentní ve všech řádcích. |
| ImageContentIsEmpty | Stažený obrázek je prázdný. | Zkontrolujte adresu URL obrázku. |
| ImageDownloadFailed | Obrázky musí být na Data Lake Storage a chráněny autentizací (neanonymní přístup). | Zkontrolujte adresu URL obrázku. |
| ImageMalwareDetected | Kontrola malwaru zjistila problém s obrázkem. | Zkontrolujte adresu URL obrázku. |
| ImageNotFound | Na zadané adrese URL nebyl obrázek nalezen. | Zkontrolujte adresu URL obrázku. |
| ImageSizeLargerThanAllowed | Obrázek je větší než maximální povolená velikost. | Zkontrolujte adresu URL obrázku. |
| ImageUnexpectedContentType | Adresa URL obrázku obsahuje neočekávaný typ obsahu. | Zkontrolujte adresu URL obrázku. |
| MalwareDetected | Zkontrolujte soubory obrázku. Mohou být nakažené. | Zkontrolujte adresu URL obrázku. |
| InvalidListName | Ujistěte se, že název seznamu odpovídá dokumentaci. | Další informace získáte v části Datové entity rozšiřování doporučení. |
| InvalidDateFormat | Ve vstupu ItemsAndVariants není datum vydání v podporovaném formátu data a času yyyy-MM-ddTHH:mm:ss.fffZ. |
Potvrďte, že váš formát data a času odpovídá požadavkům v našem schématu datové smlouvy, nebo ponechte datum vydání prázdné. |
| InvalidListAvailabilityRange | Datum zahájení musí být dřívější než datum ukončení a ani jedno nesmí být prázdné. | Zkontrolujte data dostupností. Další informace získáte v části Datové entity katalogu. |
| UniqueAttributeCountExceedsThreshold | Některé atributy jsou omezeny z hlediska jedinečných hodnot. Tato chyba znamená, že služba Intelligent Recommendations dosáhla velikosti dat mimo podporované limity. | Pokud k této chybě dojde a problém nemůžete vyřešit, přejděte na stránku Podpora. |
| CsvInvalidFormat | Entita vstupních dat může mít nesprávný formát CSV. | Soubor protokolu chyb bude klientovi indikovat umístění chyby a další podrobnosti o chybě. Další informace najdete v Pokynech pro formát dat datové smlouvy. |
| MissingAttribute | Zadaná datová entita neobsahuje všechny požadované atributy. | Další informace o tom, jaké jsou požadované atributy konkrétních datových entit, najdete v Přehledu datové smlouvy. |
| MandatoryInputIsMisssing | Chybí soubor model.json. | Znovu se ujistěte, že jste správně nahráli soubory model.json do účtu úložiště pod složkou ir_root . Zadruhé zkontrolujte, zda připojovací řetězec prostředků modelování ukazuje na složku se souborem model.json. Pokud byl váš soubor model.json upraven, je poškozený nebo chybí, můžete si stáhnout nový soubor model.json z datové smlouvy a přidat ho do složky ir_root. |
| MulitpleFilterTypes | Reco_ItemAndVariantFilters obsahuje název filtru s více než jedním typem filtru. | Zkontrolujte smlouvu o datech a potvrďte, že všechny hodnoty související s konkrétním názvem filtru mají stejný typ filtru. Další informace naleznete v našich pokynech k filtrům položek a variant. |
| NonNumericFilterValue | Číselné filtry předpokládají, že všechny hodnoty jsou číselné. | Změňte filtr na číselná data. |
| TotalLineCountExceedsThreshold | Entity vstupních dat aktuálně překračují práh počtu řádků. | Služba má výchozí práh pro počet jedinečných hodnot a kombinací pro určité datové entity a hodnoty. Zkontrolujte soubory protokolu, abyste zjistili, kde dochází k chybě, a postupujte podle pokynů pro formátování datové smlouvy, abyste určili správné prahové hodnoty pro každou datovou entitu. |
| UnexpectedColumnCount | Buď chybí sloupce, nebo máte více sloupců, než povoluje datová smlouva. Některé sloupce mohou mít volitelné hodnoty a mohou být ponechány prázdné, ale aby služba fungovala správně, musí být přítomny všechny sloupce. | Pro nepovinné sloupce nebo nedostupná data ponechte sloupec prázdný. Neodstraňujte sloupce. Ve vstupním schématu musí být přesně 12 sloupců. Nesprávně uvozené řetězce mohou obsahovat čárky a přerušit počet sloupců. Neupravujte soubor model.json, protože by to mohlo rozbít vaši datovou smlouvu. Pokud byl váš soubor model.json upraven nebo je poškozený, můžete si stáhnout nový soubor model.json z datové smlouvy. |
| UniqueAttributeCountExceedsThreshold | Entity vstupních dat aktuálně překračují práh počtu jedinečných hodnot / kombinací. | Služba má výchozí práh pro počet jedinečných hodnot a kombinací pro určité datové entity a hodnoty. Zkontrolujte soubory protokolu, abyste zjistili, kde dochází k chybě, a postupujte podle pokynů pro formátování datové smlouvy, abyste určili správné prahové hodnoty pro každou datovou entitu. |
| UnsupportedFilterType | Služba má podezření, že používáte nepodporovaný typ filtru. | Ujistěte se, že typ filtru je jednou z podporovaných hodnot v dokumentaci. Další informace najdete v části Datové entity katalogu. |
| DistinctValueViolation | Soubor ItemsAndVariants.csv má duplicitní ID variant. Zkontrolujte protokoly pro ID varianty položky s duplikáty. | Pokud jsou v datové smlouvě identifikovány duplikáty, služba přestane zpracovávat příslušnou datovou entitu, takže scénář, který datovou entitu využívá, nebude zpracován. Tato chyba se spustí mezi několika prvními minutami nebo během hodiny v závislosti na množství dat. Chcete-li to vyřešit, odstraňte všechny duplikáty a restartujte cyklus modelování. |
| DistinctValueViolation | Soubor Interactions.csv obsahuje dvě různé hlavní položky se stejným ID varianty. Zkontrolujte protokoly na ID položek, které mají stejné ID varianty. | Pokud jsou v datové smlouvě identifikovány duplikáty, služba přestane zpracovávat příslušnou datovou entitu, takže scénář, který datovou entitu využívá, nebude zpracován. Tato chyba se spustí mezi několika prvními minutami nebo během hodiny v závislosti na množství dat. Chcete-li to vyřešit, odstraňte všechny duplikáty a restartujte cyklus modelování. |
| UniqueAttributesCombinationExceedsThreshold | Existuje kombinace vstupních dat, která překročila svůj limit. Například: křížový limit počtu jedinečných hodnot itemId, variantId. | Zkontrolujte soubory protokolu, abyste zjistili, kde dochází k chybě, a postupujte podle pokynů pro formátování datové smlouvy, abyste určili správné prahové hodnoty pro každou datovou entitu. |
| MaxUniqueAttributeCountPerItemExceedsThreshold | Kombinace vstupních dat překročila limit, který je na produkt. Například: počet různých obrázků na položku překračuje limit. | Zkontrolujte soubory protokolu, abyste zjistili, kde dochází k chybě, a postupujte podle pokynů pro formátování datové smlouvy, abyste určili správné prahové hodnoty pro každou datovou entitu. |
| Interní | Obecná chyba; jakákoli jiná chyba než výše uvedená, kterou nebylo možné identifikovat. | Pokud k této chybě dojde a problém nemůžete vyřešit, kontaktujte náš tým. |
Příklad souboru protokolu
Zde je příklad souboru protokolu. Odpověď obsahuje následující části:
- TotalRecordCount: Celkový počet správně zpracovaných řádků.
- TotalDroppedRecords: Celkový počet řádků, které byly vynechány kvůli problémům s konfigurací dat.
- Chyby: Typy zjištěných chyb a seskupené do kategorií. Každý typ chyby zahrnuje celkový počet řádků a vzorek chybně naformátovaných dat.
V níže uvedeném příkladu si všimnete, že jsou vráceny dva typy chyb. První chyba „EmptyMandatoryAttribute“ ukazuje, že aktuálně zbývá ItemId s prázdným řetězcem. Druhá chyba „InvalidIdFormat“ odkazuje na neplatný formát ItemId a příklady, jejichž ItemId jsou nesprávně nakonfigurovány.
{
"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"
]
}
]
}
Stále potřebujete pomoc?
Pokud se vyskytnou problémy, které nejsou zahrnuty v této tabulce, přejděte na stránku Podpora, kde najdete informace o tom, jak kontaktovat tým podpory Intelligent Recommendations.
Viz také
Nastavení protokolování chybPřehled datové smlouvyReference rozhraní API pro Intelligent RecommendationsStavové kódy rozhraní APIRychlý průvodce: Nastavení a spouštění Intelligent Recommendations se vzorovými datyPřehled nasazení