Executions
Executions are the recorded executions of a verified flow and monitor the status of a current or historical analysis. Depending on flow configuration, an execution can start manually or automatically. Review the information on 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 information on the fields in the table, see Execution Field Descriptions.
Use the following selections in the Actions column of the Executions table to perform actions for an execution.
- 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
An Execution Details page displays the complete record of an analysis flow execution and links back to the 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 associated workflow that was used.
- Parameters: Displays the parameters that were used for the execution in a read-only form or JSON codeblock. Relaunching an execution will use these parameters by default.
- 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
The status of an execution indicates analysis progress. Terminal statuses include Completed, Failed, and Stopped.
| 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 begin running. |
| Running | Blue | The execution is actively progressing. Output files are not available 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. Data analysis files are not retained from a failed execution. |
| Stopped | Teal | A user stopped the execution before it completed. Data analysis files are not retained from a stopped execution. |
Execution Fields
The following information for active and historical analysis executions is collected.
| Field | Description |
|---|---|
| Ended | The timestamp for the end of the execution, written 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 flow for the execution |
| Inputs | The name of the flow inputs: run name for an assignment run, or execution name for other flow |
| Output Location | The storage connection location for the flow output |
| Parameters | The optional fields that can be customized for a given analysis workflow |
| Software Versions | The associated software versions that are used in a given flow that was executed |
| Started | The timestamp for the start of the execution, written as yyyy-mm-dd hh:mm |
| Started By | The name of the team member who 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 version of the workflow that was executed |
Relaunch an Execution
- Locate the execution you want to relaunch on the Executions or Run Details page.
- In the Actions column, select More, and then select Relaunch.
The launch form is loaded with the previous details selected.
- Rename the execution, or select Next to keep the same name.
- Upload new inputs or edit the parameters of the execution.
- Select Start Analysis to relaunch the execution.
Remove an Execution
Remove an execution to eliminate it from ElemBio Cloud. Although a removed execution no longer appears, the data remain archived and hidden. If you accidentally remove an execution, contact Element Technical Support to restore it.
- On the Executions page, locate the execution you want to remove, or navigate to the Execution page.
- In the Actions column or Execution overview section, select More, and then select Remove Execution.
- When prompted, enter the name of the execution.
- Select Remove to remove the execution.