Observability

Vorian Connect surfaces real-time operational metrics — message throughput, auto-verification rates, processing latency, delivery status, and edge agent health — on a single dashboard. Interface engineers and lab managers get continuous visibility into how the system is performing without logging into servers or querying databases.

How It Works

What's Included

Where It Fits

Observability is the operational heartbeat of Vorian Connect. It sits at the top of the dashboard navigation and is designed to be the first screen a lab manager checks in the morning. The metrics answer the core operational questions: Is traffic flowing? Are results auto-verifying? Are any agents offline? Is the system keeping up with message volume?

The observability page is complementary to the Trace Inspector. While the Inspector is for deep-diving individual messages, observability is for scanning system health at a glance. Both are tenant-scoped — each lab sees only its own metrics. The SSE hub ensures that all users within a tenant see consistent, up-to-date data without browser refresh.

Technical Details (for evaluators)

The SSE hub (package sse) maintains per-tenant channels with fan-out to all connected dashboard clients. Events are published through Redis for cross-instance distribution — when the gateway processes a message, it publishes an event to Redis, and every gateway instance's SSE hub forwards it to connected clients. The hub supports TLS-secured Redis connections via REDIS_TLS=true for production deployments.

The observability API at /api/observability returns a snapshot with total message counts, verification outcome breakdowns (grouped by ACK code and verify status), processing latency averages, payload size averages, auto-verify rate, and per-analyte throughput. The dashboard polls this endpoint and renders color-coded outcome bars — green for auto-verified, yellow for flagged, red for rejected, slate for pending, orange for parse errors.

The Prometheus metrics endpoint on port 9091 exposes standard counters and gauges for message throughput, latency histograms, delivery success rates, and edge agent connection counts. Labs already running Prometheus/Grafana can ingest Vorian metrics alongside their existing infrastructure monitoring without additional tooling.

Last updated: May 17, 2026