at.happyproto.fleet.getIngestHealth

Report lag, clock skew and schema-version spread. Lag and skew are separate facts and must not be averaged together. Admin only.

Repository @happyproto.at did:plc:mo7vq4jbioxwafy5zkcc3eux namespace authority
Details · query
Kindquery
Authorityfleet.happyproto.at
Indexed

Query

query · GET

Output

application/json

have

integer

History available, when accruing.

lag

ref
Reference

need

integer

History required, when accruing.

itemsref
Reference

skewed

array
itemsref
Reference

status

requiredstring

Why a figure is absent. Branch on this, never on field presence.

  • knownValues: ok | accruing | withheld

unit

string
  • knownValues: days | snapshots

windowDays

integer

Errors

AuthRequired

This endpoint requires an authenticated caller.

Forbidden

The caller is not a HappyProto admin.

Upstream

The telemetry store could not be queried.

#lag

object

Properties

max

requiredinteger

p50

requiredinteger

p90

requiredinteger

#schemaVersion

object

Properties

instances

requiredinteger

version

requiredinteger

#skew

object

Properties

aheadSeconds

requiredinteger

Seconds the snapshot was stamped ahead of receipt. A wrong clock makes every delta from this instance suspect.

instanceId

requiredstring

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • HappyView version distribution and upgrade lag. Admin only.

  • Where one instance sits in its size cohort. Withheld below a cohort of 10: a percentile over fewer is not an aggregate, it is individual data with a statistic drawn over it. Admin only.

  • Fleet and per-instance growth rates from instance_daily_deltas. Counter resets are excluded by the view, so a wiped volume lowers no rate. Admin only.

  • Fleet-wide failure signals, derived from each instance's most recent snapshot. Admin only.

  • Counter resets — the negative deltas instance_daily_deltas discards. A reset is a restored backup, a wiped volume, a re-provision or a wrong clock. Admin only.