Infrastructure · Data Structures
MetricReading
Quantitative value bound to a Metric definition
Definition
Mechanism
A realized value under a referenced Metric definition. The reading binds its value to the definition that supplies the target property, derivation rule, and value schema. Observation time and dimensions may scope the value without redefining it.
Invariants
- Definition Conformance: `value` conforms to the `value_schema` declared by the definition identified by `metric_ref`.
Risks
Failure modes
Definition Mismatch
a value produced under one Metric definition is interpreted or compared under another.
Relationships
Builds on
References
Definition of a quantitative property and its value semantics
Used by
Reference
Data schema
{
"type": "object",
"required": [
"metric_ref",
"value"
],
"properties": {
"metric_ref": {
"type": "string",
"description": "Identifier of the Metric definition used; a full Sema ID when the definition is a vocabulary pattern"
},
"value": {
"description": "Number or finite numerical structure conforming to the referenced Metric's value_schema"
},
"observed_at": {
"type": "string",
"description": "Optional time, interval, event, batch, or immutable version that scopes the reading"
},
"dimensions": {
"type": "object",
"description": "Optional labels that locate the reading within dimensions allowed by the Metric definition"
}
}
}