API Documentation

Cloud Metrics API exposes lightweight HTTPS endpoints for operational telemetry, health checks, service status and edge availability reporting.

Authentication

Production ingestion endpoints normally require a service token issued to registered infrastructure agents. Public health endpoints do not require authentication.

Endpoints

GET /health200 OK

Returns current endpoint availability and basic service identity.

{
  "status": "ok",
  "service": "cloud-metrics-api",
  "region": "fi"
}

GET /v1/status200 OK

Returns public service availability for automated status checks.

POST /v1/metrics/batch202 Accepted

Accepts batched JSON telemetry generated by monitoring agents and edge service components.

POST /v1/events202 Accepted

Accepts operational events such as deploy signals, probe summaries and regional availability updates.

Rate limits

Rate limits vary by service token and deployment profile. Automated clients should use batching when submitting high-frequency telemetry.