metrics:Metric Observation

https://publicschema.org/metrics/MetricObservation

candidate

One reported value against a Metric, with dimension values, period, and observation-level attributes. The observation / scoring separation extends from per-record scoring (Principle 6) to aggregate metrics: a MetricObservation is to a Metric what a ScoringEvent is to a ScoringRule. Scale is fixed by Metric.unit and Metric.multiplier; when UNIT_MEASURE also appears in attribute_values, it must equal Metric.unit. The observation cannot override scale.

JSON-LD JSON Schema CSV Definition (Excel) Template (Excel)

Supertypes

Event

Properties

Property Type Definition
Identifiers from Event concept:Identifier
Identifiers carried by this entity, such as national ID numbers, program IDs, or identifiers asserted by an identity document.
Metric uri The URI of the Metric this observation reports a value against.
Period concept:metrics/Period The temporal coverage of this observation.
Dimension values concept:metrics/DimensionValue
The ordered list of {dimension_uri, code} pairs that locate this observation in the metric's DSD. Ordering matches Metric.dimensions; every dimension declared on the Metric must have a value on every observation (W3C Data Cube integrity constraint IC-11).
Value number
The numeric value reported by this observation. Scale is fixed by Metric.unit and Metric.multiplier: for value_type proportion with unit unitless, the value is in 0..1; with unit PT, the value is in 0..100. The observation cannot override scale.
Attribute values concept:metrics/AttributeValue
The list of {attribute_uri, value} pairs that decorate this observation, series, or dataset. When UNIT_MEASURE appears here, it must equal Metric.unit.
Calculation URI uri The URI of the MetricCalculation definition this observation realises.
Execution URI uri
Optional URI of an execution record (provenance: software agent, run timestamp, parameter set). Light PROV-O alignment recommended; full execution-provenance shape is deferred.

Evidence

Not yet found in mapped delivery systems.

MetricObservation is bound to qb:Observation (W3C RDF Data Cube) and to the SDMX 3.0 Observation. Standards-aligned, not mapped-system-derived.