Measurement and decisions
Extension metric providers
Register project-specific numeric metrics with stable identity, units, capability reporting, and fail-closed evidence validation.
Implement IKiwiPerformanceMetricProvider for a project-specific numeric metric. Give it a stable lowercase ID and a stable unit, register one provider instance with KiwiPerformanceMetricProviderRegistry, and select that ID/unit in the Performance Scenario.
Providers explicitly report initialization capability as Supported, Unsupported, Unavailable, PermissionDenied, or Invalid. Sampling failures and non-finite values invalidate the provider evidence; they are not replaced with zero. Selected extension metrics are written into the raw inventory in canonical order and the importer rejects undeclared, missing, duplicate, or reordered extension evidence.
The Complete Workflow sample ships a sample.entity_count provider and registration bootstrap. Use it as the minimum contract for your own provider; keep expensive measurement work out of the provider when it would materially perturb the benchmark.
Still stuck?
Bring the exact evidence with you.
Include Performance Lab and Unity versions, the scenario and Run Profile, target and build type, environment identity, focused logs, and only the smallest replayable evidence needed to reproduce the problem.