---
title: "observability"
summary: "Declared logging, metric and alerting intent. Validated and planned, but the local engine runs nothing continuous for it."
status: intent-only
generated: true
read_when:
  - "Recording observability intent that another system will act on"
---

> **Intent only**
>
> These values are validated and carried into plans, but the local engine runs no
> continuous collectors or alert managers. Status reports them as declared, not
> managed.

This page is generated from the same Go declarations the loader enforces, so it
cannot drift from what `ob validate` accepts.

## Fields on this page

`alerts` · `enabled` · `logs` · `metrics` · `retention` · `unhealthy_after`

## Reference

| Field | Type | Default | What it does |
| --- | --- | --- | --- |
| `alerts` | object | — | Declared alerting intent. Continuous management is not currently provided. |
| `alerts.unhealthy_after` | string | — | Desired duration of unhealthy state before alerting. Expects a duration such as 30s, 5m, 1h30m or 14d. |
| `logs` | object | — | Declared log-retention intent. Continuous management is not currently provided. |
| `logs.enabled` | boolean | `false` | Declare that log collection is desired. |
| `logs.retention` | string | — | Desired log-retention period. Expects a duration such as 30s, 5m, 1h30m or 14d. |
| `metrics` | object | — | Declared metric-collection intent. Continuous management is not currently provided. |
| `metrics.enabled` | boolean | `false` | Declare that metric collection is desired. |