at.happyproto.fleet.getHostMix

Categorical host facts across the fleet, with consent coverage. Keys whose values vary per instance, or that carry embedded documents, are named but not enumerated. Admin only.

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

Query

query · GET

Output

application/json

coverage

requiredref
Reference

facts

requiredarray

Only keys whose values repeat across instances. A value seen once per instance is a measurement, not a category.

itemsref
Reference

have

integer

History available, when accruing.

need

integer

History required, when accruing.

status

requiredstring

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

  • knownValues: ok | accruing | withheld

unit

string
  • knownValues: days | snapshots

varying

requiredarray

Host keys that are not a mix: values differ per instance, or are JSON documents. Named so a reader knows the key exists, without rendering one row per instance.

itemsref
Reference

Errors

AuthRequired

This endpoint requires an authenticated caller.

Forbidden

The caller is not a HappyProto admin.

Upstream

The telemetry store could not be queried.

#coverage

object

Properties

of

requiredinteger

A count over twelve of thirty instances is a different claim from a count over thirty.

sharing

requiredinteger

#fact

object

Properties

instances

requiredinteger

key

requiredstring

value

requiredstring

#varyingKey

object

Properties

distinctValues

requiredinteger

key

requiredstring

Similar lexicons

semantic match

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

  • The reporting fleet, one row per instance, from its most recent snapshot. Admin only.

  • Every host, and every tenant with its host, plan, owner and latest metered hour, for the staff fleet view. Staff only.

  • Disk and memory distribution, and bytes per record. Memory is reported as separate anonymous and file-backed figures and is never totalled. Admin only.

  • Lexicon counts and top-collection concentration. Reads tier-1 shape only; consent-gated lexicon names are not read here. Admin only.