Skip to main content

Run details

Select a workflow run from the Runs list to open a run details page.

The top of the page contains basic run details and a progress overview for an at-a-glance view of the run's status:

  • View and copy the run ID, pipeline name and repository, pipeline work directory, compute environment, and launch date.
  • Select the star icon to favorite the run and find it more easily via a filter view in the runs list later.
  • Use the options menu to apply labels, relaunch, resume, or delete the run, save the run as a new pipeline, or publish a new pipeline version (if the run was launched from an unnamed draft).

Select the tabs below the workflow run progress bar to view further run details:

  • Tasks: View the status and progress of pipeline tasks and processes, including extensive task details.
  • Logs: View and download the pipeline run's execution logs.
  • Metrics: View resource metrics for the run.
  • Configuration: View Nextflow configuration files and the resolved configuration used for the run.
  • Inputs: View pipeline parameters used by the run, including their lineage records.
  • Outputs: View files produced by the run, including reports and lineage records for every published file.
  • Containers: View the details of containers used in the run, if any.
  • Run Info: View details about the run, infrastructure, executor, and lineage.
tip

Data lineage is made available on request. Please contact your Seqera account manager.

Lineage-aware fields and tabs only display data when the run was executed with data lineage enabled. There are three ways to enable lineage:

  • Settings > Lineage. A workspace maintainer configures the cloud credentials, region, and (optionally) bucket name where lineage records are stored. Select Enable lineage by default to make the launch form lineage toggle default to on for every run launched in the workspace.
  • Launch form toggle. When launching a pipeline, toggle lineage on or off for the individual run.
  • Nextflow configuration. Set lineage.enabled = true in your pipeline's Nextflow config.

See Getting started with data lineage for the underlying lineage data model.

Task status overview

The cards at the top of the Tasks tab provide a real-time status of all tasks in the pipeline run:

  • Pending: The task has been created, but not yet submitted to an executor.
  • Submitted: The task has been submitted to an executor, but is not yet running.
  • Running: The task has been launched by an executor (the precise definition of "running" may vary for each executor).
  • Cached: A previous (and valid) execution of the task was found and used instead of executing the task again. See Cache and resume.
  • Succeeded: The task completed successfully.
  • Failed: The task failed.
  • Aborted: The task was submitted, but the run was cancelled or failed before the task could begin.

Processes

The Processes panel displays the status of each process in a pipeline run. In Nextflow, a process is an individual step in a pipeline, while a task is a particular invocation of a process for given input data. In the panel, each process is shown with a progress bar indicating how many tasks have been completed for that process.

The progress bar is color-coded based on task status (created, submitted, completed, failed).

Select a process to navigate to the Tasks panel and filter the table contents by the selected process.

Tasks

The Tasks panel shows all the tasks that were executed in the run, including the following task details:

LabelDescription
task_idUnique identifier for the task.
processProcess name.
tagUser-defined label or tag associated with the task.
hashNextflow task hash value.
statusTask execution status (e.g., COMPLETED, FAILED, RUNNING).
attemptNumber of execution attempts for this task (for retry logic).
exitTask exit code.
containerContainer image used to execute the task.
native_idNative job ID assigned by the executor (e.g., cluster job ID).
submitTimestamp when the task was submitted for execution.
durationTotal execution time for the task.
realtimeCPU wall time the task actually ran.
% cpuPercentage of CPU utilization during task execution.
% memPercentage of memory utilization during task execution.
peak_rssPeak resident set size (physical memory usage).
peak_vmemPeak virtual memory usage.
rcharNumber of characters read from storage.
wcharNumber of characters written to storage.
vol_ctxtNumber of voluntary context switches.
inv_ctxtNumber of involuntary context switches.
lineage_idLineage ID (LID) of the task's TaskRun record. Populated only when lineage tracking is active for the run. Select the LID to navigate to the lineage record.

Use the search bar to filter tasks with substrings in the table columns such as process, tag, hash, and status. For example, if you enter succeeded in the Search task field, the table displays only tasks that succeeded.

Task details

Task details

Select a task in the task table to open the Task details dialog. The dialog has the following tabs:

  • About
  • Metrics
  • Execution log
  • Data Explorer
  • Container
note

If lineage is enabled for the run, the About tab content includes Inputs and Outputs tabs.

The Inputs and Outputs tabs show every input or output consumed by the task, including the name, its lineage type (Collection or Path), the source path, the lineage labels assigned to it, and the lineage ID of the corresponding lineage record. Select a name to open the file in Data Explorer. Select a lineage ID or label to navigate to that lineage record.

About

  • Name: Process name and tag.
  • Status: Exit code, task status, attempts.
  • Native ID: Unique identifier assigned by the underlying execution executor to a specific job.
  • Command: Task script, defined in the pipeline process.
  • Environment: Environment variables supplied to the task.
  • Work directory: Directory where the task was executed.
  • Inputs: File inputs to the task and associated lineage data.
  • Outputs: File outputs from the task and associated lineage data.
  • Upstream: Links to related upstream tasks.
  • Downstream: Links to related downstream tasks.

Metrics

  • Execution time: Metrics for task submission, start, and completion time:

    LabelDescription
    submittedTask submission timestamp.
    startedTask execution timestamp.
    completedTask completion timestamp.
    total durationTime elapsed from task submission to completion, including scheduling time.
    script execution timeTask script execution time.
  • Requested resources: Metrics for the resources requested by the task:

    LabelDescription
    container imageContainer image name used to execute the task.
    queueThe queue that the executor used to run the process.
    cpusNumber of CPUs requested for task execution.
    memoryMemory requested for task execution.
    disk spaceDisk space requested for task execution.
    time limitTime requested for task execution.
    executorThe Nextflow executor used for this task.
    cloudZoneThe cloud zone (region) where the task was executed.
    machineTypeThe virtual machine type used for this task.
    priceModelThe price model used to calculate the task computation cost.
    estimated costThe estimated cost to compute this task.
  • Used resources: Metrics for the actual resources used by the task:

    LabelDescription
    pcpuPercentage of CPU used by the task.
    rssReal memory (resident set) size of the task.
    peakRssPeak of real memory used.
    vmemVirtual memory size of the task.
    peakVmemPeak of virtual memory used.
    rcharNumber of bytes the task read, using any read-like system call from files, pipes, tty, etc.
    wcharNumber of bytes the task wrote, using any write-like system call.
    readBytesNumber of bytes the task read directly from disk.
    writeBytesNumber of bytes the task originally dirtied in the page-cache (assuming they will go to disk later).
    syscrNumber of read-like system call invocations that the task performed.
    syscwNumber of write-like system call invocations that the task performed.
    volCtxtNumber of voluntary context switches.
    invCtxtNumber of involuntary context switches.

Execution log

The Execution log tab provides a real-time log of the selected task's execution. Task execution and other logs (such as stdout and stderr) are available for download if they are still available in your compute environment.

Data Explorer

If the pipeline work directory is in cloud storage, this tab shows a Data Explorer view of the task's work directory location with the files associated with the task.

Container

This tab contains the image and build details of the container used to execute the task:

LabelDescription
Target imageThe container image used to execute the workflow task.
Source imageThe container image specified in the workflow configuration, if available.
Request IDThe unique request ID associated with the container.
Request timeThe timestamp when the container request was made.
Build IDThe unique build ID assigned when the container was provisioned.
Mirror IDThe unique mirror ID assigned when the container was copied between repositories.
Scan IDThe unique scan ID from the vulnerability security scan of the container.
CachedIndicates whether the container was previously built in an earlier request.
FreezeIndicates whether the container was provisioned for persistent storage using Wave freeze mode.
On this Page