NeXuS

Health Checks

Every NeXuS service exposes health and status endpoints for monitoring.

Health Endpoint Format

All services implement GET /health:

{
  "service": "service-name",
  "status": "healthy",
  "port": 4000,
  "uptime": 86400,
  "timestamp": "2026-02-14T06:19:07.261Z"
}

Status Endpoint Format

All services implement GET /status:

{
  "service": "service-name",
  "version": "1.0.0",
  "description": "Service Description",
  "status": "operational",
  "timestamp": "2026-02-14T06:19:07.261Z"
}

Service Health URLs

# Public services (via Traefik)
curl https://api.sebhosting.com/health
curl https://auth.sebhosting.com/health
curl https://cms.sebhosting.com/health
curl https://cdn.sebhosting.com/health
curl https://cache.sebhosting.com/health
curl https://waf.sebhosting.com/health
curl https://ai-gateway.sebhosting.com/health
curl https://mcp.sebhosting.com/health

MCP Health Check

The MCP server’s health endpoint also reports which tool modules are loaded:

{
  "service": "nexus-mcp-server",
  "status": "healthy",
  "port": 5001,
  "tools": ["containers", "services", "logs"]
}

Aggregated Health Check

Use the MCP nexus_health_check tool or the stats endpoint to check all services at once:

curl https://api.sebhosting.com/stats

This returns Docker container statuses, host metrics, and per-container resource usage.

Monitoring with MCP

Claude can run automated health checks:

> Use nexus_health_check to check all services

HEALTH CHECK (10/10 up)
───────────────────────────────────────────────────────
✓ frontend       200  https://nexus.sebhosting.com
✓ api            200  https://api.sebhosting.com/health
✓ auth           200  https://auth.sebhosting.com/health
✓ cms            200  https://cms.sebhosting.com/health
✓ cdn            200  https://cdn.sebhosting.com/health
✓ cache          200  https://cache.sebhosting.com/health
✓ waf            200  https://waf.sebhosting.com/health
✓ ai-gateway     200  https://ai-gateway.sebhosting.com/health
✓ grafana        302  https://grafana.sebhosting.com
✓ mcp            200  https://mcp.sebhosting.com/health

Docker Health Checks

Consider adding Docker health checks to your compose file for automatic container restarts:

services:
  api:
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:4000/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 10s

This site is open source. Improve this page.