# Flutter Dashboard User Guide

The dashboard is generated based on a repo's [.ci.yaml](../CI_YAML.md).

## Build dashboard

The build page is accessible at https://flutter-dashboard.appspot.com/#/build.

Build statuses of commits on this page are sync'ed with most repos in https://github.com/flutter

### Tree Closures

The top navigation bar indicates the current tree status. If the tree is closed,
at least one test has failed against the top of tree and flutter/flutter is
currently not accepting new commits. Check on Discord [#tree-status](https://discord.com/channels/608014603317936148/613398423093116959)
for discussion about tree closures.

Tree closures occur when the latest results for a test have returned as
failing. Logs are found by clicking a task box then clicking "view logs."


### Why is a task stuck on "new task" status?

The dashboard aggregates build results from multiple build environments,
including Cirrus, LUCI, and DeviceLab. Due to limited capacity to run tests on
physical devices, some tests may be batched (run for several commits).

Flutter infra prioritizes running tasks against the most recent commits. This
leads to some tasks never being run on a commit as the test coverage was
provided from a more recent commit.

### Why do some tasks have an exclamation point?

Tasks with exclamation points indicate a task that has been run multiple times.
This indicates extra capacity used for this task. In some cases, this is an
infra issues. If it's common for a task column to be filled with green tasks
with exclamation marks, it indicates that task is flaky.

### How do I view results for a release branch?

**TODO(chillers): Update this when release branches are supported by cocoon scheduler**

Visit https://ci.chromium.org/p/flutter and click the link for the repo and release channel.

### There's a lot of boxes! Can I filter them?

Yes, click the settings cog in the top right for various filtering options.

Some options available include: authors, commit names, and platform run on.
PRs welcome for new filtering options!

If you're interested in a larger data analysis, the Flutter Infra Team pushes
this data to BigQuery.