> For the complete documentation index, see [llms.txt](https://help.fovus.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.fovus.co/docs/pipeline/monitor-manage/pipeline-monitoring.md).

# Monitor your pipeline

View pipeline status, jobs, files, infrastructure usage, and live output on the pipeline detail page.

Open a pipeline from the **Pipelines** list to review its run. The sections below follow the tabs on the pipeline detail page — **Pipeline**, **Jobs**, **Files**, **Infrastructure**, and **Progress** (Fovus-hosted only).

![Pipeline detail page tabs for a Fovus-hosted pipeline](https://2108897467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhGluyldqdG6yHzilfIdu%2Fuploads%2Fgit-blob-57729957b4029932f33a2a4aa9ed9cd3e6737e8f%2Fpipeline-monitoring-detail-tabs.png?alt=media)

## Pipeline

The **Pipeline** tab shows metadata: **Status**, **Workflow host** (**Local** or **Remote**), timestamps, submitted job count, and — for Fovus-hosted runs — the **Setup command** and **Run command**.

![Pipeline tab with status, workflow host, and run command](https://2108897467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhGluyldqdG6yHzilfIdu%2Fuploads%2Fgit-blob-57729957b4029932f33a2a4aa9ed9cd3e6737e8f%2Fpipeline-monitoring-detail-tabs.png?alt=media)

Use this tab to confirm the pipeline is **Running**, **Completed**, **Failed**, or **Stopped** before drilling into jobs or files.

## Jobs

Each Nextflow process appears as a Fovus Job. Click a job name to open its detail page for per-task status, files, events, and infrastructure.

![Jobs tab listing jobs created by the pipeline](https://2108897467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhGluyldqdG6yHzilfIdu%2Fuploads%2Fgit-blob-36675dd3c3ddf2b9e03d51bc90959ff309361275%2Fpipeline-monitoring-jobs-tab.png?alt=media)

For per-task actions (extend walltime, SSH, terminate a task), see [Task monitoring](/docs/job/monitor-manage/task-monitoring.md).

## Files

Browse the pipeline working directory in [Fovus Storage](/docs/storage/storage-overview.md).

![Files tab showing the pipeline folder in Fovus Storage](https://2108897467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhGluyldqdG6yHzilfIdu%2Fuploads%2Fgit-blob-826ac89782a6911618e1e830950b0aca96c43636%2Fpipeline-monitoring-files-tab.png?alt=media)

Typical contents:

* Uploaded pipeline files (`*.nf`, `nextflow.config`)
* `work/` — Nextflow intermediate directories
* Published output from `publishDir` directives
* Log files such as `fovus-std.out` and `nextflow.log`

{% hint style="info" %}
For large files, use the Storage mount at `/fovus-storage/pipelines/<pipeline-id>/` instead of downloading through the browser. See [Mount Fovus Storage locally](/docs/storage/mount-storage-locally.md).
{% endhint %}

Inside a task work directory, `fovus-std.out` captures that task's terminal output — useful when troubleshooting a failed process.

To copy files to your machine from the CLI:

```bash
fovus pipeline download ./my-pipeline
```

Fovus reads the pipeline ID from `.fovus/pipeline_data.json` when you pass a pipeline directory. Filter paths with `--include-paths` or `--exclude-paths`. See [fovus pipeline download](https://help.fovus.co/cli/commands/pipeline/download.html).

## Infrastructure

Review cloud resources used for the pipeline and credits consumed. The summary includes vCPU-hours, GPU usage if applicable, and savings from preemptible instances.

![Infrastructure tab with instance usage and cost](https://2108897467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhGluyldqdG6yHzilfIdu%2Fuploads%2Fgit-blob-b1cceaf374da1b0fd0f4640529cd50cba75cb138%2Fpipeline-monitoring-infrastructure-tab.png?alt=media)

Cost reflects credits charged and the **TCPR (Time-to-cost priority ratio)** active when jobs ran.

## Progress

{% hint style="warning" %}
**Progress** is available for **Fovus-hosted** pipelines only. For local Nextflow manager runs, watch output in the terminal where you ran `nextflow run`, or read `fovus-std.out` in each task's work directory under `/fovus-storage/pipelines/<your_pipeline_id>/`.
{% endhint %}

While the headnode is running, **Progress** streams live Nextflow standard output — the same lines you would see in a local terminal. Look for `executor > fovus` to confirm processes run on Fovus cloud infrastructure.

![Progress tab tailing fovus-std.out while the pipeline runs](https://2108897467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhGluyldqdG6yHzilfIdu%2Fuploads%2Fgit-blob-a607e5e1e9bb71e141304e6560e8b109a92b749e%2Fstop-resume-progress-tab-live-output.png?alt=media)

## Delete

Click **Delete** on the pipeline detail page to remove the pipeline and release resources. Deletion is irreversible.

{% hint style="danger" %}
Deleting a pipeline removes its entry from the list and may remove output files depending on your organization's retention settings. Download anything you need before deleting.
{% endhint %}

To have Fovus delete the pipeline for you a set number of days after it finishes, see [Auto-delete a pipeline](/docs/pipeline/monitor-manage/auto-delete-pipeline.md).

## What's next?

Fovus-hosted pipelines stop the headnode when they **complete**, **fail**, or are **stopped**. To restart orchestration, see [Stop and resume a pipeline](/docs/pipeline/monitor-manage/stop-resume-pipeline.md).

For submission options, see [Submit a pipeline](/docs/pipeline/nextflow/pipeline-submission.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.fovus.co/docs/pipeline/monitor-manage/pipeline-monitoring.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.