Test Observability
CTRF
Also known as: Common Test Report Format
CTRF (Common Test Report Format) is a JSON-based test report format with a published schema and explicit fields for retry attempts, flaky outcomes and the producing tool’s original status.
In CTRF v0.2.0, a report requires results, reportFormat and specVersion. The results object contains tool, summary and tests. Each test requires name, status and duration. This version is a pre-1.0 Working Draft; check the version your producer emits and your consumer supports.
The written specification defines retryAttempts as the history before the final result: two retries require two earlier attempts, and the test object represents attempt three. A flaky outcome is a final pass after at least one failed attempt. These relationships need semantic checks beyond the JSON Schema’s structural validation; optional rawStatus can preserve the original status only if the producer supplies it and the consumer retains it.
CTRF gives retry history a shared shape, but it is not the only format that can carry it: JUnit XML extensions such as Maven Surefire’s also represent reruns and flaky failures. Support depends on the integration. Microsoft Testing Platform offers experimental CTRF reporting, and Jenkins has a CTRF publishing plugin. Emit JUnit alongside CTRF when another consumer requires it, rather than assuming either format preserves every field end to end.
- The v0.2.0 schema requires three top-level fields: results, reportFormat and specVersion.
- Status has five values: passed, failed, skipped, pending, other; rawStatus is optional.
- Retry counts, prior attempts and flaky outcomes must agree with the written specification, not just pass a schema check.
Learn more
Related terms
Sources
See it in your own test results
Qualflare detects flaky tests, clusters failures by root cause, and scores release risk from the test results you already produce in CI. Start free.
Start free with Qualflare← Back to the testing & observability glossary.
Last reviewed November 14, 2026