Expand description
The built-in derivation conventions of the entity graph, embedded as
conventions.yaml: the co-declared edge vocabulary,
the virtual-destination candidates, and the implicit declarations of
well-known Prometheus entity-descriptor metrics. The file is data shipped
with the binary, not an operator-editable configuration surface; explicit
greptime.semantic.entity.* declarations always override it.
Structs§
- Conventions
- The parsed, validated conventions file.
- Edge
Rule - A same-row co-declaration rule: a source-table row carrying both entity
identities witnesses
src -rel-> dst. - Implicit
Entity - One implicit entity declaration: of a whitelisted Prometheus or OTel info metric, or of a trace-v1 table’s flattened resource attributes.
- Virtual
DstCandidate - A span-attribute column that may name an uninstrumented peer, and the
connection_typeits match implies.
Constants§
- CONNECTION_
TYPES 🔒 - CONNECTION_
TYPE_ DATABASE - The
connection_typevalues a virtual-destination candidate may imply; the calls derivation branches on them when building edge attributes. - CONNECTION_
TYPE_ VIRTUAL_ NODE - ENTITY_
TYPES 🔒 - ENTITY_
TYPE_ CONTAINER - ENTITY_
TYPE_ GEN_ AI_ AGENT - ENTITY_
TYPE_ GEN_ AI_ MODEL - ENTITY_
TYPE_ GEN_ AI_ TOOL - ENTITY_
TYPE_ HOST - ENTITY_
TYPE_ K8S_ CONTAINER - ENTITY_
TYPE_ K8S_ NODE - ENTITY_
TYPE_ K8S_ POD - ENTITY_
TYPE_ K8S_ SERVICE - ENTITY_
TYPE_ K8S_ WORKLOAD - ENTITY_
TYPE_ PROCESS - ENTITY_
TYPE_ SERVICE - The built-in entity-type vocabulary. User-declared types are open-ended; the embedded conventions file must stay inside this set.
- ENTITY_
TYPE_ SERVICE_ INSTANCE - PROVENANCE_
AGENT - PROVENANCE_
ATTRIBUTE - PROVENANCE_
DECLARED - PROVENANCE_
TRACE - REL_
TYPES 🔒 - REL_
TYPE_ CALLS - The relationship vocabulary (the RFC’s rel_type table) and the edge provenances.
- REL_
TYPE_ CONTAINS - REL_
TYPE_ DEPENDS_ ON - REL_
TYPE_ INVOKES - REL_
TYPE_ OWNS - REL_
TYPE_ PART_ OF - REL_
TYPE_ RUNS_ ON - REL_
TYPE_ USES
Statics§
Functions§
- conventions
- The embedded conventions.
Errmeans the embedded file is broken — pinned by unit test, and propagated by the derivation paths rather than panicking. - parse 🔒
- validate 🔒