Skip to content

Introduction ​

EasyTrace turns test-report files from CI or your machine into runs, failures, flaky-test history and coverage. It does not replace your test runner:

  1. Your test runner writes a report file (JSON or JUnit XML) — a flag or one line of config.
  2. When the tests finish, the EasyTrace CLI reads the report files and uploads them.
  3. The dashboard shows the run a few seconds later.
text
vitest / jest / playwright / cypress / mocha / pytest / phpunit ──► report file ──► easytrace CLI ──► EasyTrace

The CLI keeps your test command's exit code; upload problems are warnings unless you opt into --strict.

EasyTrace Overview shows new failures, recent suite runs and health trends.

Concepts ​

TermMeaning
OrganizationWorkspace for projects, members and usage.
ProjectOne codebase (usually one repository). Runs, test history and project tokens belong to a project.
SuiteA named group of tests uploaded together, e.g. unit, e2e, or one per package (server, web). Each suite of a build becomes its own run.
BuildOne CI pipeline or CLI invocation. Its suites share a build id.
RunThe results of one suite in one build: counts, failures, flaky tests, coverage, artifacts.
Flaky testA test with same-branch final pass/fail outcome changes whose change rate meets the project threshold. A retry fail followed by a pass is a passed result.
ShardPart of a suite run on another machine (parallel CI jobs). Shards with the same build id and suite merge into one run.
OriginCI or Local; local runs show their uploader.
New failure baselineThe latest earlier finished run of the same project and suite on the default branch, whether or not it has coverage. A failure that passed or was skipped in that run is a new failure.
Coverage baselineThe latest earlier finished run of the same project and suite on the default branch that has coverage. It may be older than the new failure baseline.

Supported reports ​

FormatWritten by
vitest-jsonVitest --reporter=json
jest-jsonjest --json --outputFile=…
playwright-jsonPlaywright json reporter
mochawesomeCypress with the mochawesome reporter (json=true)
mocha-jsonMocha --reporter json
pytest-xmlpytest --junit-xml=…
phpunit-xmlPHPUnit --log-junit …
junitAlmost every tool (JUnit XML)

Formats are detected from content, except pytest and PHPUnit: set pytest-xml or phpunit-xml. See Writing report files.

Two ways to authenticate ​

Developer machineCI
Credentialeasytrace login once per machineProject token in EASYTRACE_TOKEN
Projectproject in easytrace.config.jsonDecided by the token
Shown asLocal, uploaded by youCI

Details: Credentials and tokens.