Performance Metrics
The One Status collects response time and availability data for components with automated monitoring enabled. Metrics are visible in the management console and optionally on the public status page.
Metrics Overview
Metrics are collected only for components where automated monitoring is configured with a URL, interval, timeout, and expected status codes. Components updated manually do not generate metric data.
| Metric | Description |
|---|---|
| Uptime percentage | Percentage of monitored time the component was operational (90-day rolling) |
| Response time | How long each HTTP health check took to respond (in milliseconds) |
| Check status | Whether each individual check passed (up), failed (down), or was slow (degraded) |
Response Time Chart
In the management console, click any monitored component to open its detail view. The Response Time chart shows average response time per hour over the past 24 hours (adjustable).
- X axis: Time (hourly buckets)
- Y axis: Response time in milliseconds
- Color coding: Green (fast), yellow (slow but within threshold), red (timeout or failure)
Use this chart to identify:
- Gradual performance degradation over time
- Spikes correlated with maintenance or deployments
- Time-of-day patterns (e.g., slow during business hours vs. off-hours)
Recent Checks Table
The Recent Checks table shows individual check results, newest first:
| Column | Description |
|---|---|
| Timestamp | When the check ran |
| Status | up, down, or degraded |
| Response Time | Milliseconds to receive a response |
| HTTP Code | The HTTP status code returned |
| Error | Error message if the check failed (e.g., timeout, connection refused) |
This is the most granular view of component health. Use it to verify that checks are running and to understand the exact nature of failures.
Metrics Aggregation
Raw check data (individual check results) is stored and aggregated on an hourly schedule:
- Hourly metrics: Average response time, uptime count, down count per hour
- Daily metrics: Rolled up from hourly data; used for the 90-day uptime bar on the public page
Hourly aggregation runs automatically every hour. The public-facing 90-day uptime bar reflects the daily aggregation.
Showing Metrics on the Public Page
Two settings in page configuration control metric visibility on the public page:
| Setting | What It Shows |
|---|---|
| Show Uptime Percentage | 90-day rolling uptime % and the colored uptime bar per component |
| Show Response Time | (Reflects whether monitoring is configured) |
Enable Show Uptime Percentage in Settings to make the uptime bar visible to clients. This is recommended — it demonstrates your reliability over time.
Component-Level Uptime API
For developers building custom dashboards or portal widgets, component uptime data is available via the public API (authenticated for admin views, unauthenticated for public):
Public endpoint (per component):
GET /api/public/{subdomain}/components/{componentId}/uptime
Authenticated endpoint (admin):
GET /api/components/{componentId}/uptime?days=90
GET /api/components/{componentId}/response-time?hours=24
GET /api/components/{componentId}/checks?limit=50
The public uptime endpoint returns daily uptime percentages for the past 90 days, suitable for rendering a custom uptime chart.
Metric Limitations
- Metrics require automated monitoring to be configured — manually-managed components do not have metric data
- The check origin is The One Status infrastructure. Network issues between The One Status and your service may create false-positive downtime readings
- Response time measures the round-trip time from The One Status servers to your endpoint, not from your clients' locations
- Data retention for individual check results is 90 days; aggregated daily metrics are also retained for 90 days