Finding your way around¶
This page walks through the DV Forge web app's frame: the sidebar, the project switcher, how pages keep themselves up to date, notifications, and the theme. After reading it you'll know which page answers which question and how the selected project affects what you see.
Note
The sidebar appears in windows at least 768 pixels wide. In a narrower window it's hidden, so widen the window to navigate.
The sidebar, top to bottom¶
Header. The DV Forge wordmark, the notifications bell (see Notifications) and your account menu (your avatar), where you manage your sign-in and sign out.
Project switcher. Chooses the project for every list page. See The project switcher.
New run. Starts a root-cause agent run on one or more scenarios. See Runs and hypotheses.
Work. The main pages, in this order:
| Page | What it's for |
|---|---|
| Dashboard | Root-cause agent activity: recent runs, runs this week, average run time, spend and the latest completed run. See Dashboard. |
| Failures | Every regression in the project with its status, jobs, pass rate, failures and signatures. Open one for its breakdown by component, failing tests, signatures and failing jobs with their logs. See Regressions and failures. |
| Signatures | Every distinct failure in the project, across all regressions. Filter, sort and open one to work on it. See Signatures. |
| Triage | The triage queue: open work by default, summary counts, filters and saved searches, bulk actions and CSV export. See The triage queue. |
| Runs | Every root-cause agent run in the project, newest first. See Runs and hypotheses. |
| Scenarios | The built-in scenarios the root-cause agent can run on. See Root-cause agent. |
| Data planes | Data planes registered for your organization, whether each is online, and which projects use them. See Data planes. |
| Bucketing | How the project groups failures into signatures, with a preview before you change anything. See Bucketing settings. |
| Triage rules | The project's automation, in evaluation order, and the Rule run log. See Triage rules. |
Data planes, Bucketing and Triage rules are settings pages. Each also shows tabs (Data planes, Bucketing, Rules) so you can move between them.
Agents. Hypothesizer is the root-cause agent; selecting it opens Runs. Entries marked Soon aren't available yet and can't be selected.
Data plane box. Near the bottom, a small box shows the DV Forge version, or offline
with a red dot when the app can't reach the DV Forge API. Its status dot doesn't report on
your own data planes. For that, open Data planes.
Footer. A User guide link, the app version, and the theme toggle (see Theme). The gear icon next to them is disabled: there's no settings screen there yet.
Workspace rail. The narrow strip at the far left. The DV Forge mark takes you to the Dashboard. The + button below it is disabled.
The project switcher¶
Most of what you see in DV Forge belongs to one project, so the app needs to know which project you're working in:
- What it changes. Every list page (Failures, Signatures, Triage, Runs,
Bucketing, Triage rules and the Rule run log) shows the selected project. The
app passes it to the API as
?project=org-slug/project-slugon every request. - Where it's kept. Your choice is stored in this browser for a year. Another browser, or a colleague, has its own selection.
- When nothing is selected, or you lose access to the selected project, the app falls
back to your landing project:
defaultin your oldest organization, else the first project there alphabetically. - Pages for one item work regardless. A signature, regression, run or log page opens by its id and works whichever project is selected. Actions on that page (triage, comments, labels) apply in the item's own project. So a link a colleague sends you opens correctly as long as you have access to its project.
The switcher lists every project in every organization you belong to. Projects are created through the API today; see Projects, roles and tokens.
Live updates¶
Pages that show triage work refresh themselves as things change, so two people triaging at once see each other's changes without reloading:
| Page | Refreshes when |
|---|---|
| A regression | Jobs are processed (while it's live), and signatures in it are triaged, merged or split |
| Signatures, a signature, Triage | Any signature in the project changes |
| Triage rules, a rule, Rule run log | Any signature in the project changes, which includes rule actions |
| Bucketing | A re-bucket is queued, starts, fails or finishes |
| A run | The run makes progress (while it's running) |
The app keeps a stream open to DV Forge for these pages and reconnects if it drops. If the stream keeps failing, the page polls instead, so it never goes stale for long.
Failures, Runs and the Dashboard don't refresh by themselves: reload them to see new regressions or runs.
Notifications¶
The bell at the top of the sidebar shows how many unread notifications you have and checks for new ones every 60 seconds. Select it to see your 30 most recent notifications; select one to open its signature. You're notified about signatures assigned to you or that you watch: a new assignment, a regression, a finished or failed root-cause run, or a rule's Notify action. Notifications are in-app only today. See Notifications for the full list and how to watch a signature.
Theme¶
The app opens in dark mode. Use the sun or moon button in the sidebar footer to switch between dark and light. The app remembers your choice in this browser.