| # 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 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. |
