<br />

<br />


[Managed Airflow (Gen 3)](https://docs.cloud.google.com/composer/docs/composer-3/view-dags "View this page for Managed Airflow (Gen 3)") \| **Managed Airflow (Gen 2)** \| [Managed Airflow (Legacy Gen 1)](https://docs.cloud.google.com/composer/docs/composer-1/view-dags "View this page for Managed Airflow (Legacy Gen 1)")

<br />

<br />

<br />

<br />

<br />

<br />

This page explains how to get information about DAGs in your environment.

## Ways to view information about DAGs

Managed Airflow provides several ways to get detailed information about DAGs in your environment:

- DAG UI is a section of Google Cloud console interface for Managed Airflow dedicated to viewing and monitoring DAGs, DAG runs, and individual tasks.
- [Airflow UI](https://docs.cloud.google.com/composer/docs/composer-2/access-airflow-web-interface) is the built-in web interface of Airflow.
- [Airflow CLI](https://docs.cloud.google.com/composer/docs/composer-2/access-airflow-cli) is the command-line interface of Airflow. You can get information about DAGs by running Airflow CLI commands with `gcloud`.

## About Managed Airflow DAG UI

DAG UI is a section of Google Cloud console interface for
Managed Airflow dedicated to viewing and monitoring DAGs, DAG runs,
and individual tasks.

In DAG UI, you can:

- View a list of DAGs in your environment, including schedule intervals, DAG
  states, and descriptions.

- Pause, unpause, and [trigger DAGs](https://docs.cloud.google.com/composer/docs/composer-2/schedule-and-trigger-dags#manual).

- View DAG run details, including successful, active, and failed runs, time
  since the last completed run. For each DAG, you can see the history of DAG
  runs and task instances associated with this particular DAG, including logs
  for executed tasks.

- Filter DAG run details. For example, you can pick a time interval and
  create queries to select the information that you need.

- View detailed information about individual DAGs and tasks. This includes
  visualized DAG diagrams, information about the tasks within a DAG, DAG
  source code, and extra information about DAGs.

## Before you begin

- Make sure that your account has a role that can access DAG UI and view DAG
  details. For more information, see [Access control](https://docs.cloud.google.com/composer/docs/composer-2/access-control).

- DAG UI is supported in Managed Airflow 2.0.1 and later
  versions.


  ## View the list of DAGs for your environment

  ### Console

  The **DAGs** tab of your environment shows the list of DAGs along with DAG
  run details for each DAG.

  To view the list of DAGs:
  1. In the Google Cloud console, go to the **Environments** page.

     [Go to Environments](https://console.cloud.google.com/composer/environments)
  2. In the **DAG list** column, follow the **DAGs** link for your environment.

  You can use filters to view the details only for certain DAGs or for
  certain conditions. For example:
  1. Select the **Filters** field.
  2. From the drop-down list, select the **DAG id** property.
  3. Specify the identifier of the DAG. The results show details only for the selected DAG.
  4. (Optional) To include more DAGs, add `OR` operators followed by DAG ids.
  5. (Optional) To filter on other conditions, add other properties in the **Filters** field. For example, you can filter for DAGs with failed runs by specifying `Failed runs:>0`.

  ### Airflow UI

  To view the list of DAGs in the Airflow UI:
  1. In the Google Cloud console, go to the **Environments** page.

     [Go to Environments](https://console.cloud.google.com/composer/environments)
  2. In the **Airflow webserver** column, follow the **Airflow** link for your
     environment.

  3. Log in with the Google account that has the appropriate permissions.

  4. In the Airflow UI, on the **DAGs** page, a list of DAGs for
     your environment is displayed.

  ### gcloud

  Run the `dags list` Airflow CLI command:


        gcloud composer environments run ENVIRONMENT_NAME \
          --location LOCATION \
          dags list -- -o plain

  Replace:
  - `ENVIRONMENT_NAME` with the name of the environment.
  - `LOCATION` with the region where the environment is located.

  ## View the history of DAG runs and tasks

  ### Console

  The **Runs** tab on the **DAG details** page shows the history of DAG runs
  for an individual DAG.

  To view the history of DAG runs:
  1. In the Google Cloud console, go to the **Environments** page.

     [Go to Environments](https://console.cloud.google.com/composer/environments)
  2. In the **DAG list** column, follow the **DAGs** link for your environment.

  3. Select a DAG.

  4. On the **DAG details** page, go to the **Runs** tab.

  5. Select a DAG run from the list to view the DAG run details, such as the
     state of task instances for this DAG run, the number of tries and the
     execution duration. You can select individual tasks to view
     task instance logs.

  ### Airflow UI

  To view the list of DAGs in the Airflow UI:
  1. In the Google Cloud console, go to the **Environments** page.

     [Go to Environments](https://console.cloud.google.com/composer/environments)
  2. In the **Airflow webserver** column, follow the **Airflow** link for your
     environment.

  3. Log in with the Google account that has the appropriate permissions.

     <br />

  4. In the Airflow UI, in the menu,
     select **Browse** \> **DAG Runs** . The **DAG Runs** page
     displays DAG runs for your environment. You can follow the link in the
     **Run ID** column to get additional information about tasks.

  ### gcloud

  Run the `dags list-runs` Airflow CLI command:


        gcloud composer environments run ENVIRONMENT_NAME \
          --location LOCATION \
          dags list-runs -- -d DAG_ID

  Replace:
  - `ENVIRONMENT_NAME` with the name of the environment.
  - `LOCATION` with the region where the environment is located.
  - `DAG_ID` with the name of the DAG.

  You can get additional information about task instances by running `tasks state` and `tasks states-for-dag-run` Airflow CLI commands.

  For more information, see [Access Airflow CLI](https://docs.cloud.google.com/composer/docs/composer-2/access-airflow-cli) and the
  [Airflow CLI reference](https://airflow.apache.org/docs/apache-airflow/stable/cli-and-env-variables-ref.html).

  <br />

  ## View DAG diagrams

  ### Console

  The **Diagram** tab on the **DAG details** page show the visualisation of a
  DAG with task dependencies.

  To view the diagram of a DAG:
  1. In the Google Cloud console, go to the **Environments** page.

     [Go to Environments](https://console.cloud.google.com/composer/environments)
  2. In the **DAG list** column, follow the **DAGs** link for your environment.

  3. Select a DAG.

  4. On the **DAG details** page, go to the **Diagram** tab.

  5. (Optional) To see additional information about tasks, select individual tasks on the diagram.

  ### Airflow UI

  To view the diagram of a DAGs in the Airflow web interface:
  1. In the Google Cloud console, go to the **Environments** page.

     [Go to Environments](https://console.cloud.google.com/composer/environments)
  2. In the **Airflow webserver** column, follow the **Airflow** link for your
     environment.

  3. Log in with the Google account that has the appropriate permissions.

  4. In the Airflow UI, on the **DAGs** page, a list of DAGs for
     your environment is displayed.

     <br />

  5. For your DAG, in the **Links** column, follow the **Graph** link.

  ## View DAG source code and additional information about DAGs

  ### Console

  You can view the source code of your DAGs and additional information such as
  DAG identifiers and links to DAG definition files in the environment's
  bucket.

  > [!NOTE]
  > **Note:** It is not possible to edit the source code of your DAGs on this tab.

  1. In the Google Cloud console, go to the **Environments** page.

     [Go to Environments](https://console.cloud.google.com/composer/environments)
  2. In the **DAG list** column, follow the **DAGs** link for your environment.

  3. Select a DAG.

  4. To view the DAG source code, go to the **Diagram** tab.

  5. To view additional information about the DAG, go to the **Source** tab.

  ### Airflow UI

  To view the diagram of a DAGs in the Airflow web interface:
  1. In the Google Cloud console, go to the **Environments** page.

     [Go to Environments](https://console.cloud.google.com/composer/environments)
  2. In the **Airflow webserver** column, follow the **Airflow** link for your
     environment.

  3. Log in with the Google account that has the appropriate permissions.

  4. In the Airflow web interface, on the **DAGs** page, click on the name of
     your DAG.

  5. In the page with DAG details, navigate to available tabs to view
     additional information about the DAG.

  ## What's next

  - [Add and update DAGs](https://docs.cloud.google.com/composer/docs/composer-2/manage-dags)
  - [Schedule and trigger DAGs](https://docs.cloud.google.com/composer/docs/composer-2/schedule-and-trigger-dags)