エラー ログ
Intelligent Recommendations は、サービスが Azure Data Lake Storage で処理するデータ オブジェクトごとにエラー ログを作成します。 エラー ログは Data Lake Storage アカウントに書き戻されます。 データ構成に問題がある場合は、この記事を参照して、ログに報告されたエラーとその修正方法を確認してください。
この記事では、Intelligent Recommendations サービスによって検出されたログ内のエラーの種類、それらの意味、およびそれらを解決するためのヒントをリストします。
エラーが修正されると、Intelligent Recommendations は新しいデータを自動的に取得し、次の定期的なモデリング サイクル中に変更を処理します。 このプロセスの詳細については、モデリングの手動トリガー を参照してください。
エラーの種類
次の表を使用して、Intelligent Recommendations によって返される可能性のある様々なタイプのエラーを確認してください。
エラーの種類によっては行が処理から除外されますが、他の種類のエラーは致命的であり、クッキング パイプラインの処理が完全に停止する可能性があります。
行が処理から除外される原因となるエラーの場合、入力データ全体にその行が広まっていると、製品の品質が低下したり、結果が空になったりする可能性があります。
| エラーの種類 | Description | 推奨される解決策 |
|---|---|---|
| AttributeValueNotAllowed | 属性が予約済みまたは不適切な値を使用しています。 | 値 "0" はシステム用に予約されています。 可能であれば、この属性の値を変更します。 詳細については、カタログ データ エンティティ を参照してください。 |
| DataTypeMismatch | 指定したデータ型の形式が正しくありません。 | 現在の書式設定を注意深く確認して、model.json やデータ コントラクトに不適切な文字やスペースがないことを確認してください。 形式に関する詳細は データ コントラクト形式のガイドライン を参照してください。 |
| EmptyMandatoryAttribute | 行の必須属性の 1 つが空です。 | 不足しているデータを入力してください。 |
| InvalidGuidIdFormat | システムが ItemID GUID 型で動作するように設定されている場合、すべての ID は GUID である必要があります。 | ItemID 型をすべての行で一貫性のあるものにします。 |
| InvalidIdFormat | システムが alphanumeric(16) ItemID 型で動作するように設定されている場合、すべての ID は alphanumeric(16) である必要があります。 | ItemID 型をすべての行で一貫性のあるものにします。 |
| ImageContentIsEmpty | ダウンロードした画像が空です。 | 画像の URL を確認してください。 |
| ImageDownloadFailed | 画像は Data Lake Storage 上にあり、認証 (匿名以外のアクセス) で保護されている必要があります。 | 画像の URL を確認してください。 |
| ImageMalwareDetected | マルウェア スキャンでイメージの問題が検出されました。 | 画像の URL を確認してください。 |
| ImageNotFound | 指定された URL で画像が見つかりませんでした。 | 画像の URL を確認してください。 |
| ImageSizeLargerThanAllowed | 画像が許可されている最大サイズを超えています。 | 画像の URL を確認してください。 |
| ImageUnexpectedContentType | 画像の URL に予期しない コンテンツ タイプ が含まれています。 | 画像の URL を確認してください。 |
| MalwareDetected | 画像ファイルを確認してください。 感染している可能性があります。 | 画像の URL を確認してください。 |
| InvalidListName | リスト名がドキュメントと一致していることを確認してください。 | 詳細については、レコメンデーション エンリッチメント データ エンティティ を参照してください。 |
| InvalidDateFormat | ItemsAndVariants 入力で、リリース日がサポートされている日時形式 yyyy-MM-ddTHH:mm:ss.fffZ になっていません。 |
日時形式がデータ コントラクト スキーマの要件と一致していることを確認するか、リリース日を空白のままにしてください。 |
| InvalidListAvailabilityRange | 開始日には終了日より前を指定し、両方とも空白にできません。 | 利用可能な日付を確認してください。 詳細については、カタログ データ エンティティ を参照してください。 |
| UniqueAttributeCountExceedsThreshold | 一部の属性は、一意の値に関して制限されています。 このエラーは、Intelligent Recommendations サービスがサポートされている制限を超えるデータ サイズに達したことを意味します。 | このエラーが発生し、問題を解決できない場合は、サポート を参照してください。 |
| CsvInvalidFormat | 入力データ エンティティの CSV 形式が間違っている可能性があります。 | エラー ログ ファイルは、エラーの場所と詳細をクライアントに示します。 詳細については データ コントラクト データ形式のガイドライン を参照してください。 |
| MissingAttribute | 指定したデータ エンティティは、すべての必須属性を含みません。 | 特定のデータ エンティティの必須属性に関する詳細については、データ コントラクトの概要 を参照してください。 |
| MandatoryInputIsMisssing | model.json ファイルが存在しません。 | ir_root フォルダーの下のストレージ アカウントに model.json ファイルが正しくアップロードされていることを再確認してください。 続いて、モデル化リソースの接続文字列が、model.json ファイルを含むフォルダーを指していることも確認してください。 model.json ファイルで変更、破損、欠落が発生している場合は、データ コントラクトから新しい model.json file ファイル をダウンロードし、ir_root フォルダに追加してください。 |
| MulitpleFilterTypes | Reco_ItemAndVariantFilters は複数のフィルタ タイプを持つフィルター名を含みます。 | データ コントラクトを確認して、特定の FilterName に関連するすべての値が、すべて同じ FilterType を持つことを確認してください。 詳細については、品目とバリアント フィルターのガイドライン を参照してください。 |
| NonNumericFilterValue | 数値フィルターは、すべての値が数値であることを想定しています。 | フィルターを数値データに変更します。 |
| TotalLineCountExceedsThreshold | 現在の入力データ エンティティが、行数のしきい値を超えています。 | このサービスには、特定のデータ エンティティと値の一意の値と組み合わせの数に対する、既定のしきい値があります。 ログ ファイルを確認してエラーの発生場所を確認し、データ コントラクト形式のガイドライン に従って各データ エンティティの適切なしきい値を特定します。 |
| UnexpectedColumnCount | 列がないか、データ コントラクトごとに許可された件数よりも多くの列が存在します。 一部の列にはオプションの値があり、空のままにすることができますが、サービスが正しく機能するには、すべての列が存在する必要があります。 | 必須でない列または使用できないデータの場合は、列を空白のままにします。 列は削除しないでください。 入力スキーマには厳密に 12 列が必要です。 不適切にエスケープされた文字列にはコンマが含まれ、列数が分割する可能性があります。 データ コントラクトを破壊する可能性があるため、model.json ファイルは編集できません。 model.json ファイルが変更または破壊されている場合は、データ コントラクトから新しい model.json ファイル をダウンロードできます。 |
| UniqueAttributeCountExceedsThreshold | 現在の入力データ エンティティが、一意の値/組み合わせの数のしきい値を超えています。 | このサービスには、特定のデータ エンティティと値の一意の値と組み合わせの数に対する、既定のしきい値があります。 ログ ファイルを確認してエラーの発生場所を確認し、データ コントラクト形式のガイドライン に従って各データ エンティティの適切なしきい値を特定します。 |
| UnsupportedFilterType | このサービスは、対応していないフィルター タイプの使用を検出しました。 | フィルター タイプが、ドキュメントに記載された対応している値の 1 つであることを確認してください。詳細は カタログ データ エンティティ を参照してください。 |
| DistinctValueViolation | ItemsAndVariants.csv が重複したバリアント ID を含みます。 重複する品目バリアント ID のログを確認してください。 | データ コントラクトで重複を特定すると場合、サービスは関連するデータ エンティティの処理を停止するため、データ エンティティを使用するシナリオは処理されません。 データの量に応じて、最初の数分間または 1 時間以内に、このエラーをトリガーします。 解決する際は、重複をすべて解消してからモデル化サイクルを再開します。 |
| DistinctValueViolation | Interactions.csv は、同じバリアント ID を持つ 2 つの異なるマスター品目を含みます。 同じバリアント ID を持つ品目 ID のログを確認します。 | データ コントラクトで重複を特定すると場合、サービスは関連するデータ エンティティの処理を停止するため、データ エンティティを使用するシナリオは処理されません。 データの量に応じて、最初の数分間または 1 時間以内に、このエラーをトリガーします。 解決する際は、重複をすべて解消してからモデル化サイクルを再開します。 |
| UniqueAttributesCombinationExceedsThreshold | 入力データの組み合わせで、制限を超えたものがあります。 例: itemId、variantId の一意のカウント クロス制限。 | ログ ファイルを確認してエラーの発生場所を確認し、データ コントラクト形式のガイドライン に従って各データ エンティティの適切なしきい値を特定します。 |
| MaxUniqueAttributeCountPerItemExceedsThreshold | 入力データの組み合わせが、製品ごとに設定された制限値を超えました。 例: アイテムごとの異なる画像の数が制限を超えています。 | ログ ファイルを確認してエラーの発生場所を確認し、データ コントラクト形式のガイドライン に従って各データ エンティティの適切なしきい値を特定します。 |
| Internal | 一般的なエラー; 上記に列挙された以外の特定できないエラー。 | このエラーが発生し、問題を解決できない場合は、担当チームにお問い合わせ ください。 |
ログ ファイルの例
ここに、ログ ファイルの例を示します。 応答には、次のセクションが含まれます:
- TotalRecordCount: 正常に処理された行の総数。
- TotalDroppedRecords: データ構成の問題によりドロップされた行の総数。
- Errors: 検出され、カテゴリにグループ化されたエラーのタイプ。 各エラー タイプには、行の総数と誤って書式設定されたデータのサンプルが含まれます。
以下の例では、2 種類のエラーが返されることがわかります。 最初のエラー "EmptyMandatoryAttribute" は、空の文字列を持つ ItemId が現在残っていることを示しています。 2 番目のエラー "InvalidIdFormat" は、ItemId の無効な形式と、ItemId が正しく構成されていない例を示しています。
{
"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"
]
}
]
}
まだ問題が解決しませんか？
この表に記載されていない問題が発生した場合は、サポート で情報を参照し、Intelligent Recommendations サポート チームに連絡してください。
参照
エラー ログの設定
データ コントラクトの概要
Intelligent Recommendations API リファレンス
API ステータス コード
クイック スタート ガイド: サンプル データを使用した Intelligent Recommendations の設定と実行
展開の概要