Foutenlogboeken
Intelligent Recommendations maakt een foutlogboek voor elk gegevensobject dat de service in uw Azure Data Lake Storage verwerkt. Het foutlogboek wordt teruggeschreven naar het Data Lake Storage-account en dient als een logboek. Als u problemen heeft met de gegevensconfiguratie, kunt u dit artikel gebruikten om de fouten in het logboek te begrijpen en te verhelpen.
Dit artikel geeft een overzicht van de soorten fouten in het logboek die zijn gevonden door de Intelligent Recommendations-service, wat ze betekenen en tips voor het oplossen ervan.
Wanneer fouten zijn verholpen, pikt Intelligent Recommendations de nieuwe gegevens automatisch op en verwerkt de wijzigingen tijdens de volgende periodieke modelleringscyclus. Ga voor meer informatie over dit proces naar Modellering handmatig activeren.
Soorten fouten
Gebruik de onderstaande tabel om inzicht te krijgen in de verschillende soorten fouten die door Intelligent Recommendations kunnen worden geretourneerd.
Sommige typen fouten zorgen ervoor dat een rij niet wordt verwerkt, terwijl andere typen fouten fataal kunnen zijn en ervoor kunnen zorgen dat de verwerkingspijplijn volledig stopt.
Bij fouten die ervoor zorgen dat de rij niet wordt verwerkt en die veel voorkomen in de invoergegevens, kan dit resulteren in een slechte kwaliteit van het product of zelfs lege resultaten.
| Fouttype | Omschrijving | Voorgestelde oplossing |
|---|---|---|
| AttributeValueNotAllowed | Een kenmerk gebruikt een gereserveerde of onjuiste waarde. | De waarde 0 is gereserveerd in het systeem. Wijzig zo mogelijk de waarde voor dit kenmerk. Ga voor meer informatie naar Entiteiten met catalogusgegevens. |
| DataTypeMismatch | De indeling van een opgegeven gegevenstype is onjuist. | Controleer de indeling zorgvuldig en zorg ervoor dat er geen onjuiste tekens of spaties zijn opgenomen in de model.json of het gegevenscontract. Zie voor meer informatie over indelingen onze richtlijnen voor indelingen van gegevenscontracten. |
| EmptyMandatoryAttribute | Een van de verplichte kenmerken in een rij is leeg. | Vul de ontbrekende gegevens in. |
| InvalidGuidIdFormat | Als het systeem is ingesteld om te werken met ItemID GUID-typen, moeten alle id's GUID's zijn. | Maak het ItemID-type consistent in alle rijen. |
| InvalidIdFormat | Als het systeem is ingesteld om te werken met alfanumerieke(16) ItemID-typen, moeten alle id's alfanumeriek(16) zijn. | Maak het ItemID-type consistent in alle rijen. |
| ImageContentIsEmpty | De gedownloade afbeelding is leeg. | Controleer de afbeeldings-URL. |
| ImageDownloadFailed | Afbeeldingen moeten op Data Lake Storage staan en beveiligd zijn met authenticatie (niet-anonieme toegang). | Controleer de afbeeldings-URL. |
| ImageMalwareDetected | Malwarescan heeft een probleem met de afbeelding gedetecteerd. | Controleer de afbeeldings-URL. |
| ImageNotFound | Afbeelding is niet gevonden in de opgegeven URL. | Controleer de afbeeldings-URL. |
| ImageSizeLargerThanAllowed | Afbeelding is groter dan de maximaal toegestane grootte. | Controleer de afbeeldings-URL. |
| ImageUnexpectedContentType | Afbeeldings-URL bevat onverwacht inhoudstype. | Controleer de afbeeldings-URL. |
| MalwareDetected | Controleer de afbeeldingsbestanden. Mogelijk zijn ze besmet. | Controleer de afbeeldings-URL. |
| InvalidListName | Zorg ervoor dat de lijstnaam overeenkomt met de documentatie. | Ga voor meer informatie naar Gegevensentiteiten voor verrijking van aanbevelingen. |
| InvalidDateFormat | In de ItemsAndVariants-invoer is de releasedatum niet in de ondersteunde datum-tijdnotatie yyyy-MM-ddTHH:mm:ss.fffZ. |
Bevestig dat uw datum-tijdnotatie overeenkomt met de vereisten in ons Gegevenscontract-schema, of laat de releasedatum leeg. |
| InvalidListAvailabilityRange | De begindatum moet voor de einddatum vallen en beide mogen niet leeg zijn. | Controleer de beschikbaarheidsdata. Ga voor meer informatie naar Entiteiten met catalogusgegevens. |
| UniqueAttributeCountExceedsThreshold | Sommige kenmerken zijn beperkt ten aanzien van unieke waarden. Deze fout betekent dat de Intelligent Recommendations-service de gegevensgrootte heeft bereikt die de ondersteunde limieten overschrijdt. | Als deze fout voorkomt en u kunt het probleem niet oplossen, ga naar Ondersteuning. |
| CsvInvalidFormat | Invoergegevensentiteit heeft mogelijk niet de juiste CSV-indeling. | Het foutenlogboekbestand geeft aan de client de locatie van de fout en meer details over de fout door. Zie voor meer informatie de richtlijnen voor gegevensindelingen voor gegevenscontracten. |
| MissingAttribute | Een opgegeven gegevensentiteit bevat niet alle vereiste kenmerken. | Zie voor meer informatie over wat de vereiste kenmerken van specifieke gegevensentiteiten zijn Overzicht van gegevenscontract. |
| MandatoryInputIsMisssing | Het bestand model.json ontbreekt. | Bevestig opnieuw dat u uw model.json-bestanden correct hebt geüpload naar uw opslagaccount onder de map ir_root. Vervolgens moet u controleren of de verbindingsreeks voor modelleringsresources verwijst naar de map die het bestand model.json bevat. Als uw model.json-bestand ontbreekt of is gewijzigd of beschadigd, kunt u een nieuw model.json-bestand downloaden vanuit het gegevenscontract en het toevoegen aan uw ir_root-map. |
| MulitpleFilterTypes | Reco_ItemAndVariantFilters bevat een filternaam met meerdere filtertypen. | Bekijk het gegevenscontract en bevestig dat alle waarden die betrekking hebben op een specifieke filternaam allemaal hetzelfde filtertype hebben. Zie voor meer informatie onze richtlijnen voor artikel- en variantfilters. |
| NonNumericFilterValue | Numerieke filters gaan ervan uit dat alle waarden numeriek zijn. | Wijzig filter in numerieke gegevens. |
| TotalLineCountExceedsThreshold | Invoergegevensentiteiten overschrijden momenteel de drempelwaarde voor het aantal regels. | De service heeft een standaarddrempelwaarde voor het aantal unieke waarden en combinaties voor bepaalde gegevensentiteiten en -waarden. Controleer de logbestanden om te zien waar de fout zich voordoet en volg de richtlijnen voor de indeling van gegevenscontracten om de juiste drempelwaarden voor elke gegevensentiteit te identificeren. |
| UnexpectedColumnCount | U mist of hebt meer kolommen dan is toegestaan volgens het gegevenscontract. Sommige kolommen kunnen optionele waarden bevatten en kunnen leeg worden gelaten, maar alle kolommen moeten aanwezig zijn om de service correct te laten werken. | Voor niet-verplichte kolommen of niet-beschikbare gegevens laat u de kolom leeg. Verwijder geen kolommen. Het invoerschema moet precies 12 kolommen bevatten. Onjuist met escape-teken afgesloten tekenreeksen kunnen komma's bevatten en het aantal kolommen onderbreken. Bewerk het model.json-bestand niet, omdat dit uw gegevenscontract kan verbreken. Als uw model.json-bestand is gewijzigd of beschadigd, kunt u een nieuw model.json-bestand downloaden vanuit het gegevenscontract. |
| UniqueAttributeCountExceedsThreshold | Invoergegevensentiteiten overschrijden momenteel de drempelwaarde voor het aantal unieke waarden/combinaties. | De service heeft een standaarddrempelwaarde voor het aantal unieke waarden en combinaties voor bepaalde gegevensentiteiten en -waarden. Controleer de logbestanden om te zien waar de fout zich voordoet en volg de richtlijnen voor de indeling van gegevenscontracten om de juiste drempelwaarden voor elke gegevensentiteit te identificeren. |
| UnsupportedFilterType | De service vermoedt dat u een niet-ondersteund filtertype gebruikt. | Zorg ervoor dat het filtertype van een van de ondersteunde waarden in de documentatie is. Ga voor meer informatie naar Entiteiten met catalogusgegevens. |
| DistinctValueViolation | De ItemsAndVariants.csv bevat dubbele variant-id's. Controleer de logboeken op de artikelvariant-id met duplicaten. | Als er duplicaten worden geïdentificeerd in het gegevenscontract, stopt de service met het verwerken van de relevante gegevensentiteit, zodat het scenario dat gebruikmaakt van de gegevensentiteit niet wordt verwerkt. Deze fout treedt op tussen de eerste paar minuten of binnen het uur, afhankelijk van de hoeveelheid gegevens. Om dit op te lossen, verwijdert u eventuele duplicaten en start u de modelleringscyclus opnieuw. |
| DistinctValueViolation | De Interactions.csv bevat twee verschillende hoofdartikelen met dezelfde variant-id. Controleer de logboeken op de artikel-id's die dezelfde variant-id hebben. | Als er duplicaten worden geïdentificeerd in het gegevenscontract, stopt de service met het verwerken van de relevante gegevensentiteit, zodat het scenario dat gebruikmaakt van de gegevensentiteit niet wordt verwerkt. Deze fout treedt op tussen de eerste paar minuten of binnen het uur, afhankelijk van de hoeveelheid gegevens. Om dit op te lossen, verwijdert u eventuele duplicaten en start u de modelleringscyclus opnieuw. |
| UniqueAttributesCombinationExceedsThreshold | Er is een invoergegevenscombinatie die de limiet heeft overschreden. Bijvoorbeeld: overschrijdingslimiet voor uniek aantal van itemId, variantId. | Controleer de logbestanden om te zien waar de fout zich voordoet en volg de richtlijnen voor de indeling van gegevenscontracten om de juiste drempelwaarden voor elke gegevensentiteit te identificeren. |
| MaxUniqueAttributeCountPerItemExceedsThreshold | Een invoergegevenscombinatie heeft een limiet overschreden die per product geldt. Bijvoorbeeld: aantal verschillende afbeeldingen per item overschrijdt de limiet. | Controleer de logbestanden om te zien waar de fout zich voordoet en volg de richtlijnen voor de indeling van gegevenscontracten om de juiste drempelwaarden voor elke gegevensentiteit te identificeren. |
| Internal | Algemene fout: elke andere fout, buiten de hierboven beschreven fouten, die niet kon worden geïdentificeerd. | Als deze fout voorkomt en u het probleem niet kunt oplossen, kunt u contact opnemen met ons team. |
Voorbeeld van een logboekbestand
Dit is een voorbeeld van een logboekbestand. De respons bevat de volgende secties:
- TotalRecordCount: het totale aantal correct verwerkte rijen.
- TotalDroppedRecords: het totale aantal rijen dat is verwijderd vanwege problemen met de gegevensconfiguratie.
- Fouten: de soorten fouten die zijn ontdekt en gegroepeerd in categorieën. Elk fouttype omvat het totale aantal rijen en een voorbeeld van de verkeerd opgemaakte gegevens.
In het gegeven voorbeeld ziet u dat er twee soorten fouten worden geretourneerd. De eerste fout ′EmptyMandatoryAttribute′ geeft aan dat er momenteel een ItemId is met een lege tekenreeks. De tweede fout ′InvalidIdFormat′ verwijst naar een ongeldige indeling voor ItemId's en voorbeelden van welke ItemId's onjuist zijn geconfigureerd.
{
"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"
]
}
]
}
Nog steeds hulp nodig?
Als er problemen optreden die niet in deze tabel zijn opgenomen, ga dan naar Ondersteuning voor informatie over hoe u contact kunt opnemen met het ondersteuningsteam van Intelligent Recommendations.
Zie ook
Foutregistratie instellen
Overzicht van gegevenscontract
Intelligent Recommendations-API-verwijzing
API-statuscodes
Aan de slag: Intelligent Recommendations instellen en uitvoeren met voorbeeldgegevens
Overzicht van implementatie