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.
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.