# airdress.idle.*

{/* Generated by scripts/generate-event-reference.mjs from https://schemas.airdress.co/operator/events/v1.json (operator v0.1.138).
    Do not edit by hand: run `pnpm generate:event-reference` and commit the result. */}

The events in the `airdress.idle` family. How to read a section, and what
each audience means, is on the [event reference](/events/) page.

## `airdress.idle.probe_deferred`

Owner debug

The idle reading was deferred: the operator's own probe is open.

One of the operator's readiness probes is open against the endpoint, so the connection count cannot tell it from a person. The reading is `Unknown`, which never reaps.

**Audience: owner.** About the airdress as a whole. Only the owner receives it: the owner's devices and the owner's subscriptions.

**Where it goes**

- **The operator's journal**, as one log line at this level, and **the event log**, where `airdress events tail` reads it.
- **Subscriptions** that name it, within its audience.
- Not functions bound to this operator's events: it is kept off that path as too frequent or too internal. A subscription with a function target still receives it.

**Versions**

- Version 1: first carried by operator v0.1.136.

**Data**

| Field | Type | Required | Description |
| ----- | ---- | -------- | ----------- |
| `port` | integer (uint16) | yes |  |
| `unit` | string | yes |  |

<details>
<summary>JSON Schema</summary>

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "The idle reading was deferred: the operator's own probe is open.\n\nOne of the operator's readiness probes is open against the endpoint, so the connection count cannot tell it from a person. The reading is `Unknown`, which never reaps.",
  "properties": {
    "port": {
      "format": "uint16",
      "minimum": 0,
      "type": "integer"
    },
    "unit": {
      "type": "string"
    }
  },
  "required": [
    "port",
    "unit"
  ],
  "title": "IdleProbeDeferred",
  "type": "object"
}
```

</details>

## `airdress.idle.reaped`

Owner info Functions

An on-demand unit nobody had used for its whole grace was stopped.

**Audience: owner.** About the airdress as a whole. Only the owner receives it: the owner's devices and the owner's subscriptions.

**Where it goes**

- **The operator's journal**, as one log line at this level, and **the event log**, where `airdress events tail` reads it.
- **Subscriptions** that name it, within its audience.
- **Functions bound to this operator's events** (`source: operator`).

**Versions**

- Version 1: first carried by operator v0.1.136.

**Data**

| Field | Type | Required | Description |
| ----- | ---- | -------- | ----------- |
| `unit` | string | yes |  |

<details>
<summary>JSON Schema</summary>

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "An on-demand unit nobody had used for its whole grace was stopped.",
  "properties": {
    "unit": {
      "type": "string"
    }
  },
  "required": [
    "unit"
  ],
  "title": "IdleReaped",
  "type": "object"
}
```

</details>

## `airdress.idle.reported`

Owner debug

The idle reaper's decision about one unit on one tick, including the decisions not to act. One per unit per tick.

**Audience: owner.** About the airdress as a whole. Only the owner receives it: the owner's devices and the owner's subscriptions.

**Where it goes**

- **The operator's journal**, as one log line at this level, and **the event log**, where `airdress events tail` reads it.
- **Subscriptions** that name it, within its audience.
- Not functions bound to this operator's events: it is kept off that path as too frequent or too internal. A subscription with a function target still receives it.

**Versions**

- Version 1: first carried by operator v0.1.136.

**Data**

| Field | Type | Required | Description |
| ----- | ---- | -------- | ----------- |
| `unit` | string | yes |  |
| `verdict` | string | yes | The verdict as the journal prints it (`Busy \{ connected: 1 \}`, `Draining \{ .. \}`, `Reap`, `Unknown \{ .. \}`, `NotRunning`, `NeverDrains`). |

<details>
<summary>JSON Schema</summary>

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "The idle reaper's decision about one unit on one tick, including the decisions not to act. One per unit per tick.",
  "properties": {
    "unit": {
      "type": "string"
    },
    "verdict": {
      "description": "The verdict as the journal prints it (`Busy { connected: 1 }`, `Draining { .. }`, `Reap`, `Unknown { .. }`, `NotRunning`, `NeverDrains`).",
      "type": "string"
    }
  },
  "required": [
    "unit",
    "verdict"
  ],
  "title": "IdleReported",
  "type": "object"
}
```

</details>