# 監視ジョブAPI > 監視ジョブAPI - バッチ監視APIを使用し、監視ジョブ定義を作成することにより、DataRobotは、DataRobotの外部で特徴量データと予測を実行および保存しているデプロイを監視できます。 This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context. Companion generated at `2026-07-15T05:55:44.978769+00:00` (UTC). ## Primary page - [監視ジョブAPI](https://docs.datarobot.com/ja/docs/classic-ui/predictions/batch/pred-monitoring-jobs/api-monitoring-jobs.html.md): Full documentation for this topic (Markdown sidecar). ## Sections on this page - [ジョブ定義とバッチジョブルートの監視](https://docs.datarobot.com/ja/docs/classic-ui/predictions/batch/pred-monitoring-jobs/api-monitoring-jobs.html.md#_1): In-page section heading. - [batchMonitoringJobDefinitionsエンドポイント](https://docs.datarobot.com/ja/docs/classic-ui/predictions/batch/pred-monitoring-jobs/api-monitoring-jobs.html.md#batchmonitoringjobdefinitions): In-page section heading. - [batchJobsエンドポイント](https://docs.datarobot.com/ja/docs/classic-ui/predictions/batch/pred-monitoring-jobs/api-monitoring-jobs.html.md#batchjobs): In-page section heading. - [監視ジョブプロパティ](https://docs.datarobot.com/ja/docs/classic-ui/predictions/batch/pred-monitoring-jobs/api-monitoring-jobs.html.md#_2): In-page section heading. - [monitoringColumnsプロパティ](https://docs.datarobot.com/ja/docs/classic-ui/predictions/batch/pred-monitoring-jobs/api-monitoring-jobs.html.md#monitoringcolumns): In-page section heading. - [monitoringOutputSettingsプロパティ](https://docs.datarobot.com/ja/docs/classic-ui/predictions/batch/pred-monitoring-jobs/api-monitoring-jobs.html.md#monitoringoutputsettings): In-page section heading. - [monitoringAggregationプロパティ](https://docs.datarobot.com/ja/docs/classic-ui/predictions/batch/pred-monitoring-jobs/api-monitoring-jobs.html.md#monitoringaggregation): In-page section heading. - [ジョブサンプルの監視](https://docs.datarobot.com/ja/docs/classic-ui/predictions/batch/pred-monitoring-jobs/api-monitoring-jobs.html.md#_3): In-page section heading. ## Documentation content この連携により、 `batchMonitoringJobDefinitions` および `batchJobs` エンドポイントを持つバッチ監視APIが作成され、監視ジョブを作成できるようになります。 監視ジョブの [取り込み](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/intake-options.html.md) および [出力](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-options.html.md) 設定は、バッチ予測ジョブと同じオプションを使用して設定されます。 次のルート、プロパティ、および例を使用して、監視ジョブを作成します。 > [!NOTE] 外部モデルと監視ジョブのサービス正常性に関する情報 > サービス正常性の情報は、 [エージェントによって監視される](https://docs.datarobot.com/ja/docs/classic-ui/mlops/deployment/mlops-agent/monitoring-agent/index.html.md) 外部のデプロイでは入手できません。また、 [予測監視ジョブ](https://docs.datarobot.com/ja/docs/classic-ui/predictions/batch/pred-monitoring-jobs/index.html.md) を介して予測がアップロードされるデプロイでも入手できません。 > [!NOTE] 時系列モデルに関する注意事項 > 時系列モデルによる予測の監視は、監視ジョブではサポートされていません。 ## ジョブ定義とバッチジョブルートの監視 ### batchMonitoringJobDefinitions エンドポイント 以下のバッチ監視ジョブ定義で操作を実行するためのエンドポイントにアクセスします。 | 操作とエンドポイント | 説明 | | --- | --- | | POST /api/v2/batchMonitoringJobDefinitions/ | ペイロードがある場合の監視ジョブ定義を作成します。 | | GET /api/v2/batchMonitoringJobDefinitions/ | すべての監視ジョブ定義を一覧表示します。 | | GET /api/v2/batchMonitoringJobDefinitions/{monitoringJobDefinitionId}/ | 指定された監視ジョブ定義を取得します。 | | DELETE /api/v2/batchMonitoringJobDefinitions/{monitoringJobDefinitionId}/ | 指定された監視ジョブ定義を削除します。 | | PATCH /api/v2/batchMonitoringJobDefinitions/{monitoringJobDefinitionId}/ | ペイロードがある場合の指定された監視ジョブ定義を更新します。 | ### batchJobs エンドポイント 以下のバッチジョブで操作を実行するためのエンドポイントにアクセスします。 | 操作とエンドポイント | 説明 | | --- | --- | | POST /api/v2/batchJobs/fromJobDefinition/ | monitoringJobDefinitionから監視ジョブを起動（今すぐ実行）します。 ペイロードにはmonitoringJobDefinitionIdが含まれています。 | | GET /api/v2/batchJobs/ | 実行中のジョブ、中止されたジョブ、実行されたジョブなど、監視ジョブの完全な履歴を一覧表示します。 | | GET /api/v2/batchJobs/{monitoringJobId}/ | 特定の監視ジョブを取得します。 | | DELETE /api/v2/batchJobs/{monitoringJobId}/ | 実行中の監視ジョブを中止します。 | ## 監視ジョブプロパティ ### monitoringColumns プロパティ 以下のバッチ監視に使用する列を定義します。 | プロパティ | タイプ | 説明 | | --- | --- | --- | | predictionsColumns | 文字列 | （連続値）予測値を含むデータソースの列。 このフィールドおよび/またはactualsValueColumnを指定する必要があります。 | | predictionsColumns | array | （分類）各予測クラスを含むデータソース内の列。 このフィールドおよび/またはactualsValueColumnを指定する必要があります。 （最大1000項目までサポート） | | associationIdColumn | 文字列 | 予測のための関連付けIDを含むデータソースの列。 | | actualsValueColumn | 文字列 | 実測値を含むデータソース内の列。 このフィールドおよび/またはpredictionsColumnsを指定する必要があります。 | | actualsTimestampColumn | 文字列 | 実測値のタイムスタンプを含むデータソース内の列。 | ### monitoringOutputSettings プロパティ 監視ジョブに特異な、以下の出力設定を設定します。 | プロパティ | タイプ | 説明 | | --- | --- | --- | | uniqueRowIdentifierColumns | array | 各行の一意の識別子として機能するデータソースの列。 これらの列は、各監視ステータスと対応するソース行を関連付けるために、データ送信先にコピーされます。 （最大100項目までサポート） | | monitoredStatusColumn | 文字列 | 各行の監視ステータスを含むデータの送信先の列。 | > [!NOTE] 備考 > 一般的なバッチジョブの出力設定については、 [予測の出力設定](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-options.html.md) のドキュメントを参照してください。 ### monitoringAggregation プロパティ [大規模監視](https://docs.datarobot.com/ja/docs/classic-ui/mlops/deployment/mlops-agent/monitoring-agent/agent-use.html.md#enable-large-scale-monitoring) が有効な外部モデル（つまり、元のデータはDataRobotプラットフォームに保存されていません）でチャレンジャーモデルをサポートするには、元の特徴量データと予測データの小さなサンプルをレポートし、残りのデータを集計形式で送信します。 保持設定を行って、元データがMLOpsライブラリによって集計されることを示し、チャレンジャーモデルのために保持すべき元データの量を定義します。 > [!NOTE] 大規模監視の自動サンプリング > チャレンジャー分析や精度監視で元データの小さなサンプルを自動的にレポートするには、 [外部モデルの大規模監視を有効にする](https://docs.datarobot.com/ja/docs/classic-ui/mlops/deployment/mlops-agent/monitoring-agent/agent-use.html.md#enable-large-scale-monitoring) ときに `MLOPS_STATS_AGGREGATION_AUTO_SAMPLING_PERCENTAGE` を定義します。 | プロパティ | タイプ | 説明 | | --- | --- | --- | | retentionPolicy | 文字列 | ポリシーの定義では、retentionValueがデータセットのサンプル数を表すのか、パーセンテージを表すのかを決定します。 enum: ['samples', 'percentage'] | | retentionValue | 整数 | データの割合またはサンプル数のいずれかで保持するデータ量 | これらのプロパティを定義した場合、元のデータは、MLOpsライブラリによって集計されます。 これは、データが、DataRobotプラットフォームに保存されないことを意味します。 精度監視では、統計情報の集計は、特徴量データと予測データのみをサポートし、実測データはサポートしません。 `actualsValueColumn` または `associationIdColumn` （つまり、実測値が後で提供される）を定義した場合、DataRobotは、データを集計できません。 > [!NOTE] プレビュー：集計を有効にした精度監視 > プレビュー版の機能です。集計を有効にした外部モデルの監視ジョブは、精度の追跡に対応できます。 この機能を有効にすると、保持設定を行い、_かつ_集計を有効にした精度監視のために `actualsValueColumn` を定義する際に、 `predictionsColumns` と `associationIdColumn` も定義する必要があります。 > > デフォルトではオフの機能フラグ ：精度の集計を有効にする ## ジョブサンプルの監視 **例：連続値監視ジョブのペイロード:** ``` { "batchJobType": "monitoring", "deploymentId": "", "intakeSettings": { "type": "jdbc", "dataStoreId": "", "credentialId": "", "table": "lending_club_regression", "schema": "SCORING_CODE_UDF_SCHEMA", "catalog": "SANDBOX" }, "outputSettings": { "type": "jdbc", "dataStoreId": "", "table": "lending_club_regression_out", "catalog": "SANDBOX", "schema": "SCORING_CODE_UDF_SCHEMA", "statementType": "insert", "createTableIfNotExists": true, "credentialId": "", "commitInterval": 10, "whereColumns": [], "updateColumns": [] }, "passthroughColumns": [], "monitoringColumns": { "predictionsColumns": "PREDICTION", "associationIdColumn": "id", "actualsValueColumn": "loan_amnt" }, "monitoringOutputSettings": { "monitoredStatusColumn": "monitored", "uniqueRowIdentifierColumns": ["id"] } "schedule": { "minute": [ 0 ], "hour": [ 17 ], "dayOfWeek": ["*" ], "dayOfMonth": ["*" ], "month": [ "*” ] }, "enabled": true } ``` **例：分類監視ジョブのペイロード:** ``` { "batchJobType": "monitoring", "deploymentId": "", "intakeSettings": { "type": "jdbc", "dataStoreId": "", "credentialId": "", "table": "lending_club_regression", "schema": "SCORING_CODE_UDF_SCHEMA", "catalog": "SANDBOX" }, "outputSettings": { "type": "jdbc", "dataStoreId": "", "table": "lending_club_regression_out", "catalog": "SANDBOX", "schema": "SCORING_CODE_UDF_SCHEMA", "statementType": "insert", "createTableIfNotExists": true, "credentialId": "", "commitInterval": 10, "whereColumns": [], "updateColumns": [] }, "monitoringColumns": { "predictionsColumns": [ { "className": "True", "columnName": "readmitted_True_PREDICTION" }, { "className": "False", "columnName": "readmitted_False_PREDICTION" } ], "associationIdColumn": "id", "actualsValueColumn": "loan_amnt" }, "monitoringOutputSettings": { "uniqueRowIdentifierColumns": ["id"], "monitoredStatusColumn": "monitored" } "schedule": { "minute": [ 0 ], "hour": [ 17 ], "dayOfWeek": ["*" ], "dayOfMonth": ["*" ], "month": [ "*” ] }, "enabled": true } ```