Developer documentation

Realtime API

Use the BeaconMetrics event gateway to subscribe to live service health, deployment events, latency windows and incident notifications.

Overview

BeaconMetrics exposes a secure realtime gateway for live operational dashboards and alerting integrations.

Authentication

API clients authenticate with bearer tokens generated from the dashboard.

Authorization: Bearer bm_live_xxxxxxxxxxxxx

WebSocket Gateway

Production clients connect to the realtime gateway over WSS:

wss://be-be.blakeney.net/api/realtime

Example subscription message:

{
  "type": "subscribe",
  "channels": ["service.health", "latency.window", "incident.feed"]
}

REST Endpoints

GET /api/v1/health Returns current API health.
GET /api/v1/status Returns public service status.
GET /api/v1/regions Returns active telemetry regions.