Skip to content

On-premise users: click in-app to access the full platform documentation for your version of DataRobot.

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. The run options are in the upper-right corner of the custom job panel:

Option Description
Run Starts a custom job run immediately and opens the run on the Runs tab, where you can view custom job run information.
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.

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 and 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
  • Run ID: The ID for the current run. You can click the copy icon () to save it to your clipboard.
  • Resources: The resource settings (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-value pairs.
  • Files: The files included in the job assembled for the current run.

Refresh the run details

You can click Refresh to load the job details again and check for new information.

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.


Updated December 7, 2023
Back to top