Analytics

Client Health Scores

Current availability of customer health scoring

The Client Health Scores page is available at /analytics/health, but customer-level health reads and refresh are currently suspended. The page shows this boundary directly and does not load stored customer scores.

Current availability

Keva is keeping this feature unavailable until it has:

  • a dedicated customer-data authorization policy
  • an approved workspace aggregation policy
  • durable custody for score refresh work
  • a configured and deployed customer-facing version

Authenticated API requests fail closed while that work remains open:

OperationCurrent response
Read health scores503 with HEALTH_SCORE_READ_SUSPENDED
Refresh health scores503 with HEALTH_REFRESH_SUSPENDED

The existence of a page or API route is not evidence that customer scoring is active.

Operational signals are separate

Keva includes a separate five-minute scheduled check for a bounded database supporting signal. If that check is deployed, synchronized, and invoked, each run computes database connectivity, one recent-ticket query, audit-table readability, database size when that query is available, and the aggregate state of queued approval decisions and expirations.

The check attempts a required platform-audit insert when the computed state is degraded or unhealthy, and for a healthy result only on a run whose process clock minute is 0. Successful persistence requires the unapplied 0074 platform-audit ledger. Deployment, provider synchronization, scheduled execution, configured database behavior, and resulting audit rows are not available as customer-facing monitoring.

This job does not establish the health of the web application, API, workers, AI providers, integrations, or other external dependencies. It is not the Client Health Scores page and is not customer-facing monitoring.

Public liveness endpoint

GET /api/v1/health returns a shallow liveness object with status, version, and timestamp. It establishes that the route answered; it does not inspect or show whether downstream services are available.

What to expect

Until the feature is turned on, use the warning on the Client Health Scores page as the authoritative product state. Keva does not currently provide infrastructure monitoring or operational-control workflows through that page.