View your jobs with a Gantt Chart

The Gantt Chart shows a historical timeline of the states your jobs went through as they ran. This page will provide information on how to view the progress of your jobs in the Gantt Chart and explain how to read it.

Accessing the Gantt Chart

When you are in your LabOps view, you can access the Gantt Chart view by clicking the "Gantt" button in the main navigation bar.

Using the Gantt Chart

The Gantt Chart view lets you view a historical timeline of completed jobs in your selected lab. By default, the Gantt Chart is set to a 12-hour window before "now," represented by a blue dotted line with a blue tag. 

Each row represents a job and sorts the newest jobs to the top of the view. 

The Gantt Chart provides key information about your job, including:

• Job Name - indicated on the left at the start of the row
• Job Start and End Times - represented by the blue line that is capped with small circles 
• Activity Information - represented in colored blocks to depict changes in job states 
• Events Information - represented by icons to show key events that occurred 

Activity and Inactivity

The colored blocks indicate the job activity or the state of the job during that time:

• Blue blocks indicate "RUNNING"
• Yellow blocks indicate "ASSISTANCE NEEDED"
• Red blocks indicate "ERROR"
• Dark blue blocks indicate "PAUSED"

Purple lines indicate the job waiting during that time; the icon indicates what the job was waiting for:

• indicates that the job is waiting for a resource with a specific required ability to become available.
• indicates that the job is waiting for a user-defined schedule delay to complete.
• indicates that the job is waiting for one or more child jobs to complete.

To get additional details about an activity or waiting period, you can hover over it. When hovering, you will be able to see:

• The full activity name
• The exact start and end times for that activity
• The duration of the activity 
• The reason for waiting

Events

If one of the below events occurs, the corresponding icon will be added to the job's view:

Activity Groups

Some workflows have control structures such as loops, branches, or spanlocks that group several activities together. To see these activity groups in the gantt chart, you can click the arrow next to the job row.

The header indicates the type and name of the activity group.

Branches are displayed in dark red and show the branch and path name as annotated in the workflow.

Loops are shown in green and show the current and total loop count. In the image above, this is loop 1 of 2.

Spanlocks are shown in black and show the ability that's being reserved by the spanlock.

The activities within the group are displayed below the header. For example, these activity groups

come from this workflow pseudo code:

1. create assets
2. Run this 2x:
   
   1. set up the deck
   2. if we're running for real
      1. run the method
   3. upload the resulting csv
   4. clean up up the deck

Navigating the Gantt Chart

You can navigate the Gantt Chart with your mouse or using the UI.

In the UI:

• Click the left and right arrows next to the date to navigate to the left and right
• Click "Today" to reset back to the default view. 

Projected Schedules

In addition to seeing the historical gantt chart that shows you how the job went in the past, the gantt chart will also show you what we expect the schedule to look like in the future.

Projected activities have the same colors as normal activities and activity groups, except they're shown with lighter colors.

The schedule projection represents Artificial's best estimate for how the schedule will go, based on the hints and annotations provided to us in the workflow. If an Assistant or Action takes more or less time than expected, the schedule will automatically update to account for that, pulling the rest of the upcoming activites in or pushing them out as needed. This always keeps your lab running optimally.

If the projected schedule isn't what you expect, you can provide hints to the scheduler to change the number of times it should iterate through a loop, which branch it should take, and how long an activity will last. To provide a hint about an activity group, just click the activity group name. To provide a hint about the duration of an activity, click and drag the bar at the right edge of the activity.