Generated at:
Topology Node
Definition
One service in the topology. service is the identity; join edges to
nodes on (namespace, name).
Identifies a service: an OpenTelemetry resource grouped by
service.namespace + service.name.
Field names are unprefixed because the property carrying this object
already qualifies them (service.name, not service.serviceName).
That is a deliberate divergence from StarredServiceRef, whose
prefixed names are already shipped to clients and cannot be renamed
without a breaking change, so the two stay separate rather than being
consolidated.
service: a service that reported telemetry of its own. Itsstatisticsare read from its own RED metrics.inferred: a peer named only by an edge, so it has no RED metrics here andstatisticsis absent; read its edges instead. Four causes, and the response does not distinguish them: a peer that reports no telemetry at all, such as a database, a broker or a third-party API; a service whose own telemetry did not arrive; a service pastnodeLimit; and a service excluded byfilterbut still calling one that matched. The last two are ordinary services —inferredhere means "not in this response's service list", not "not a service".unknown: the placeholder for calls that arrived with no identifiable caller, such as a rootSERVERspan or a request whose trace context was broken in transit. At most one per response, and not a real peer. It exists so the traffic it carries is visible rather than silently dropped.
"service""inferred""unknown"Absent — the key is omitted, not sent as null — when the node has
no RED metrics of its own. Always so for inferred and unknown
nodes, and for a service node whose statistics could not be
computed.
Used by 1
These schemas and endpoints reference this type directly.