C3 AI Documentation Home

The Cron Jobs Dashboard in C3 AI Studio

The Cron Jobs Dashboard is a visual interface for creating and managing cron jobs in a C3 AI application. A cron job is a way to schedule and perform a recurring task in your application. Each entry in the dashboard corresponds to a CronJob.

Cron jobs handle scheduled asynchronous processes in your C3 AI application. Queues handle asynchronous code execution (for example, cron jobs, batch jobs, or data processing operations). For more information on job queues, see Monitor and Manage Queues.

The dashboard interface

The Cron Jobs Dashboard page consists of two main parts:

Header card

The header section contains the following information about the list:

  • Job counts: A numerical overview of all listed jobs, using the following categories:

    • Active jobs
    • Inactive jobs
    • Total Jobs

  • Queue Statistics: A more-detailed numerical breakdown of active jobs, using the following categories:

    • Disabled
    • Pending
    • Pending Actions
    • Initial
    • Awaiting Compute
    • Computing Entries
    • Computing Actions
    • Failed

Cron jobs list

The C3 Agentic AI Platform uses cron jobs to schedule maintenance, data management, and operational tasks in your cluster. As a result, Cron Jobs Dashboard lists default cron jobs along with any jobs created by you or another application user. Learn about these jobs in the "Default cron jobs in C3 AI Studio" section of Default Cron Jobs.

The jobs list shows the following information:

  • Job Name: A name or unique label.
  • Active: The activity status. This column shows one of two icons:
    • A filled green checkmark indicates an active job that runs on a schedule.
    • A filled gray pause (two vertically oriented bars) shows an inactive job.
  • Computing: The computing status. This indicates whether any Actions are currently being computed for the job.
  • Type & Action: The job's C3 AI Type and action (an Action is a method on a C3 AI Type). This column also shows any inputs for the job action. Access input definitions by selecting the magnifying glass icon next to the word Input in this column.
  • Schedule: The job's schedule, shown as a human-readable string and its cron script equivalent.
  • Last Run: The job's last run date and completion status. If the column does not show a date, select refresh icon (two arrows circling each other) to compute one.
  • Next Run: The job's next-scheduled run. If the column does not show a date, select refresh icon (two arrows circling each other) to compute one.
  • Created By: The user or system process that created the job.
  • Actions: Additional actions you can perform on a listed job. These actions are:
    • Run now: Start the job immediately. This is disabled for inactive jobs
    • Pause or resume: Temporarily halt an active job, or resume a paused job.

Select the ellipsis (...) on a job row to access additional actions, such as:

  • Edit configuration: Change job details, such as the job name or schedule
  • Job history: A list of previous job runs and completion statuses
  • Duplicate job: Copy the job's settings to a new cron job
  • Delete job: Delete the cron job from the list.

Create a cron job

Follow these steps to create a cron job in C3 AI Studio:

  1. Select + in the Cron Jobs Dashboard to reveal a job configuration modal dialog.

  2. Fill out the descriptive fields:

    • Name: A recognizable and descriptive name for the job

    • Type: The C3 AI Type used to perform the job

    • Action: The target C3 AI Type method (function) that is called when the job runs

    • Inputs (JSON): An optional key-value object with any inputs for the Action. The following example describes a single int32 function input called batchSize:

      JSON
      {
   "batchSize": {
       "type": "Boxed<int32>",
       "value": 50
   }
}

  3. Define the cron Schedule. Use the Simple or Advanced toggle to switch between cron syntax fields or date-time fields.

  4. Specify additional options using the checkboxes at the bottom of the modal dialog:

    • Concurrent: Check this box to allow multiple instances of the job to run in parallel.
    • Run on Leader: Check this box to only run the job on your cluster's leader node.
    • Inactive: Check this box to prevent the job from running.
    • No History: Check this box if the job should not have a run history.

  5. Select Create.

See also

Was this page helpful?