# Run and schedule jobs
URL: https://docs.datarobot.com/en/docs/workbench/nxt-registry/nxt-jobs-workshop/nxt-run-custom-jobs.html

> How to run and schedule custom jobs in the jobs workshop.

# Run and schedule jobs

After you assemble a custom job with the required environment and files, you can run the job, schedule a run, or both. In the Registry, on the Jobs tab, click the job you want to run in the table. There are two methods for scheduling jobs, depending on the type of job:

- For generic, retraining, and notification jobs .
- For hosted metric jobs .

## Run and schedule jobs with standard settings

For generic, retraining, and notification jobs, the run options are in the upper-right corner of the custom job panel:

| Option | Description |
| --- | --- |
| Schedule | Opens the Schedule run section. Select either Simple schedule, entering frequency and a time (in UTC) to run the custom job. Or, click Advanced schedule to provide a more precise run schedule. Once you've configured a schedule, click Set schedule. |
| Run | Starts a custom job run immediately and opens the run on the Runs tab, where you can view custom job run information. |

## Run and schedule hosted metric jobs

For hosted custom metric jobs created on the Assemble tab or added from the gallery, the run options are governed by Connected deployments, alongside options to edit or delete the connected deployment itself:

| Option | Description |
| --- | --- |
| Schedule | Opens the Schedule run dialog box. Select either Simple schedule, entering frequency and a time (in UTC) to run the custom job. Or, click Advanced schedule to provide a more precise run schedule. Once you've configured a schedule, click Set schedule (or Update schedule). If a schedule is configured, you can click Turn off schedule to disable it. |
| Test | Starts a custom job test run. Navigate to the Runs tab to view custom job run information. |

To access more options for a deployment on the Connected deployments panel, click the Actions menu located next to the deployment name:

| Option | Description |
| --- | --- |
| Run | Starts a custom job run. This run reports metric data to the deployment. Navigate to the Runs tab to view custom job run information. |
| Test run | Starts a custom job test run (with the DRY_RUN runtime parameter set to 1). This run does not report metric data to the deployment. Navigate to the Runs tab to view custom job run information. |
| View runs | Opens the Runs tab filtered on the current custom metric ID, where you can view custom job run information. |
| Edit schedule | Opens the Schedule run dialog box. Select either Simple schedule, entering frequency and a time (in UTC) to run the custom job. Or, click Advanced schedule to provide a more precise run schedule. Once you've configured a schedule, click Set schedule (or Update schedule). If a schedule is configured, you can click Turn off schedule to disable it. |
| Edit | Opens the connected deployment details, where you can edit or configure the runtime parameters, schedule, or baseline. |
| Delete | Deletes the connected deployment. In the Delete Connected Deployment dialog box, click Delete again to confirm deletion. |

## View and manage job runs

When you run a custom job (or a scheduled run completes), the run information is recorded, allowing you to review the run information and view and manage run logs. This is helpful for diagnosing issues when a run fails.

In the Registry, on the Jobs > Runs tab, locate and click the run you want to view from the list. To locate a specific run, you can filter the runs list by the available Runtime Parameters or Search the runs list:

Once you locate the run, review the Run results and Run description (and Runtime parameters if provided):

| Field | Description |
| --- | --- |
| Run results | The Status, Duration, and Logs of the selected job run. The Logs section provides the following options: View log: Opens the Console Log window in DataRobot where you can click Search, Refresh, and Download Log. You can view logs while the run is still in progress, clicking Refresh to keep them up-to-date. Download log: Downloads the log as a .txt file. Delete log: Permanently deletes the log for a run, typically used if you accidentally logged sensitive information. |
| Run description | A description of the job run. To edit the description, click the edit icon next to the field contents. |
| Run details | The Run ID for the current run. You can click the copy icon to save it to your clipboard. |
| Resources | The resource settings, Resource bundle and Network access for the current run, configured when you create a custom job. |
| Runtime parameters | If you uploaded a metadata.yaml file and configured runtime parameters during the custom jobs assembly process, this table displays the key values. |
| Key values | The non-runtime parameter key values, Tags, Metrics, Training parameters, and Artifacts. |
| Files | The files included in the job assembled for the current run. |

> [!NOTE] Refresh the run details
> You can click Refresh to load the job details again and check for new information.

> [!WARNING] Do not log sensitive information
> Do not log sensitive information in your custom job code. The logs for a custom job run contain any information logged in that job's code. If you log sensitive information, delete those logs.

---
