Health Checks

QNSI services expose health endpoints for monitoring.

Endpoints

Service Health via Edge Gateway

All services expose health endpoints through edge-gateway:

GET /proxy/<service>/health
GET /edge/<service>/health

Example health checks:

# Check platform-api health
curl https://api.qnsi.heossi.com/proxy/platform/health

# Check all services health
curl https://api.qnsi.heossi.com/proxy/health

Note: Health check endpoints (GET/HEAD) bypass bot protection and rate limiting to allow monitoring systems to probe services reliably.

Direct Service Health

GET /health

Returns 200 if service is running:

{
	"status": "ok",
	"timestamp": "2024-01-15T10:30:00Z"
}

Readiness

GET /health/ready

Returns 200 if service can handle requests:

{
	"status": "ready",
	"checks": {
		"database": "ok",
		"cache": "ok",
		"hsm": "ok"
	}
}

Detailed health

GET /health/detailed

Requires authentication:

{
	"status": "healthy",
	"version": "1.2.3",
	"uptime": "72h15m",
	"checks": {
		"database": {
			"status": "ok",
			"latency": "5ms"
		},
		"cache": {
			"status": "ok",
			"hitRate": "0.95"
		}
	}
}

Health status codes

Status	HTTP Code	Meaning
ok	200	Fully healthy
degraded	200	Partially healthy
unhealthy	503	Not healthy

Kubernetes probes

livenessProbe:
  httpGet:
    path: /health
    port: 8080
  initialDelaySeconds: 10
  periodSeconds: 10

readinessProbe:
  httpGet:
    path: /health/ready
    port: 8080
  initialDelaySeconds: 5
  periodSeconds: 5

Dependency health

Services check dependencies:

• Database connectivity
• Cache availability
• HSM connectivity
• Upstream services