Getting started
Relay is a small internal API for pushing metrics between edge collectors and the aggregation service. This page covers the basics of authenticating and opening a stream.
POST /api/v2/metrics/stream HTTP/1.1 Host: relay.internal Content-Type: application/octet-stream ...
Authentication
Every collector authenticates with a per-node token issued during provisioning. Requests without a valid token receive 404 rather than 401, by design — endpoint existence isn't disclosed to unauthenticated callers.
Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /api/v2/metrics/stream | Open a streaming ingest connection |
| GET | /api/v2/health | Liveness probe |