制約のスキーマ (constraints.json ファイル)

constraints.json ファイルは、データセットが満たす必要がある制約を示すために使用されます。Amazon SageMaker Model Monitor コンテナは constraints.json ファイルを使用して、データセットを評価できます。ビルド済みコンテナは、ベースラインデータセットの constraints.json ファイルを自動的に生成する機能を提供します。独自のコンテナを持ち込む場合は、同様の機能を提供することも、他の方法で constraints.json ファイルを作成することもできます。以下は、ビルド済みコンテナが使用する制約ファイルのスキーマです。独自のコンテナを取り込む場合、同じ形式を採用するか、必要に応じてその機能を拡張できます。

{
  "version" : 0,

    "features": [
      {
          "name": "string",
          "inferred_type": "Integral" | "Fractional" | 
                    | "String" | "Unknown",
          "completeness": number, # denotes observed non-null value percentage
          "num_constraints" : {
            "is_non_negative": boolean,
          },
          "string_constraints" : {
             "domains": [
                  "list of",
                  "observed values",
                  "for small cardinality"
              ],
           },
           "monitoringConfigOverrides" : {
          
           }#monitoringConfigOverrides
      }#feature
  ]#features
  
  # options to control monitoring for this feature with monitoring jobs
  # See the following table for notes on what each constraint is doing.
"monitoring_config": {
    "evaluate_constraints": "Enabled",
    "emit_metrics": "Enabled",
    "datatype_check_threshold": 0.1,
    "domain_content_threshold": 0.1,
    "distribution_constraints": {
        "perform_comparison": "Enabled",
        "comparison_threshold": 0.1,
        "comparison_method": "Simple"||"Robust"
    }
}}#schema

制約のモニタリング
制約事項	説明
evaluate_constraints	Enabled の場合、分析中の現在のデータセットが、ベースラインとして採用された constraints.json ファイルに指定されている制約を満たしているかどうかを評価します。 有効な値: Enabled または Disabled デフォルト: Enabled
emit_metrics	とEnabled、 CloudWatch ファイルに含まれるデータのメトリクスを出力します。 有効な値: Enabled または Disabled デフォルト: Enabled
datatype_check_threshold	指定されている datatype_check_threshold の値をしきい値が超えると、違反レポートで違反として扱われる障害が発生します。現在の実行のデータ型がベースラインデータセットのデータ型と同じでない場合、このしきい値は、違反としてフラグを付ける必要があるかどうかを評価するために使用されます。 ベースラインステップでは、生成された制約によって、各列の推定データ型が推奨されます。datatype_check_threshold パラメータを微調整すると、違反としてフラグが付けられる際のしきい値を調整できます。 有効な値: 浮動小数点数 デフォルト: 0.1
domain_content_threshold	現在のデータセットの String フィールドの未知の値が、ベースラインデータセットよりも多い場合は、このしきい値を使用して、違反としてフラグを付ける必要があるかどうかを決定できます。 有効な値: 浮動小数点数 デフォルト: 0.1
distribution_constraints	perform_comparison Enabled の場合、このフラグは、ベースラインディストリビューションと現在のデータセットで確認されたディストリビューションの間のディストリビューション比較を実行するようコードに指示します。 有効な値: Enabled または Disabled デフォルト: Enabled
	comparison_threshold しきい値が comparison_threshold に設定されている値を超えると、違反レポートで違反として扱われる障害が発生します。距離は、2 つのディストリビューションの累積ディストリビューション関数間の最大絶対差を得ることによって計算されます。 有効な値: 浮動小数点数 デフォルト: 0.1
	comparison_method linf_simple または linf_robust を計算するかどうか。linf_simple は、2 つのディストリビューションの累積ディストリビューション関数の最大絶対差に基づいています。linf_robust の計算は linf_simple に基づいていますが、サンプルが足りない場合に使用されます。この linf_robust 式は、2 標本コルモゴロフ=スミルノフ検定に基づいています。 有効な値: linf_simple または linf_robust。