Skip to content

Metric.defined

Emitted each time a Metric is defined.

Metric.define emits Metric.defined when it completes on a Metric.

PropertyValue
Emitted byMetric.define
NounMetric
MovesMetric draft to defined
WakesNone.

Payload

Each delivery is an Event record. data holds what Metric.define returns, and previous holds the state it left.

FieldTypeRequiredDescription
namestringrequiredMetric.defined.
atdatetimerequiredWhen it happened.
seqintegerIts position in the namespace, one more than the Event before; any seq is a cursor into the history.
datajsonrequiredThe Thing as the Action left it.
data.metricMetricrequiredThe defined Metric.
data.metric.querytextrequiredHow it is computed. An agent never varies the Metrics it is judged by.
data.metric.unitstringThe unit, such as dollars or percent.
data.metric.statusstringrequiredOne of draft or defined.
data.previous.statusstringrequiredThe status before this Event: draft.

Example

JSON
{
  "$id": "https://api.sb/kilnbakery.com/events/event_1",
  "$type": "Event",
  "name": "Metric.defined",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "metric": {
      "$id": "https://api.sb/kilnbakery.com/metrics/metric_1",
      "$type": "Metric",
      "query": "Example query",
      "unit": "Example unit",
      "status": "defined"
    },
    "previous": {
      "status": "draft"
    }
  },
  "seq": 1
}