Amazon Fraud Detector は、2025 年 11 月 7 日をもって新規顧客に公開されなくなりました。Amazon Fraud Detector と同様の機能については、Amazon SageMaker、AutoGluon、および を参照してください AWS WAF。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # トラブルシューティング 以下のセクションは、Amazon Fraud Detector を使用する際に発生する可能性がある問題のトラブルシューティングに役立ちます。 ## トレーニングデータに関する問題のトラブルシューティング このセクションの情報を使用して、モデルのトレーニング時に Amazon Fraud Detector コンソールの**モデルトレーニング診断**ペインに表示される可能性のある問題の診断と解決に役立ててください。 **モデルトレーニング診断**ペインに表示される問題は、次のように分類されます。問題に対処するための要件は、問題のカテゴリによって異なります。 + ![\[Error icon\]](http://docs.aws.amazon.com/ja_jp/frauddetector/latest/ug/images/Error icon.png) **エラー**- これにより、モデルトレーニングが失敗します。モデルのトレーニングを正常に行うには、この問題に対処する必要があります。 + ![\[Warning icon\]](http://docs.aws.amazon.com/ja_jp/frauddetector/latest/ug/images/Warning icon.png) **警告**- モデルトレーニングは続行しますが、一部の変数がトレーニングプロセスで除外される可能性があります。このセクションで関連するガイダンスを確認して、データセットの品質を向上させましょう。 + ![\[Information icon\]](http://docs.aws.amazon.com/ja_jp/frauddetector/latest/ug/images/Info icon.png) **情報 (info)**- モデルトレーニングには影響を与えず、すべての変数がトレーニングに使用されます。このセクションの関連するガイダンスを確認して、データセットとモデルのパフォーマンスをさらに改善することをお勧めします。 **Topics** + [指定されたデータセットの不安定な不正率](#unstable-fraud-rate) + [不十分なデータ](#insufficient-data) + [異なる EVENT\$1LABEL 値がない](#missing-different-event-label-values) + [EVENT\$1TIMESTAMP 値が欠落しているか正しくない](#missing-incorrect-timestamp-values) + [データが取り込まれない](#data-not-ingested) + [変数が不十分](#insufficient-variables) + [変数タイプが欠落しているか、正しくない](#missing-incorrect-variable-type) + [欠落している変数値](#missing-variable-values) + [一意な変数値が不十分](#insufficient-unique-variable-values) + [変数式が誤っている](#incorrect-variable-expression) + [一意のエンティティが不十分](#insufficient-unique-entities) ### 指定されたデータセットの不安定な不正率 **問題タイプ: エラー** **説明** 特定のデータの不正率が、時間の経過とともに過度に不安定に。不正イベントと正当なイベントが、経時的に一様にサンプリングされていることを確認してください。 **原因** このエラーは、データセット内の不正イベントと正当なイベントが不均等に分散され、異なるタイムスロットから取得された場合に発生します。Amazon Fraud Detector モデルトレーニングプロセスは、EVENT\$1TIMESTAMP に基づいてデータセットのサンプル抽出とパーティショニングを行います 例えば、データセットが過去 6 か月から引き出された不正イベントで構成され、最後の月の正当なイベントのみが含まれる場合、データセットは不安定と見なされます。不安定なデータセットは、モデルのパフォーマンス評価でバイアスを引き起こす可能性があります。 **解決策** 不正イベントデータと正当なイベントデータが同じタイムスロットから提供されるようにし、不正率が時間の経過とともに劇的に変化しないようにします。 ### 不十分なデータ 1. **問題タイプ: エラー** **説明** 不正イベントとしてラベル付けされる行は 50 行未満です。不正イベントと正当なイベントの両方が最小数である 50 を超え、モデルを再トレーニングします。 **原因** このエラーは、データセット中の不正とラベル付けされているイベント数がモデルトレーニングに必要なイベント数よりも少ない場合に発生します。Amazon Fraud Detector では、モデルのトレーニングに少なくとも 50 件の不正イベントが必要です。 **解決策** データセットに少なくとも 50 個の不正イベントが含まれていることを確認してください。必要に応じて、より長い期間をカバーすることで、これを保証できます。 1. **問題タイプ: エラー** **説明** 正当なイベントとしてラベル付けされる行は 50 行未満です。不正イベントと正当なイベントの両方が最小数の \$1threshold を超えていることを確認し、モデルを再トレーニングします。 **原因** このエラーは、データセット中の正当とラベル付けされているイベント数がモデルトレーニングに必要なイベント数よりも少ない場合に発生します。Amazon Fraud Detector では、モデルのトレーニングに少なくとも 50 の正当なイベントが必要です。 **解決策** データセットに最低 50 個の正当なイベントが含まれていることを確認します。必要に応じて、より長い期間をカバーすることで、これを保証できます。 1. **問題タイプ: エラー** **説明** 不正とされる一意のエンティティの数が 100 未満です。パフォーマンスを向上させるために、不正なエンティティの例をさらに含めることを検討してください。 **原因** このエラーは、データセット中にある不正なイベントを持つエンティティの数がモデルトレーニングに必要な数よりも少ない場合に発生します。トランザクション不正インサイト (TFI) モデルでは、不正スペースの最大のカバレッジを確保するために、不正イベントを持つエンティティが少なくとも 100 必要です。すべての不正イベントが少数のエンティティグループによって実行されている場合、モデルは一般化されないことがあります。 **解決策** データセットに不正イベントを持つエンティティが少なくとも 100 含まれていることを確認してください。必要に応じて、より長い期間をカバーすることで、これを保証できます。 1. **問題タイプ: エラー** **説明** 正当とされる一意のエンティティの数が 100 未満です。パフォーマンスを向上させるために、正当なエンティティの例をさらに含めることを検討してください。 **原因** このエラーは、データセット中にある正当なイベントを持つエンティティの数がモデルトレーニングに必要な数よりも少ない場合に発生します。トランザクション不正インサイト (TFI) モデルでは、不正スペースの最大のカバレッジを確保するために、正当なイベントを持つエンティティが少なくとも 100 必要です。すべての正当なイベントが少数のエンティティによって実行された場合、モデルはうまく一般化しない可能性があります。 **解決策** データセットに正当なイベントを持つエンティティが少なくとも 100 含まれていることを確認してください。必要に応じて、より長い期間をカバーすることで、これを保証できます。 1. **問題タイプ: エラー** **説明** データセットに含まれる行が 100 行未満です。データセットの合計に 100 行以上あり、少なくとも 50 行が不正とラベル付けされていることを確認します。 **原因** このエラーは、データセットに含まれるレコードが 100 未満である場合に発生します。Amazon Fraud Detector では、モデルトレーニングのためにデータセット内の少なくとも 100 個のイベント (レコード) からのデータが必要です。 **解決策** データセットに 100 を超えるイベントのデータがあることを確認します。 ### 異なる EVENT\$1LABEL 値がない 1. **問題タイプ: エラー** **説明** EVENT\$1LABEL 列の 1% 以上が NULL であるか、モデル設定 **\$1label\$1values** で定義されている値以外の値である。EVENT\$1LABEL 列の欠落している値が 1% 未満で、その値がモデル設定 **\$1label\$1values** で定義されている値であることを確認します。 **原因** このエラーは、次のいずれかの原因で発生することがあります。 + トレーニングデータを含む CSV ファイル内のレコードの 1% 以上の EVENT\$1LABEL 列に欠落している値があります。 + トレーニングデータを含む CSV ファイル内のレコードの 1% 以上の EVENT\$1LABEL 列の値が、イベントタイプに関連付けられている値とは異なります。 オンライン不正インサイト (OFI) モデルでは、各レコードの EVENT\$1LABEL 列に、イベントタイプに関連付けられている (または、`CreateModelVersion` にマップされている) ラベルのいずれかが入力されている必要があります。 **解決策** このエラーの原因が EVENT\$1LABEL 値が欠落していることにある場合は、それらのレコードに適切なラベルを割り当てるか、データセットからそれらのレコードを削除することを検討してください。このエラーの原因が一部のレコードのラベルが **label\$1values** 含まれていないことにある場合は、EVENT\$1LABEL 列のすべての値をイベントタイプのラベルに追加し、モデル作成で不正または正当な (fraud、legit) にマップされていることを確認してください。 1. **問題タイプ: 情報** **説明** EVENT\$1LABEL 列には、モデル設定 **\$1label\$1values** で定義された値以外の NULL 値またはラベル値が含まれています。これらの矛盾した値は、トレーニングの前に「不正ではない」に変換されました。 **原因** この情報は、次のいずれかが原因で受け取ります。 + トレーニングデータを含む CSV ファイル内のレコードの 1% 未満の EVENT\$1LABEL 列に欠落している値があります。 + トレーニングデータを含む CSV ファイル内のレコードの 1% 未満の EVENT\$1LABEL 列の値が、イベントタイプに関連付けられている値とは異なります。 どちらの場合も、モデルトレーニングは成功します。ただし、ラベル値が欠落またはマッピングされていないイベントのラベル値は、正当なラベル値に変換されます。これを問題と見なす場合は、以下のソリューションに従ってください。 **解決策** データセット中に欠落している EVENT\$1LABEL 値がある場合は、データセットからそれらのレコードを削除することを検討してください。これらの EVENT\$1LABELS に指定された値がマッピングされていない場合は、イベントごとにすべての値が不正または正当 (fraud、legit) にマップされていることを確認してください。 ### EVENT\$1TIMESTAMP 値が欠落しているか正しくない 1. **問題タイプ: エラー** **説明** トレーニングデータセットに、許容される形式に準拠しないタイムスタンプを含む EVENT\$1TIMESTAMP が含まれています。形式が有効な日付/タイムスタンプ形式の 1 つであることを確認します。 **原因** このエラーは、EVENT\$1TIMESTAMP 列に、Amazon Fraud Detector でサポートされている[タイムスタンプ形式](https://docs.aws.amazon.com/frauddetector/latest/ug/online-fraud-insights.html#timestamp-formats)に準拠していない値が含まれている場合に発生します。 **解決策** EVENT\$1TIMESTAMP 列に指定された値が、サポートされている[タイムスタンプ形式](https://docs.aws.amazon.com/frauddetector/latest/ug/online-fraud-insights.html#timestamp-formats)に準拠していることを確認します。EVENT\$1TIMESTAMP 列に欠落している値がある場合は、サポートされているタイムスタンプ形式を使用した値で埋めるか、`none`、`null`、または `missing` の文字列を入力するのではなく、イベントを完全に削除することを検討してください。 1. **問題タイプ: エラー** トレーニングデータセットには、欠落している値がある EVENT\$1TIMESTAMP が含まれています。欠落している値がないことを確認します。 **原因** このエラーは、データセットの EVENT\$1TIMESTAMP 列に欠落している値がある場合に発生します。Amazon Fraud Detector では、データセットの EVENT\$1TIMESTAMP 列に値が必要です。 **解決策** データセットの EVENT\$1TIMESTAMP 列に値があり、それらの値がサポートされている[タイムスタンプ形式](https://docs.aws.amazon.com/frauddetector/latest/ug/online-fraud-insights.html#timestamp-formats)に準拠していることを確認します。EVENT\$1TIMESTAMP 列に欠落している値がある場合は、サポートされているタイムスタンプ形式を使用した値で埋めるか、`none`、`null`、または `missing` のような文字列を入力するのではなく、イベントを完全に削除することを検討してください。 ### データが取り込まれない **問題タイプ: エラー** **説明** トレーニングで取り込まれたイベントが見つかりません。トレーニング設定を確認してください。 **原因** このエラーは、Amazon Fraud Detector で保存されたイベントデータを含むモデルを作成しているが、モデルのトレーニングを開始する前にデータセットを Amazon Fraud Detector にインポートしなかった場合に発生します。 **解決策** `SendEvent` API オペレーション、`CreateBatchImportJob` API オペレーション、または Amazon Fraud Detector コンソールのバッチインポート機能を使用して、最初にイベントデータをインポートし、次にモデルをトレーニングします。詳細については、「[ストアドイベントデータセット](https://docs.aws.amazon.com/frauddetector/latest/ug/storing-event-data-afd.html)」を参照してください。 **注記** データのインポートが完了してから 10 分待ってから、データを使用してモデルをトレーニングすることをお勧めします。 Amazon Fraud Detector コンソールを使用して、イベントタイプごとに既に保存されているイベントの数を確認できます。詳細については、「[ストアドイベントのメトリクスの表示](https://docs.aws.amazon.com/frauddetector/latest/ug/storing-event-data-afd.html#view-stored-event-metrics)」を参照してください。 ### 変数が不十分 **問題タイプ: エラー** **説明** データセットには、トレーニングに適した変数が少なくとも 2 つ含まれている必要があります。 **原因** このエラーは、データセットに含まれる、モデルトレーニングに適している変数が 2 つ未満の場合に発生します。Amazon Fraud Detector は、すべての検証に合格した場合にのみ、モデルトレーニングに適した変数と見なします。変数が検証に失敗すると、モデルトレーニングでは除外され、**モデルトレーニング診断**にメッセージが表示されます。 **解決策** データセットに少なくとも 2 つの変数が値で入力され、すべてのデータ検証に合格していることを確認します。列ヘッダーを指定したイベントメタデータ行 (EVENT\$1TIMESTAMP、EVENT\$1ID、ENTITY\$1ID、EVENT\$1LABEL など) は変数と見なされないことに注意してください。 ### 変数タイプが欠落しているか、正しくない **問題の種類: 警告** **説明** **\$1variable\$1name** に期待されるデータ型は、NUMERIC です。データセット中の **\$1variable\$1name** を確認して更新し、モデルを再トレーニングします。 **原因** この警告は、変数が NUMERIC 変数として定義されているが、データセットに NUMERIC に変換できない値がある場合に表示されます。その結果、その変数はモデルトレーニングでは除外されます。 **解決策** NUMERIC 変数として保持する場合は、指定する値が浮動小数点数に変換できることを確認します。変数に欠落している値が含まれている場合は、`nonene`、`null`、または `missing` などの文字列を入力しないでください。変数に数値以外の値が含まれている場合は、CATEGORICAL または FREE\$1FORM\$1TEXT 変数タイプとして再作成します。 ### 欠落している変数値 **問題の種類: 警告** **説明** **\$1threshold** の値より大きい **\$1variable\$1name** がトレーニングデータセットから欠落しています。パフォーマンスを向上させるために、データセット中の **\$1variable\$1name** を変更して再トレーニングすることを検討してください。 **原因** この警告は、欠落している値が多すぎるために指定された変数が削除されている場合に表示されます。Amazon Fraud Detector では、変数の値の欠落が許可されています。ただし、1 つの変数に欠落している値が多すぎると、その変数はモデルにほとんど寄与せず、その変数はモデルトレーニングで削除されます。 **解決策** まず、これらの欠落している値がデータの収集と準備のミスによるものではないことを確認します。それらが間違いであれば、モデルトレーニングからそれらを削除することを検討できます。ただし、これらの欠落している値に価値があると考え、その変数を保持したい場合は、モデルトレーニングとリアルタイム推論の両方で、欠落している値を定数で手動で入力できます。 ### 一意な変数値が不十分 **問題の種類: 警告** **説明** **\$1variable\$1name** の一意の値の数が 100 未満です。データセット中の **\$1variable\$1name** を確認して更新し、モデルを再トレーニングします。 **原因** この警告は、指定された変数の一意の値の数が 100 より小さい場合に表示されます。しきい値は、変数のタイプによって異なります。一意の値が非常に少ないため、データセットがその変数の特徴空間をカバーするのに十分なほど一般的ではないというリスクがあります。その結果、モデルがリアルタイム予測ではうまく一般化されないことがあります。 **解決策** まず、変数分布が実際のビジネストラフィックを代表していることを確認します。次に、個別に `first_name` や `last_name` を使用する代わりに `full_customer_name` を使用するなど、カーディナリティの高い、より詳細にトレーニングされた変数を採用するか、変数タイプを CATEGORICAL に変更して、カーディナリティを低くすることができます。 ### 変数式が誤っている 1. **問題タイプ: 情報** **説明** 50% を超える**\$1email\$1variable\$1name** 値が、予想される正規表現 http://emailregex.com と一致しません。パフォーマンスを向上させるために、データセット中の **\$1email\$1variable\$1name** を変更して再トレーニングすることを検討してください。 **原因** この情報は、データセット内の 50% を超えるレコードに通常の E メール式に準拠しない E メール値が含まれているため、検証に失敗した場合に表示されます。 **解決策** E メール変数の値を正規表現に準拠するようにフォーマットします。E メールの値が欠落している場合は、`none`、`null`、または `missing` のような文字列で入力するのではなく、空のままにすることをお勧めします。 1. **問題タイプ: 情報** **説明** 50% 超の **\$1IP\$1variable\$1name** 値が、IPv4 または IPv6 アドレス https://digitalfortress.tech/tricks/top-15-commonly-used-regex/ の正規表現と一致しません。パフォーマンスを向上させるために、データセット中の **\$1IP\$1variable\$1name** を変更して再トレーニングすることを検討してください。 **原因** この情報は、データセット内の 50% を超えるレコードに通常の IP 式に準拠しない IP 値が含まれているため、検証に失敗した場合に表示されます。 **解決策** IP 値を正規表現に準拠するようにフォーマットします。IP 値が欠落している場合は、`none`、`null`、または `missing` のような文字列で入力するのではなく、空のままにすることをお勧めします。 1. **問題タイプ: 情報** **説明** 50% 超の **\$1phone\$1variable\$1name** 値が、基本的な電話の正規表現 /\$1pattern/ と一致しません。パフォーマンスを向上させるために、データセット中の **\$1phone\$1variable\$1name** を変更して再トレーニングすることを検討してください。 **原因** この情報は、データセット内の 50% を超えるレコードに通常の電話番号式に準拠しない電話番号が含まれているため、検証に失敗した場合に表示されます。 **解決策** 電話番号を正規表現に準拠するようにフォーマットします。電話番号が欠落している場合は、`none`、`null`、または `missing` のような文字列で入力するのではなく、空のままにすることをお勧めします。 ### 一意のエンティティが不十分 **問題タイプ: 情報** **説明** 一意のエンティティの数が 1500 未満です。パフォーマンスを向上させるために、より多くのデータを含めることを検討してください。 **原因** この情報は、データセットの一意のエンティティ数が推奨数よりも少ない場合に表示されます。トランザクション不正インサイト (TFI) モデルは、時系列集計と汎用トランザクション機能の両方を使用して、最高のパフォーマンスを提供します。データセットの一意のエンティティが少なすぎる場合、IP\$1ADDRESS、EMAIL\$1ADDRESS などの汎用データのほとんどは一意の値を持たない可能性があります。すると、データセットがその変数の特徴空間をカバーするのに十分なほど一般的ではないというリスクもあります。その結果、新しいエンティティからのトランザクションでは、モデルがうまく一般化されない可能性があります。 **解決策** より多くのエンティティを含めます。必要に応じて、トレーニングデータの時間範囲を拡張します。