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

MethodPathDescription
POST/api/v2/metrics/streamOpen a streaming ingest connection
GET/api/v2/healthLiveness probe