---
slug: "MetricReading"
name: "MetricReading"
type: "Data Structures"
layer: "Infrastructure"
ref: "MetricReading#56a9"
sema_id: "sema:MetricReading#mh:SHA-256:56a9f18faad70147312f12c1cdb1bcea9cb5d1d61042831d1fe6bfa11414ab26"
tags: ["Infrastructure","Data Structures"]
updated: 2026-11-11
mindscape: "bootstrap"
index_url: https://mindscape.pages.dev/bootstrap/index.json
url: https://mindscape.pages.dev/bootstrap/MetricReading/
related: ["Metric","Feedback","Optimize","Result"]
---

# MetricReading

Quantitative value bound to a Metric definition

Layer: Infrastructure · Category: Data Structures

## Mechanism

A realized value under a referenced [Metric](https://mindscape.pages.dev/bootstrap/Metric.md) 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`.

## Failure modes

- Definition Mismatch: a value produced under one [Metric](https://mindscape.pages.dev/bootstrap/Metric.md) definition is interpreted or compared under another.

## Data schema

```json
{
  "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"
    }
  }
}
```

## Builds on

- [Metric](https://mindscape.pages.dev/bootstrap/Metric.md) (Infrastructure; References)

## Used by

- [Feedback](https://mindscape.pages.dev/bootstrap/Feedback.md) (Infrastructure; References)
- [Optimize](https://mindscape.pages.dev/bootstrap/Optimize.md) (Mind; References)
- [Result](https://mindscape.pages.dev/bootstrap/Result.md) (Infrastructure; References)

## Identity

- Sema ID: `sema:MetricReading#mh:SHA-256:56a9f18faad70147312f12c1cdb1bcea9cb5d1d61042831d1fe6bfa11414ab26`
- Ref: `MetricReading#56a9`

## Links

- [Pattern page](https://mindscape.pages.dev/bootstrap/MetricReading/)
- [View in the interactive graph](https://mindscape.pages.dev/bootstrap/#MetricReading)
- [JSON](https://mindscape.pages.dev/bootstrap/MetricReading.json)
- [Index of all patterns](https://mindscape.pages.dev/bootstrap/index.json)