Observability & Ops

Metrics, logs, traces, SLOs, incidents, a live CMDB and release gating.

The operations plane: VRQGO for metrics, logs, traces, probes and burn-rate SLOs; OpsTrac for incident command, on-call rotations, paging and postmortems; a live CMDB with blast-radius and dependency graphs; and Droplet, the release-candidate gate that judges what is safe to ship.

Auth is one model across every service here — an SS-01 bearer token plus X-Tenant-Id on every /api/v1 route. Public base https://api.nexocloud.io/api/v1.

4 real backends, 85 operations.

Every path below is a real route from services/<svc>/openapi.json. Each service lists a representative slice of its full contract.

VRQGO Observability SS-06

26 operations

Metrics, logs, traces & SLOs — probes, LLM traces, burn-rate SLOs and evaluate-and-route alerting.

POST/api/v1/metricsRecord a metric sample.
POST/api/v1/logsIngest a structured log record.
POST/api/v1/slosDefine an SLO with an error budget.
GET/api/v1/slos/{name}/burnRead an SLO's burn rate.
POST/api/v1/slos/{name}/evaluate-and-routeEvaluate an SLO and route a breach to alerting.

OpsTrac SS-08

21 operations

Incident management — incidents, acks, escalation ladders, paging, runbooks and approved postmortems.

POST/api/v1/incidentsOpen an incident.
POST/api/v1/incidents/{id}/pagePage the on-call for an incident.
POST/api/v1/incidents/{id}/escalateEscalate an incident up the ladder.
POST/api/v1/incidents/{id}/postmortemFile a postmortem for review.

CMDB SS-29

26 operations

Configuration management — CIs, dependency graphs, blast-radius, ownership and posture.

POST/api/v1/cisRegister a configuration item.
GET/api/v1/cis/{id}/blast-radiusCompute the blast radius of a CI.
GET/api/v1/cis/{id}/dependenciesList a CI's dependencies.
GET/api/v1/graph/diffDiff the dependency graph over time.

Droplet SS-32

12 operations

Release-candidate gate — candidates, checks, verdicts, judged gating and lane sweeps.

POST/api/v1/candidatesRegister a release candidate.
POST/api/v1/candidates/{id}/checksRun gating checks against a candidate.
POST/api/v1/candidates/{id}/gateJudge the candidate and record a gate verdict.
GET/api/v1/candidates/{id}/verdictsRead a candidate's verdict history.

An SLO breach becomes an incident

A burn-rate SLO detects it, evaluate-and-route pages the on-call, and the CMDB shows exactly what else is in the blast radius.

Watch the SLOGET/api/v1/slos/{name}/burn

Error budget burn crosses the fast-burn threshold.

Route the breachPOST/api/v1/slos/{name}/evaluate-and-route

VRQGO evaluates and routes to alerting.

Open the incidentPOST/api/v1/incidents

OpsTrac opens the incident and starts the escalation ladder.

Scope the blastGET/api/v1/cis/{id}/blast-radius

CMDB shows every dependent service before you act.

Where it sits in the platform.

Observability & Ops does not reimplement the platform — it composes it. These are the services it leans on and the seams between them.

VRQGO (SS-06)

The telemetry spine — metrics, logs, traces, probes and burn-rate SLOs.

OpsTrac (SS-08)

Incident command, on-call rotations, paging and postmortems.

CMDB (SS-29)

The live inventory with dependency graph and blast-radius.

Droplet (SS-32)

The judged gate deciding which candidates are safe to release.