> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quixa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Proactive Health Checks

> Schedule lightweight health check suites to verify uptime, network connectivity, and latency SLAs before daily operations commence.

In distributed architectures, an unannounced outage in a single shared dependency (such as an Identity Provider, Payment Gateway, or Core Database) often cascades into dozens of broken integration tests, resulting in wasted engineering hours debugging false positives.

Quixa addresses this with **Proactive Automated Health Check Suites**.

```mermaid theme={null}
flowchart LR
    Cron["Hangfire Cron (Daily 08:30 UTC)"] --> Suite["Health Check Suite"]
    Suite --> Node1["GET /health/live (Core Gateway)"]
    Suite --> Node2["GET /health/ready (Identity Provider)"]
    Suite --> Node3["GET /health/db (SQL & Cache Status)"]
    Suite --> SLA{"Latency < 250ms & Status == 200?"}

    SLA -- "PASS" --> Green["Log Health SLA Passed 🟢"]
    SLA -- "FAIL" --> Alert["Dispatch Immediate Incident Alert 🚨"]
```

***

## 1. Why Proactive Health Checks?

* **Prevent False Positive Fatigue**: Verifies environment health before developers and QA squads initiate daily testing or before scheduled nightly regression suites execute.
* **Latency SLA Guard**: Catches degraded upstream response times before end-users experience production latency.
* **Automated Incident Early-Warning**: Dispatches instant webhook notifications to Slack, Microsoft Teams, or PagerDuty if any core microservice fails its heartbeat.

***

## 2. Anatomy of a Health Check Suite

A well-architected Health Check Suite is fast and lightweight:

1. **Shallow Checks**: Verifies network reachability and HTTP 200 response codes on public endpoints.
2. **Deep Checks**: Pings internal database connection pools, message broker readiness, and cache connectivity.
3. **Latency Thresholds**: Enforces strict performance assertions:
   ```handlebars theme={null}
   Response Time LESS_THAN 250 ms
   Status Code EQUALS 200
   body.status EQUALS "HEALTHY"
   ```

***

## 3. Automation via 3-Tier Hangfire Scheduling

Health Check Suites are scheduled directly from the Quixa UI using standard cron expressions:

* **Pre-Workday Routine**: Scheduled at `30 8 * * 1-5` (Every weekday at 08:30 UTC).
* **Continuous Micro-Monitor**: Scheduled at `*/15 * * * *` (Every 15 minutes) for continuous uptime monitoring.
* **Headless CI/CD Gate**: Executed in continuous delivery pipelines prior to launching full functional regression tests:
  ```bash theme={null}
  quixa run suite "Core Service Health" --fail-fast
  ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.