EvidenceTier enum

Evidence tier for a detector's threshold or heuristic.

Each detector and feature in Sleuth ships with a claimed tier documenting how its numbers were validated. The tiers are deliberately coarse — a four- valued ordinal lets a reader see at a glance how much to trust a number without having to interpret a free-form sentence.

Ordering (lowest → highest): unvalidated < reproducerOnly < runtimeVerified < externallyCited.

The enum is frozen — new tiers require a semver major bump because downstream consumers (docs, validation tooling, external dashboards) key presentation and gating logic off the four values.

Inheritance
Available extensions
Annotations
  • @experimental

Values

unvalidated → const EvidenceTier

No validation beyond the author's intuition or a passing unit test. Surface this transparently in docs so users know to calibrate.

reproducerOnly → const EvidenceTier

A synthetic reproducer (test or demo app) fires the detector deterministically. Proves the detector emits on the intended pattern but does not prove the threshold is calibrated against real-world traffic.

runtimeVerified → const EvidenceTier

The detector was exercised on a real device / profile-mode run with real data, and the threshold was tuned against that observation. This is the default target tier for shipping detectors.

externallyCited → const EvidenceTier

The threshold traces back to an external cited source — Flutter SDK constant, dart-lang issue, Material/Cupertino spec, published benchmark, WCAG / Material Design a11y guideline. Numbers in this tier have a reference URL in their metadata.

Properties

hashCode → int
The hash code for this object.
no setterinherited
index → int
A numeric identifier for the enumerated value.
no setterinherited
name → String

Available on Enum, provided by the EnumName extension

The name of the enum value.
no setter
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited

Constants

values → const List<EvidenceTier>
A constant List of the values in this enum, in order of their declaration.