# Health Checks & Diagnostics {#health-checks--diagnostics}


Built-in health checks for monitoring application and dependency status.


## Health Check Endpoint {#health-check-endpoint}


```
GET /api/health
```

**Response:**

```json
{
  "status": "ok",
  "info": {
    "database": { "status": "up" },
    "redis": { "status": "up" },
    "disk": { "status": "up" },
    "memory": { "status": "up" }
  },
  "error": {},
  "details": {
    "database": { "status": "up" },
    "redis": { "status": "up" }
  }
}
```


## Check Types {#check-types}


| Check    | Description                    | Threshold  |
| -------- | ------------------------------ | ---------- |
| Database | PostgreSQL/SQLite connectivity | 3s timeout |
| Redis    | Redis connectivity             | 3s timeout |
| Disk     | Available disk space           | > 10% free |
| Memory   | Available memory (RSS)         | < 80% used |


## Load Balancer Integration {#load-balancer-integration}


Configure your load balancer to use the health endpoint:

```nginx
upstream gauzy_api {
  server api1:3000;
  server api2:3000;
}

server {
  location /api/health {
    proxy_pass http://gauzy_api;
  }
}
```


## Kubernetes Probes {#kubernetes-probes}


```yaml
livenessProbe:
  httpGet:
    path: /api/health
    port: 3000
  initialDelaySeconds: 30
  periodSeconds: 10

readinessProbe:
  httpGet:
    path: /api/health
    port: 3000
  initialDelaySeconds: 5
  periodSeconds: 5
```


## Related Pages {#related-pages}


- [Monitoring & Observability](https://sourcey-gauzy.pages.dev/devops/monitoring/index.md) — production monitoring
- [Production Deployment](https://sourcey-gauzy.pages.dev/devops/production-deployment/index.md) — deployment guide