System Status: What the Footer Indicator Means
The colored dot in the footer is a live health check of clariBI's database, cache and workers. Here's what each colour means and how to fetch detailed status.
## The Status Indicator
The small colored dot at the bottom of every page is a **real-time health check**, not a static badge. It fetches from clariBI's monitoring API every time you load a page (cached for 5 minutes).
## What the Colors Mean
| Color | Label | What It Means |
|---|---|---|
| Green | All Systems Operational | Database, cache, and background workers are all responding normally. |
| Yellow | Degraded Performance | One or more services are slow or showing signs of stress. The platform is usable but may be slower than normal. |
| Red | Service Disruption | A critical service (database, cache, or background processing) is down or unreachable. Some features may not work. |
| Gray | Checking... | The status hasn't loaded yet (page just opened) or the health endpoint is unreachable. |
## What Gets Checked
The quick health check (the one the footer uses) tests three things:
1. **Database** runs a simple query (`SELECT 1`). Healthy if it responds in under 1 second.
2. **Cache (Redis)** writes a test value, reads it back, and deletes it. Healthy if the round-trip is under 200ms and the value is correct.
3. **Background Workers (Celery)** reads a heartbeat timestamp that workers write every 30 minutes. Healthy if the timestamp is less than 45 minutes old.
The overall status is the **worst** of the three. If the database is healthy but Redis is slow, the indicator shows yellow.
## Checking Detailed Status Yourself
You can hit the health endpoint directly:
- **Quick check:** `GET https://claribi.com/api/monitoring/health/`
- **Per-service breakdown:** `GET https://claribi.com/api/monitoring/health/?level=summary`
- **Full system report:** `GET https://claribi.com/api/monitoring/health/?level=detailed`
No authentication required. The response is JSON.
## If You See Red
A red indicator means something is genuinely wrong. If you encounter errors while using clariBI:
1. Wait 5 minutes and refresh — many issues are transient.
2. Check the indicator again — if it turns green, the issue resolved itself.
3. If it stays red, [contact support](/contact). Include the time you first noticed the issue.