# Metric.watched

URL: /business/events/Metric.watched · Id: `event:Metric.watched`

> Emitted each time a Metric is watched.

[Metric.watch](/business/nouns/metric/watch) emits `Metric.watched` when it completes on a [Metric](/business/nouns/metric).

| Property | Value |
| --- | --- |
| Emitted by | [Metric.watch](/business/nouns/metric/watch) |
| Noun | [Metric](/business/nouns/metric) |
| Wakes | None. |

### Payload
Each delivery is an [Event](/business/nouns/event) record. `data` holds what [Metric.watch](/business/nouns/metric/watch) returns.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | Yes | `Metric.watched`. |
| `at` | `datetime` | Yes | When it happened. |
| `seq` | `integer` | No | Its position in the namespace, one more than the Event before; any seq is a cursor into the history. |
| `data` | `json` | Yes | The Thing as the Action left it. |
| `data.watch` | [Watch](/business/nouns/watch) | Yes | The Watch that checks it. |
| `data.metric` | [Metric](/business/nouns/metric) | Yes | The Metric now watched. |
| `data.metric.query` | `text` | Yes | How it is computed. An agent never varies the Metrics it is judged by. |
| `data.metric.unit` | `string` | No | The unit, such as dollars or percent. |
| `data.metric.status` | `string` | Yes | One 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
}
```