Tutorial

Review and debug a failed test

Operational tutorial for triaging failed runs with logs and artifacts.

Overview

Operational tutorial for triaging failed runs with logs and artifacts.

Tutorial details

Audience
QA engineer
Duration
30 min
Prerequisites
Failed run available

Tutorial steps

Open failed run

Runs → select failed run.

Navigation: Console Home quick actions or the project wizard for new initiatives. Use ⌘K / Ctrl+K to jump to any surface.

Verification: Confirm organization and team context in the Console header before making changes.

Analyze timeline

Review orchestration events and failure point.

Navigation: Console Home quick actions or the project wizard for new initiatives. Use ⌘K / Ctrl+K to jump to any surface.

Verification: Note project, run, or agent IDs if you may need support escalation.

Inspect logs and artifacts

Download logs; review screenshots if present.

Navigation: Console Home quick actions or the project wizard for new initiatives. Use ⌘K / Ctrl+K to jump to any surface.

Verification: Confirm UI state matches your runbook. Retry once on transient errors before opening a ticket.

Compare or rerun

Compare with prior run or rerun after fix.

Navigation: Console Home quick actions or the project wizard for new initiatives. Use ⌘K / Ctrl+K to jump to any surface.

Verification: Confirm UI state matches your runbook. Retry once on transient errors before opening a ticket.

Expected outcome

Failure root cause identified or documented for escalation.

After completing this tutorial

  • Capture run IDs and screenshots for your team runbook
  • Share learnings with QA, SRE, or platform stakeholders
  • Proceed to related how-to guides for operational hardening

Continue learning

Was this page helpful?

01The operational surface

One surface for posture, operations, and what needs attention next.

The Zof home is not a marketing dashboard. It is the operational surface engineering, QA, and SRE teams use every day, quality posture, in-flight runs, coverage by module, and the actions a leader should look at next.

OPERATIONAL KPIs

  • Runs
  • Coverage
  • Risk

Live across every environment you ship to.

WORK SPINE

  • Specs
  • Tests
  • Schedules

From specification to scheduled regression.

GUARDRAILS

  • RBAC
  • SSO
  • audit

Every action attributable to a named human.

STAGING · LIVE/home
Zof AI home command center showing 12 runs at 94% pass, 3 open critical issues, 84% coverage, four module traceability bars, the specification pipeline, upcoming schedules, and recommended next actions with an active-runs sidebar.
Home view · Checkout Service · Staging · captured live from the product.
  • 01 · RUNS · 24H

    94% pass

    12 runs across staging

  • 02 · COVERAGE

    84%

    Across four modules

  • 03 · ACTIVE RUNS

    3 running

    Live on this branch

  • 04 · NEXT ACTIONS

    Recommended

    Triage gaps, new spec

Review and debug a failed test | Zof AI Documentation