Skip to content

Metric.watched

Emitted each time a Metric is watched.

Metric.watch emits Metric.watched when it completes on a Metric.

PropertyValue
Emitted byMetric.watch
NounMetric
WakesNone.

Payload

Each delivery is an Event record. data holds what Metric.watch returns.

FieldTypeRequiredDescription
namestringrequiredMetric.watched.
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.watchWatchrequiredThe Watch that checks it.
data.metricMetricrequiredThe Metric now watched.
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.

Example

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