Skip to content

Commit 307c269

Browse files
committed
docs: turn the observability objections into a scannable pushback table
1 parent 46dd6a8 commit 307c269

1 file changed

Lines changed: 5 additions & 12 deletions

File tree

README.md

Lines changed: 5 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -105,18 +105,11 @@ failure into a **structured fault**.
105105
> scan tool. UDS / DTC diagnostics sit *above* the signal layer, as structured, queryable
106106
> state. Robotics just hasn't drawn it yet.
107107
108-
- **"I'll just set an alert."** A threshold alert fires on a raw signal and is gone - no
109-
entity, no lifecycle, no history, and it means something different on every robot. A fault is
110-
confirmed, persisted, entity-attributed state you can query later - and, being SOVD, it means
111-
the same thing across robots and vendors. Alerting pages a human; diagnostics gives a machine
112-
an answer.
113-
- **It has to survive a fleet.** Visualization is O(humans) - one operator, one timeline, and
114-
nobody scrubs 400 of them. A structured fault is O(1): the same code and lifecycle aggregate
115-
across the fleet, so *"which 12 of 400 robots have a confirmed navigation fault right now?"*
116-
is a query, not a person.
117-
- **You can't act on a plot.** Observability is read-only by design. A structured fault is the
118-
precondition for doing something about it - gating an OTA on robot health, triggering
119-
remediation. You can't safely patch what you haven't first diagnosed as a fault.
108+
| Common pushback | Why a structured fault still wins |
109+
|---|---|
110+
| *"I'll just set an alert."* | A threshold alert fires on a raw signal and is gone - no entity, no lifecycle, no history, and it means something different on every robot. A fault is confirmed, persisted, entity-attributed state - and, being SOVD, it means the same thing across robots and vendors. **Alerting pages a human; diagnostics gives a machine an answer.** |
111+
| *"I'll just watch the fleet dashboard."* | Visualization is O(humans) - one operator, one timeline, and nobody scrubs 400 of them. A structured fault is O(1): the same code and lifecycle aggregate across the fleet, so *"which 12 of 400 robots have a confirmed navigation fault right now?"* is a query, not a person. |
112+
| *"I can already see it fail."* | Observability is read-only by design. A structured fault is the precondition for doing something about it - gating an OTA on robot health, triggering remediation. **You can't safely patch what you haven't first diagnosed as a fault.** |
120113

121114
So it is not a replacement for your observability stack - it is the **diagnosis layer
122115
underneath it**. medkit flags and persists the fault (readable by dashboards, fleet managers

0 commit comments

Comments
 (0)