Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Shashank-H/gaiter-gaurd/llms.txt

Use this file to discover all available pages before exploring further.

GaiterGuard provides two health check endpoints for monitoring service availability and database connectivity.

​
Liveness check

Returns a basic health status without performing any external checks. Use this endpoint for liveness probes in container orchestration.

​
Response

​
status
string
Always returns "ok" if the service is running

​
Example

curl http://localhost:3000/health
Response
{
  "status": "ok"
}
This endpoint does not check database connectivity. It only confirms the HTTP server is running and accepting requests.

​
Readiness check

Performs a database connectivity check to verify the service is ready to handle requests. Use this endpoint for readiness probes in container orchestration.

​
Response

​
status
string
Returns "ready" when all dependencies are available
​
database
string
Connection status: "connected" or error message

​
Example

curl http://localhost:3000/ready
Success (200)
{
  "status": "ready",
  "database": "connected"
}
Failure (503)
{
  "error": "Database connection failed",
  "statusCode": 503
}
If the database is unavailable, this endpoint returns a 503 Service Unavailable status. Configure your orchestrator to restart or replace the service if this check fails repeatedly.

​
Kubernetes configuration

Use these endpoints in your Kubernetes deployment: 
livenessProbe:
  httpGet:
    path: /health
    port: 3000
  initialDelaySeconds: 10
  periodSeconds: 30
  timeoutSeconds: 5
  failureThreshold: 3

readinessProbe:
  httpGet:
    path: /ready
    port: 3000
  initialDelaySeconds: 5
  periodSeconds: 10
  timeoutSeconds: 3
  failureThreshold: 2

​
Docker Compose healthcheck

healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
  interval: 30s
  timeout: 5s
  retries: 3
  start_period: 10s
Both endpoints are unauthenticated and can be called without an Agent-Key or Authorization header.

Build docs developers (and LLMs) love

Get started for freeTalk to us