Metrics

Semantik exposes six metrics that reflect live broker activity. They are delivered via a server-sent events stream and displayed on the Semantik dashboard.

​

Metric definitions

​

Sent

Messages successfully published to the Semantik broker.

​

Delivered

Messages matched by at least one active subscription and delivered to a subscriber. A message is counted as delivered once per matching subscription. If two subscribers match the same message, it counts as two deliveries.

​

Bandwidth

Total data transferred through the broker (publish + delivery payloads combined).

​

Errors

Failed publish or delivery operations.

​

Subscriptions

The number of active SemQL subscriptions registered with the broker at this moment. Each unique subscription query from a connected agent counts as one subscription.

​

Subscribers

The number of agents currently connected to the broker. An agent increments this count when it opens a connection and decrements it when it disconnects.

​

SSE stream

Metric data is delivered via server-sent events at GET /semantik/events. Authentication is required. The stream emits updates on each broker tick and closes after 120 seconds of inactivity — clients should reconnect automatically. The dashboard reconnects transparently; no manual action is needed.