Skip to main content

Run details

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

Run details and progress overview

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, or to save the run as a new pipeline.

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
  • Datasets: View datasets used as input for the run, if any
  • Reports: View reports for the run, if any were configured
  • Containers: View the details of containers used in the run, if any
  • Run Info: View details about the run, infrastructure, and executor

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.

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 four tabs: About, Execution log, Data Explorer, and Container.

About

  • Name: Process name and tag.

  • Command: Task script, defined in the pipeline process.

  • Status: Exit code, task status, attempts.

  • Work directory: Directory where the task was executed.

  • Environment: Environment variables supplied to the task.

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

    LabelDescription
    submitTask submission timestamp.
    startTask execution timestamp.
    completeTask completion timestamp.
    durationTime elapsed from task submission to completion, including scheduling time.
    realtimeTask script execution time.
  • Resources requested: Metrics for the resources requested by the task:

    LabelDescription
    containerContainer 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.
    diskDisk space requested for task executiuon.
    timeTime requested for task execution.
    executorThe Nextflow executor used for this task.
    machineTypeThe virtual machine type used for this task.
    cloudZoneThe cloud zone (region) where the task was executed.
    priceModelThe price model used to calculate the task computation cost.
    costThe estimated cost to compute this task.
  • Resources used: 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.