# バッチ監視ジョブ

> バッチ監視ジョブ - Python APIクライアントを使用して、バッチ対応のデプロイでバッチ監視ジョブの定義とジョブを管理します。

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.623879+00:00` (UTC).

## Primary page

- [バッチ監視ジョブ](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [前提条件](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md#prerequisites): In-page section heading.
- [バッチ監視ジョブの定義](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md#batch-monitoring-job-definitions): In-page section heading.
- [ジョブ定義の一覧表示](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md#list-job-definitions): In-page section heading.
- [ジョブ定義の取得](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md#get-a-job-definition): In-page section heading.
- [ジョブ定義を作成する](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md#create-a-job-definition): In-page section heading.
- [ジョブ定義の更新](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md#update-a-job-definition): In-page section heading.
- [ジョブ定義の実行](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md#run-a-job-definition): In-page section heading.
- [スケジュールに従ってジョブ定義を実行する](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md#run-a-job-definition-on-a-schedule): In-page section heading.
- [ジョブ定義の削除](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md#delete-a-job-definition): In-page section heading.
- [バッチ監視ジョブ](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md#batch-monitoring-jobs): In-page section heading.
- [バッチ監視ジョブの取得](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md#get-a-batch-monitoring-job): In-page section heading.

## Documentation content

[バッチ監視ジョブ](https://docs.datarobot.com/ja/docs/workbench/nxt-console/nxt-predictions/nxt-prediction-jobs.html.md) では、予測データを継続的に監視できます。 このページでは、Python APIクライアントを使用してバッチ監視ジョブとジョブ定義を管理する方法について説明します。

## 前提条件

- 監視ジョブを実行するためのデータと出力の設定（ バッチ予測ジョブ と互換性のある入力および出力設定など）。

## バッチ監視ジョブの定義

バッチ監視ジョブの定義は、バッチ監視ジョブ用に保存された設定です。 定義は、オンデマンドで一度だけ実行することも、スケジュールに従って実行することもできます。 Pythonクライアントは、これらを [BatchMonitoringJobDefinition](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md#datarobot.models.batch_monitoring.BatchMonitoringJobDefinition) を介して公開します。

### ジョブ定義の一覧表示

すべてのバッチ監視ジョブ定義を一覧表示します。 デプロイまたは名前でフィルターすることもできます。

```
import datarobot as dr

# List all definitions
definitions = dr.BatchMonitoringJobDefinition.list()

# Filter by deployment
definitions = dr.BatchMonitoringJobDefinition.list(deployment_id='5c939e08962d741e34f609f0')

# Search by name
definitions = dr.BatchMonitoringJobDefinition.list(search_name='Daily Monitoring') 
```

`offset` や `limit` などのパラメーターについては、 [BatchMonitoringJobDefinition.list](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md#datarobot.models.batch_monitoring.BatchMonitoringJobDefinition.list) を参照してください。

### ジョブ定義の取得

IDを使用して単一のジョブ定義を取得します。

```
import datarobot as dr

definition = dr.BatchMonitoringJobDefinition.get(job_definition_id='550e8400-e29b-41d4-a716-446655440000')
print(definition.name, definition.deployment_id) 
```

### ジョブ定義を作成する

目的の入力、出力、およびデプロイを指定してバッチ監視ジョブの定義を作成します。 ペイロードは [バッチ監視ジョブ作成](https://docs.datarobot.com/ja/docs/workbench/nxt-console/nxt-monitoring/nxt-batch-monitoring.html.md) API（例： `deploymentId` 、 `intakeSettings` 、 `outputSettings` ）と一致します。 `enabled` と `schedule` を設定して、スケジュールに従って実行できます。

```
import datarobot as dr

definition = dr.BatchMonitoringJobDefinition.create(
    deployment_id='5c939e08962d741e34f609f0',
    name='Weekly batch monitoring',
    intake_settings={'type': 'localFile', 'url': 'file:///data/predictions.csv'},
    output_settings={'type': 'localFile', 'path': '/out/monitoring'},
    enabled=False
) 
```

サポートされているすべてのオプション（ `monitoringBatchPrefix` 、 `monitoringColumns` 、 `chunkSize` など）については、 [BatchMonitoringJobDefinition.create](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md#datarobot.models.batch_monitoring.BatchMonitoringJobDefinition.create) および [Batch Monitoring API](https://docs.datarobot.com/ja/docs/workbench/nxt-console/nxt-monitoring/nxt-batch-monitoring.html.md) を参照してください。

### ジョブ定義の更新

既存の定義（名前、スケジュール、有効な状態など）を更新します。

```
import datarobot as dr

definition = dr.BatchMonitoringJobDefinition.get(job_definition_id='550e8400-e29b-41d4-a716-446655440000')
definition.update(name='Daily batch monitoring', enabled=True) 
```

更新可能なフィールドについては、 [BatchMonitoringJobDefinition.update](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md#datarobot.models.batch_monitoring.BatchMonitoringJobDefinition.update) を参照してください。

### ジョブ定義の実行

スケジュールを変更せずに定義を1回実行するには：

```
import datarobot as dr

definition = dr.BatchMonitoringJobDefinition.get(job_definition_id='550e8400-e29b-41d4-a716-446655440000')
job = definition.run_once()
print(job.id, job.status) 
```

### スケジュールに従ってジョブ定義を実行する

設定されたスケジュールがある場合は、そのスケジュールに従って定義の実行を開始します。

```
import datarobot as dr

definition = dr.BatchMonitoringJobDefinition.get(job_definition_id='550e8400-e29b-41d4-a716-446655440000')
definition.run_on_schedule() 
```

### ジョブ定義の削除

バッチ監視ジョブの定義を削除します。 定義に現在実行中のジョブを含めることはできません。

```
import datarobot as dr

definition = dr.BatchMonitoringJobDefinition.get(job_definition_id='550e8400-e29b-41d4-a716-446655440000')
definition.delete() 
```

## バッチ監視ジョブ

バッチ監視ジョブは、（単一の送信または定義からの）1回の実行です。 ジョブのステータスや詳細を取得するには、 [BatchMonitoringJob](https://docs.datarobot.com/ja/docs/api/dev-learning/python/mlops/batch-monitoring.html.md#datarobot.models.batch_monitoring.BatchMonitoringJob) を使用します。

### バッチ監視ジョブの取得

（ `run_once()` で定義を実行した後などに）ステータスや結果を確認するには、IDを指定してジョブを取得します。

```
import datarobot as dr

job = dr.BatchMonitoringJob.get(job_id='660e8400-e29b-41d4-a716-446655440001')
print(job.status, job.deployment_id) 
```