When you launch your workflows on One Codex, you will want to track their progress and success. This is particularly true while you are developing and testing your workflows. With this in mind, we will walk you through where to find detailed information on the workflow runs that you've launched for your samples.
On the Run Workflows page, you will find a button to View Workflow Runs at the top-right of the page.
This will bring you to a new page, which lists out all of the different workflow runs that have been launched for your samples.
Each line represents a workflow run attempt on a sample. This table indicates which workflow job was used, a unique ID for the run attempt, the status of the run (Pending, Succeeded, or Failed), the filename of the sample on which the workflow was run, and its start and completion dates. There is also a button to view the details of any run of interest, which will bring you to a new page for that specific run.
Detailed View of a Workflow Run
The details page for a workflow run contains the following sections.
A summary, with the status, name of the workflow, the sample file name, and the duration. In this section, you can download all results (gzipped tarball of all output files) and logs (.txt).
The files that are generated in your workflow and placed in the output folder are viewable in the second section. This section allows you to expand/collapse the output file tree, and download individual files. Just hover over the file that you wish to download to view its size and download button.
Note that if a workflow produces >1,000 files in the output directory, the entire directory will be tarballed. Individual files will not be displayed.
Clicking on any of the files will open an additional view for that file. If the file is of a certain type (e.g. PDF, PNG, JSON), we will render an image or view of that file for you to preview.
The Parameters section details the repository, script, and arguments used for this particular run of this sample.
Lastly, the logs section allows you to view the logs of the workflow, in real time!
Alternative Access of Results for Published Workflows
You can also access the details and results page for a workflow run on a sample, by clicking "View Results" on any sample listed on your Samples page. When on a sample's results page, click on the analysis menu at the top-right of that page (i.e. click the name of the workflow that you're currently viewing. For more details on how to do that, see here). This will provide a drop-down menu of the various workflows that have been run for that sample.
Note that this drop-down menu does not display results/details of draft workflows; it only includes results of published workflows. For more details on the various states a workflow can be in, take a look at this article!