Skip to main content

Console features

Day-to-day surfaces beyond the quickstart loop.

Assets — bulk CSV / JSON

On Assets:

  • Export CSV / Export JSON — downloads the current filter set (q, kind) via GET /api/v1/assets/export
  • Import — accepts .csv or .json; rows upsert by external_ref

Typical CSV header:

name,external_ref,kind,status,health,manufacturer,model,serial,site_id,latitude,longitude,stale_after_sec,metadata

Map — clustering

The Map page uses MapLibre clustered GeoJSON layers:

  • Dense pins collapse into count clusters (blue → amber → orange by size)
  • Click a cluster to zoom into its members
  • Click an unclustered pin to open the detail card
  • Site pins use blue; asset pins follow health (healthy / warning / critical / stale)

Incidents — severity + runbooks

When a threshold or stale automation opens an incident, Yard resolves a severity policy (highest priority match):

Match kindExampleEffect
capabilitytemperatureseverity + runbook for that signal
automationMissed heartbeatmatch by automation name
default(empty value)fallback for everything else

Seeded defaults include a critical temperature runbook and a warning heartbeat checklist. The Incidents detail panel shows the attached Runbook text.

Edit policies under Administration → Incident severity policies (GET/POST /api/v1/severity-policies, PATCH/DELETE …/{id}).