Fehlerprotokolle
Intelligent Recommendations erstellt ein Fehlerprotokoll für jedes Datenobjekt, das der Dienst in Ihrem Azure Data Lake Storage verarbeitet. Das Fehlerprotokoll wird in das Data Lake Storage-Konto zurückgeschrieben. Wenn Sie Probleme mit der Datenkonfiguration haben, lesen Sie diesen Artikel, um die im Protokoll gemeldeten Fehler zu verstehen und zu korrigieren.
Dieser Artikel listet die Arten von Fehlern im Protokoll auf, die der Dienst Intelligent Recommendations findet, was sie bedeuten und gibt Tipps zu ihrer Behebung.
Wenn Fehler korrigiert werden, kommissioniert Intelligent Recommendations die neuen Daten automatisch und verarbeitet die Änderungen während des nächsten periodischen Modellierungszyklus. Um mehr über diesen Prozess zu erfahren, gehen Sie zu Manuelles Auslösen der Modellierung.
Fehlertypen
Verwenden Sie die folgende Tabelle, um die verschiedenen Arten von Fehlern zu verstehen, die von Intelligent Recommendations zurückgegeben werden können.
Einige Fehlertypen führen dazu, dass eine Zeile aus der Verarbeitung herausgenommen wird, während andere Fehlertypen fatal sein können und dazu führen, dass die Verarbeitung in der Pipeline ganz eingestellt wird.
Bei Fehlern, die dazu führen, dass die Zeile aus der Verarbeitung herausfällt, wenn sie in den Eingabedaten weit verbreitet sind, kann dies zu einer schlechten Produktqualität oder sogar zu leeren Ergebnissen führen.
| Fehlertyp | Beschreibung | Vorgeschlagene Lösung |
|---|---|---|
| AttributeValueNotAllowed | Ein Attribut verwendet einen reservierten oder unzulässigen Wert. | Der Wert „0“ ist im System reserviert. Wenn möglich, ändern Sie den Wert für dieses Attribut. Weitere Informationen finden Sie unter Katalogdaten Entitäten. |
| DataTypeMismatch | Das Format eines angegebenen Datentyps ist falsch. | Überprüfen Sie Ihre Formatierung sorgfältig und stellen Sie sicher, dass weder in der model.json noch im Data Contract unzulässige Zeichen oder Leerzeichen enthalten sind. Weitere Informationen zur Formatierung finden Sie in unseren Richtlinien zur Formatierung von Datenverträgen. |
| EmptyMandatoryAttribute | Eines der obligatorischen Attribute in einer Zeile ist leer. | Füllen Sie die fehlenden Daten aus. |
| InvalidGuidIdFormat | Wenn das System so festgelegt ist, dass es mit ItemID GUID-Typen arbeitet, sollten alle IDs GUIDs sein. | Achten Sie darauf, dass der ItemID-Typ in allen Zeilen konsistent ist. |
| InvalidIdFormat | Wenn das System so festgelegt ist, dass es mit alphanumerischen (16) ItemID-Typen arbeitet, sollten alle IDs alphanumerisch (16) sein. | Achten Sie darauf, dass der ItemID-Typ in allen Zeilen konsistent ist. |
| ImageContentIsEmpty | Das heruntergeladene Bild ist leer. | Prüfen Sie die Bild-URL. |
| ImageDownloadFailed | Bilder müssen sich auf Data Lake Storage befinden und durch Authentifizierung geschützt sein (nicht anonymer Zugriff). | Prüfen Sie die Bild-URL. |
| ImageMalwareDetected | Der Malware-Scan hat ein Problem mit dem Bild entdeckt. | Prüfen Sie die Bild-URL. |
| ImageNotFound | Das Bild wurde unter der angegebenen URL nicht gefunden. | Prüfen Sie die Bild-URL. |
| ImageSizeLargerThanAllowed | Das Bild ist größer als die maximal zugelassene Größe. | Prüfen Sie die Bild-URL. |
| ImageUnexpectedContentType (unerwarteter Inhaltstyp) | Die Bild-URL enthält einen unerwarteten Typ von Inhalt. | Prüfen Sie die Bild-URL. |
| MalwareDetected | Überprüfen Sie die Bilddateien. Sie können infiziert sein. | Prüfen Sie die Bild-URL. |
| InvalidListName | Stellen Sie sicher, dass der Listenname mit der Dokumentation übereinstimmt. | Weitere Informationen finden Sie unter Empfehlungen Enrichment Daten Entitäten. |
| InvalidDateFormat | In der ItemsAndVariants-Eingabe hat das Veröffentlichungsdatum nicht das unterstützte Datum-Uhrzeit-Format yyyy-MM-ddTHH:mm:ss.fffZ. |
Bestätigen Sie, dass Ihr Datum-Uhrzeit-Format den Anforderungen in unserem Datenvertragsschema entspricht oder lassen Sie das Veröffentlichungsdatum leer. |
| InvalidListAvailabilityRange | Das Startdatum sollte vor dem Enddatum liegen, und beide sollten nicht leer sein. | Überprüfen Sie die Daten der Verfügbarkeiten. Weitere Informationen finden Sie unter Katalogdaten Entitäten. |
| UniqueAttributeCountExceedsThreshold | Einige Attribute sind in Bezug auf eindeutige Werte begrenzt. Dieser Fehler bedeutet, dass der Dienst „Intelligent Recommendations“ eine Datengröße erreicht hat, die die unterstützten Grenzen überschreitet. | Wenn dieser Fehler auftritt und Sie das Problem nicht beheben können, gehen Sie zu Support. |
| CsvInvalidFormat | Die Entitäten der Eingabedaten haben möglicherweise das falsche CSV-Format. | Die Fehlerprotokolldatei zeigt dem Client den Ort des Fehlers und weitere Details zum Fehler an. Weitere Informationen finden Sie in den Richtlinien zum Datenvertragsdatenformat. |
| MissingAttribute | Eine angegebene Entität enthält nicht alle erforderlichen Attribute. | Weitere Informationen zu den erforderlichen Attributen bestimmter Entitäten finden Sie in der Übersicht über Datenverträge. |
| MandatoryInputIsMisssing | Die Datei model.json fehlt. | Vergewissern Sie sich noch einmal, dass Sie Ihre model.json-Dateien korrekt in Ihr Speicherkonto unter dem ir_root-Ordner hochgeladen haben. Überprüfen Sie zweitens, ob die Verbindungszeichenfolge der Modellierungsressourcen auf den Ordner mit der Datei model.json verweist. Wenn Ihre model.json Datei geändert wurde, defekt ist oder fehlt, können Sie eine neue model.json Datei aus dem Datenvertrag herunterladen und in Ihren ir_root Ordner einfügen. |
| MulitpleFilterTypes | Reco_ItemAndVariantFilters enthält einen Filternamen mit mehr als einem Filtertyp(en). | Überprüfen Sie den Datenvertrag und vergewissern Sie sich, dass alle Werte, die sich auf einen bestimmten FilterName beziehen, alle denselben FilterType haben. Weitere Informationen finden Sie in unseren Richtlinien zu Element- und Variantenfiltern. |
| NonNumericFilterValue | Numerische Filter gehen davon aus, dass alle Werte numerisch sind. | Ändern Sie den Filter auf numerische Daten. |
| TotalLineCountExceedsThreshold | Die Entitäten der Eingabedaten überschreiten derzeit den Schwellenwert für die Zeilenzahl. | Der Service hat einen Standardschwellenwert für die Anzahl der eindeutigen Werte und Kombinationen für bestimmte Entitäten und Werte. Überprüfen Sie die Protokolldateien auf Fehler und befolgen Sie die Richtlinien zur Formatierung von Datenverträgen, um die richtigen Schwellenwerte für jede Entität zu ermitteln. |
| UnexpectedColumnCount | Sie fehlen entweder oder haben mehr Spalten, als laut Datenvertrag zulässig. Einige Spalten haben optionale Werte und können leer gelassen werden, aber alle Spalten müssen vorhanden sein, damit der Dienst korrekt funktioniert. | Für nicht obligatorische Spalten oder nicht verfügbare Daten, lassen Sie die Spalte leer. Entfernen Sie keine Spalten. Es sollten genau 12 Spalten im Eingabeschema vorhanden sein. Unsachgemäß escapete Strings können Kommas enthalten und die Spaltenzählung unterbrechen. Bearbeiten Sie die model.json-Datei nicht, da dies Ihren Datenvertrag brechen könnte. Wenn Ihre model.json-Datei geändert wurde oder kaputt ist, können Sie eine neue model.json-Datei aus dem Datenvertrag herunterladen. |
| UniqueAttributeCountExceedsThreshold | Die Entitäten der Eingabedaten überschreiten derzeit den Schwellenwert für die Anzahl der eindeutigen Werte/Kombinationen. | Der Service hat einen Standardschwellenwert für die Anzahl der eindeutigen Werte und Kombinationen für bestimmte Entitäten und Werte. Überprüfen Sie die Protokolldateien auf Fehler und befolgen Sie die Richtlinien zur Formatierung von Datenverträgen, um die richtigen Schwellenwerte für jede Entität zu ermitteln. |
| UnsupportedFilterType | Der Dienst vermutet, dass Sie einen nicht unterstützten Filtertyp verwenden. | Vergewissern Sie sich, dass der Filtertyp einer der in der Dokumentation unterstützten Werte ist. Katalog Daten Entitäten bietet weitere Informationen. |
| DistinctValueViolation | Die Datei ItemsAndVariants.csv enthält doppelte Varianten-IDs. Prüfen Sie die Protokolle auf die Element-Varianten-IDs mit Duplikaten. | Wenn im Datenvertrag Duplikate identifiziert werden, stoppt der Dienst die Verarbeitung der betreffenden Entität, sodass das Szenario, das diese Entität verwendet, nicht verarbeitet wird. Dieser Fehler wird je nach Datenmenge innerhalb der ersten paar Minuten oder innerhalb einer Stunde ausgelöst. Um dies zu beheben, entfernen Sie alle Duplikate und starten Sie den Modellierungszyklus neu. |
| DistinctValueViolation | Die Datei Interactions.csv enthält zwei verschiedene Master-Elemente mit der gleichen Varianten-ID. Prüfen Sie die Protokolle auf die Element-IDs, die dieselbe Varianten-ID haben. | Wenn im Datenvertrag Duplikate identifiziert werden, stoppt der Dienst die Verarbeitung der betreffenden Entität, sodass das Szenario, das diese Entität verwendet, nicht verarbeitet wird. Dieser Fehler wird je nach Datenmenge innerhalb der ersten paar Minuten oder innerhalb einer Stunde ausgelöst. Um dies zu beheben, entfernen Sie alle Duplikate und starten Sie den Modellierungszyklus neu. |
| UniqueAttributesCombinationExceedsThreshold | Es gibt eine Kombination von Eingabedaten, die ihren Grenzwert überschritten hat. Zum Beispiel: ItemId, variantId eindeutige Anzahl Querlimit. | Überprüfen Sie die Log-Dateien, um zu sehen, wo der Fehler auftritt, und folgen Sie den Richtlinien zur Formatierung von Datenverträgen, um die richtigen Schwellenwerte für jede Entität zu ermitteln. |
| MaxUniqueAttributeCountPerItemExceedsThreshold | Eine eingegebene Datenkombination hat einen Grenzwert überschritten, der pro Produkt gilt. Beispiel: Die Anzahl der verschiedenen Bilder pro Element überschreitet den Grenzwert. | Überprüfen Sie die Log-Dateien, um zu sehen, wo der Fehler auftritt, und folgen Sie den Richtlinien zur Formatierung von Datenverträgen, um die richtigen Schwellenwerte für jede Entität zu ermitteln. |
| Internal | Allgemeiner Fehler; jeder andere als die aufgelisteten Fehler, der nicht identifiziert werden konnte. | Wenn dieser Fehler auftritt und Sie das Problem nicht lösen können, wenden Sie sich an unser Team. |
Beispiel einer Protokolldatei
Hier sehen Sie ein Beispiel für eine Protokolldatei. Die Antwort enthält die folgenden Abschnitte:
- TotalRecordCount: Die Gesamtzahl der korrekt verarbeiteten Zeilen.
- TotalDroppedRecords: Die Gesamtzahl der Zeilen, die aufgrund von Problemen mit der Datenkonfiguration gelöscht wurden.
- Fehler: Die Arten der entdeckten Fehler, gruppiert in Kategorien. Jeder Fehlertyp enthält die Gesamtzahl der Zeilen und ein Beispiel für die falsch formatierten Daten.
Im angegebenen Beispiel werden Sie feststellen, dass zwei Arten von Fehlern zurückgegeben werden. Der erste Fehler „EmptyMandatoryAttribute“ zeigt an, dass eine ItemId mit einer leeren Zeichenfolge vorhanden ist. Der zweite Fehler „InvalidIdFormat“ verweist auf ein ungültiges Format für ItemIds und Beispiele dafür, welche ItemIds falsch konfiguriert sind.
{
"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"
]
}
]
}
Brauchen Sie immer noch Hilfe?
Wenn Probleme auftreten, die nicht in dieser Tabelle enthalten sind, finden Sie unter Support Informationen darüber, wie Sie das Supportteam von Intelligent Recommendations erreichen.
Siehe auch
Fehlerprotokollierung einrichten
Übersicht über den Datenvertrag
Referenz der API für Intelligent Recommendations
API-Statuscodes
Schnellstarthandbuch: Intelligent Recommendations mit Beispieldaten festlegen und ausführen
Übersicht über die Bereitstellung