Flows API
  • Globus Flows
  • Overview
  • Getting Started
    • How to Run a Flow
    • How to Monitor a Flow Run
    • How to Create a Flow
  • Authoring Flows
    • Introduction
    • Actions
    • Expressions
    • Choice States
    • Wait States
    • Fail States
    • Pass States
    • Protecting Secrets
    • Handling Exceptions
    • Performing Actions as Different Users
    • Run Context
    • Validating Flow Definitions
  • Authoring Input Schemas
  • Authentication and Authorization
  • Consents and Resuming Runs
  • Permissions
  • Limits
  • Hosted Action Providers
    • Hello World
    • Globus Search - Ingest Task
    • Globus Search - Delete Task
    • Send Notification Email
    • Wait For User Selection
    • Expression Evaluation
    • DataCite Mint
    • Transfer APs
    • Compute AP
  • Example Flows
    • Simple Transfer
    • Move (copy and delete) files
    • Transfer and Share Files
    • Two Stage Globus Transfer
    • Transfer After Approval
    • Looping Batched Move
    • Tar and Transfer with Globus Compute
Skip to main content
Globus Docs
  • APIs
    Auth Flows Groups Search Timers Transfer Globus Connect Server Compute Helper Pages
  • Applications
    Globus Connect Personal Globus Connect Server Premium Storage Connectors Compute Command Line Interface Python SDK JavaScript SDK
  • Guides
  • Support
    FAQs Mailing Lists Contact Us Check Support Tickets
  1. Home
  2. Globus Services
  3. Globus Flows
  4. Getting Started
  5. How to Monitor a Flow Run

How to Monitor a Flow Run

This step-by-step guide will show you how to monitor a flow run.

Note

If you haven’t run a flow before it will limit how closely you can follow the examples in this how-to. We recommend starting with How to Run a Flow first so that you’ll have some runs to view in later steps.

1. Open the Flows Page

Login to the Globus Web App (app.globus.org) and open the Flows management page from the navigation menu.

Flows Navigation Icon

Use the Runs tab at the top if you need to return to this page later.

Runs and Library tabs

2. Browse Your Runs

When first opened, the Flows management page displays your entire run history, including runs that are in progress.

Unfiltered Flow Run listing
Note

You can use the history to view runs up to 90 days old.

2.1. Sorting

To change the order runs are displayed in, reveal the sort options by selecting the Sort menu just above the runs list. You can sort runs alphabetically by their label, by when the flow was started, and by the name of the run’s flow.

Run Sorting

2.2. Searching

To search for a particular run label, use the search field (labeled "filter run list").

Run Search

2.3. Filtering

There are many options available to help focus on a specific subset of runs.

Quick Filters allow you to limit the view to only runs you started or runs in a particular state.

Unfiltered Flow Run listing

For even more options, including filtering by tags, select the Advanced Filters button.

Advanced Flow Run filters

3. Select a Run

To view the details of a particular run, select the run label from the list.

Select Run by clicking on run Label

4. View Run Details

Selecting a run opens its details page. The Overview tab displays information about a run and the flow from which it was launched.

Run Overview tab

4.1. The Event Log

To examine the detailed execution history of the run, open the Event Log tab.

Run Event tab

Events are sorted chronologically, with the most recent events appearing at the top of the list. This view is updated as your run progresses.

Note

The Event Log does not load additional events automatically as you scroll. If more events are available but not displayed, you can use the Load More button to reveal them.

Run Event tab

4.2. Investigating a Run

In the example below, we can see the run has failed. To diagnose the cause of a failure, you can expand log entries to expose more detail. We can see that in this example, the run has indicated that the source path was missing.

Flow Run Failed Event entry

The first entry in the run log—labeled FlowStarted and appearing at the bottom of the list—shows the original parameters that were provided as input for a run.

Flow Run Failed Event first log entry

4.3. Managing Roles

To collaborate with others, you can share access to runs with additional users and groups. To view existing permissions for a run, open the Roles tab.

Roles Tab  width=346

To grant access to another user, click the Assign New Role button.

Assign New Role

On the Assign New Role page, you can search for a user or group and choose what type of access to grant.

User Selection
User Selection

5. Next Steps

Globus also provides a command-line tool for starting and managing runs. For more information, see Globus CLI flows Command Reference.

If you’re ready to learn more about authoring your own flows, see How to Create a Flow.

  • Globus Flows
  • Overview
  • Getting Started
    • How to Run a Flow
    • How to Monitor a Flow Run
    • How to Create a Flow
  • Authoring Flows
    • Introduction
    • Actions
    • Expressions
    • Choice States
    • Wait States
    • Fail States
    • Pass States
    • Protecting Secrets
    • Handling Exceptions
    • Performing Actions as Different Users
    • Run Context
    • Validating Flow Definitions
  • Authoring Input Schemas
  • Authentication and Authorization
  • Consents and Resuming Runs
  • Permissions
  • Limits
  • Hosted Action Providers
    • Hello World
    • Globus Search - Ingest Task
    • Globus Search - Delete Task
    • Send Notification Email
    • Wait For User Selection
    • Expression Evaluation
    • DataCite Mint
    • Transfer APs
    • Compute AP
  • Example Flows
    • Simple Transfer
    • Move (copy and delete) files
    • Transfer and Share Files
    • Two Stage Globus Transfer
    • Transfer After Approval
    • Looping Batched Move
    • Tar and Transfer with Globus Compute
© 2010- The University of Chicago Legal Privacy Accessibility