TLDR: Visithud.pytorch.org for a quick glance into PyTorch's CI. Go tohud.pytorch.org/pr/<pr number> (example) orhud.pytorch.org/commit/<long hash> (example) for a detailed view of GitHub Actions jobs.

Please report any HUD bugs you find in ourissue tracker!

• Introduction
• HUD Home Page
• Pull Requests and Commits

HUD is the PyTorch team's way of viewing results from CI runs. While Github provides built in CI job and workflow viewers, there are some limitations and extra features we wanted to add. Some examples of this include:

• All jobs on all workflows on a particular commit can be found on one page
• HUD log viewer loads the entire log withough truncating
• Log classifier can highlight what we think is the probable cause of failure for the job
• HUD main page shows all jobs on themain branch, making it easy to see consistent failures

While there are still limitations for HUD, we have more control over what and how things are displayed, so please feel free to submit feature requestshere for how we can make your PyTorch development easier.

PyTorch's CI currently runs on GitHub Actions. It can be hard to tell at a glance how the various jobs across these services are doing on recent commits to PyTorch to determine if a failure on your pull request is a real failure vs. something that is broken onmain.hud.pytorch.org aims to fill this gap by providing a quick view over all the jobs on these commits.

1. Branches/Helpful Links: Quickly switch between different branches. Also has a link to MiniHUD, a more granular, commit based view.
2. Repo/Branch Switcher: Click on these to change the branch or repo. Only works on repos within Pytorch
3. Job Filter: Search for jobs in here and press "Go" to get the permalink
4. Grouped View Checkbox: Group the workflows by logical organization
5. HUD Commit View Link: Click on these commits to take you to the HUD commit viewing, which shows the jobs that ran
6. Github PR Link: Click on these to take you to the PR on Github

The page displays statuses for a commit, so if you are viewing a PR you will see statuses for thelatest commit to that PR.

To find the HUD page for a PR, you can navigate to the page directly by going tohud.pytorch.org/pr/<pr number>, or by finding the link in the automated Dr. CI comment on your PR.

For commits, you can go tohud.pytorch.org/commit/<long commit hash> or by clicking the link from the HUD main page.

You should be able to see the GitHub Actions jobs for that commit or PR. For PRs, the jobs shown are for the latest commit pushed to that PR. Failing and pending jobs are shown at the top of the page.

Logs

For failing jobs, the line shown by the log viewer is our best guess at what is causing the job to fail. This can be clicked to expand the log viewer and see the rest of the log, which is also searchable.

For all jobs, raw logs can be found for every job by clicking theRaw Logs link. The Github log viewer can be accessed by clicking the job name.

Artifacts

Some jobs upload artifacts that can be found underExpand to see Artifacts at in at the bottom of each workflow box. Artifacts generally include xml test reports and other build artifacts. These can typically be found as soon as the job finishes, but some may take until the entire workflow finishes to show up due to limitations with Github Actions.