Skip to main content

ENTITIES_SCHEMA

Static ENTITIES_SCHEMA 

Source
static ENTITIES_SCHEMA: LazyLock<SchemaRef>
Expand description

Schema of semantic_entities — the node set of the graph, one row per entity observed in a time window. Must match the registry derivation projection.

Columns:

  • observed_at — TIME INDEX; the 60s time bucket the entity was observed in.
  • window_start — start of that observation window.
  • window_end — end of the window (window_start + 60s).
  • fresh_until — time up to which the entity is considered present; equals window_end for derived rows (the graph is a sliding window, not a current-state table: an entity exists in a query window only if it has observed evidence there).
  • entity_type — the entity’s type, e.g. service, host, k8s.pod, process, service.instance (the OTel-style, possibly dotted, type).
  • entity_id — canonical identifier: the identifying values in declared order, escaped and joined.
  • entity_id_attrs — JSON object of the identifying attributes, so a consumer holding an id can tell which columns it came from.
  • scope — namespace/environment the id is scoped to; empty when none.
  • descriptive — JSON snapshot of the entity’s descriptive (non-identifying) attributes; NULL when no descriptive columns were declared.
  • source_tables — JSON array of the telemetry tables that contributed this entity.