Executions
An execution records the status, exact launch parameters, and analysis outputs from a configured flow. An execution can start manually or automatically based on flow configuration. For more information, see the following pages:
- Executions: Displays information for active and historical analysis executions from cloud verified flows.
- Execution Details: Displays detailed information for an analysis execution.
All Executions
The Executions page displays a table with all active and historical flow execution . By default, the table displays the most recent executions first. The rows of the table are color-coded by workflow type: Assignment:Purple or Secondary Analysis:Pink. For more information on the table fields, see Execution Field Descriptions.
To perform execution actions, use the following selections in the Actions column of the Executions table.
- Output Files: Quick link to the execution output files tab for review and download.
- Relaunch Flow: Relaunch after troubleshooting an issue or editing the flow for an execution.
- Remove Execution: Remove an execution if it is of no use or to eliminate it from ElemBio Cloud.
Execution Details
The Execution Details page displays the complete record of an analysis flow execution and is linked to associated input data such as runs or other executions.
The page includes the following features:
- Execution Overview: Visualizes the current execution status in a progress bar and displays important details and actions for an execution.
- Configuration: Displays execution information about the flow configurations and the associated workflow that was used.
- Parameters: Displays the parameters that were used for the execution in a read-only form or JSON code block. By default, these parameters are used when you relaunch an execution.
- Run Manifest: Displays the run manifest that was used for the execution. This is displayed for Assignment executions that use runs as input.
- Samples: Displays the samples that were used as input for the execution. This is displayed for Secondary Analysis executions that use curated file lists for input.
- Logs: Displays log files to help troubleshoot technical errors with an execution such as warnings, errors, or erroneous optional parameters.
- Output Files: Displays the analysis files output from the execution. The data browsing page contains helpful instructions for downloading files.
- Reports: Displays QC reports to help address issues related to the quality of analysis results.
Execution Statuses
An execution status indicates analysis progress. Terminal statuses include Completed, Failed, and Canceled.
| Status | Progress Bar Color | Description |
|---|---|---|
| Pending | Blue | The execution is initializing and preparing to begin. |
| Initialized | Blue | The execution completed preparation steps and is ready to start running. |
| Running | Blue | The execution is actively progressing. Output files are unavailable until the execution completes. |
| Completed | Green | The execution successfully completed. ElemBio Cloud generated all files from the flow in the selected storage location. |
| Failed | Red | The execution failed to complete due to an error and data analysis files aren't saved. |
| Canceled | Teal | A user canceled the execution before it completed and data analysis files aren't saved. |
Execution Fields
The following information is collected for active and historical analysis executions:
| Field | Description |
|---|---|
| Ended | The timestamp for the end of the execution shown as yyyy-mm-dd hh:mm |
| Execution ID | The unique identifier that ElemBio Cloud assigns to the execution |
| Execution Name | The unique, human-readable name that ElemBio Cloud or the team member assigns to the execution |
| Execution Time | The execution duration in minutes and seconds |
| Flow Name | The name of the execution flow |
| Inputs | The name of the flow inputs: run name for an assignment run, or execution name for other flows |
| Output Location | The location for the flow output storage connection. |
| Parameters | The optional fields that can be customized for an analysis workflow |
| Software Versions | The associated software versions used in an executed flow |
| Started | The timestamp for the start of the execution shown as yyyy-mm-dd hh:mm |
| Started By | The team member that launched the execution |
| Status | The current execution status |
| Workflow | The workflow that was executed. The execution is often color-coded by workflow type: Assignment:Purple or Secondary Analysis:Pink |
| Workflow Diagram | A simple representation of the workflow including the input data types and the produced output files |
| Workflow Version | The workflow version that was executed |
Relaunch an Execution
To start an execution again, relaunch the execution. If the execution is in progress, cancel the execution, and then relaunch the execution.
- On the Executions or Run Details page, select the execution that you want to relaunch.
- In the Actions column, select More, and then select Relaunch.
The launch form is loaded with the previous details selected.
- Update the execution name, or select Next to keep the current name.
- Upload new inputs or edit the parameters of the execution.
- Select Start Analysis to relaunch the execution.
Remove an Execution
To delete an execution from ElemBio Cloud, remove the execution. The generated data from a removed execution is archived and hidden. If you need to restore a removed execution, contact Element Technical Support.
- On the Executions page, select the execution that you want to remove.
- In the Actions column or Execution overview section, select More, and then select Remove Execution.
- When prompted, confirm the execution name and select Remove to remove the execution.
Cancel an Execution
To stop an execution that's in progress, cancel the execution. When you cancel an execution, the workflow stops and data isn't generated. If you're using an external provider, the execution will cancel on the associated platform. If you want to start the execution again, relaunch the execution.
- On the Executions, Executions List, or Run Details page, select the execution that you want to cancel.
- Select the Cancel Execution button. Or, select Cancel Execution from the Actions dropdown menu.
- On the Confirmation prompt, enter the execution name and select Confirm to confirm that you want to cancel the execution.
The execution badge indicates canceled and the execution progress bar stops with a canceling status shown.