AutoMerge is generally available

Generated at:

Component schema

TopologyNode

object1 direct reference

Definition

One service in the topology. service is the identity; join edges to nodes on (namespace, name).

ServiceRefrequired

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.

TopologyNodeKindrequired
  • service: a service that reported telemetry of its own. Its statistics are read from its own RED metrics.
  • inferred: a peer named only by an edge, so it has no RED metrics here and statistics is 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 past nodeLimit; and a service excluded by filter but still calling one that matched. The last two are ordinary services — inferred here 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 root SERVER span 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"
allOf

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.