Skip to main content

Date ranges & live mode

The Statistics dashboard is driven by two controls: a date range and a Live Mode toggle. The range decides which window every card and chart covers, and Live Mode swaps the historical view for a realtime stream. This page explains both, plus the automatic chart granularity that keeps series readable.

Date-range presets​

Pick a window with the From / To date pickers, or use a quick-range preset chip.

PresetWindow
TodayThe current day (UTC)
Last 7 daysTrailing 7 days
Last 15 daysTrailing 15 days
Last 30 daysTrailing 30 days
This monthStart of the current calendar month to now
Last monthThe full previous calendar month

The default range is the current calendar month, measured from start-of-month in UTC. This deliberately lines up with your billing counters, so the dashboard total and your invoiced usage cover the same period.

:::info Everything is UTC All ranges are interpreted in UTC. A "Today" or "This month" boundary is the UTC day or month, not your local one — this is what keeps the dashboard consistent with billing. :::

Automatic chart granularity​

Time-series charts automatically choose a bucket size from the length of the selected range. This keeps each series under roughly 200 points so charts stay legible at any zoom level.

Range lengthBucket size
≤ 1 day15 minutes
1–7 days1 hour
7–30 days6 hours
> 30 days1 day

:::note Coarse ranges, coarse detail Granularity is derived from the range, not chosen by you. A very wide window (for example a full year) is rendered in daily buckets — you will not get per-request detail from the charts. To inspect individual requests, use Raw access logs. :::

:::note Time-series margin on "today" Time-series queries add a +2h margin when the to bound reaches the current day (a timezone safety margin), while the summary and cache cards do not. A same-day chart and a same-day summary card can therefore cover slightly different windows. :::

Live Mode​

The Live Mode toggle (a Play / Stop button) switches the dashboard into realtime. While it is on, the historical view is hidden and the page polls GET /api/monitoring/stats/realtime every 5 seconds.

Live Mode shows:

  • A live requests-per-second (RPS) and bandwidth chart for the last 15 minutes (5-second buckets).
  • Current latency, error rate, and active visitors cards, computed over the last 5 minutes.
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.paradarum.com/api/monitoring/stats/realtime?propertyId=42"

The realtime endpoint takes only propertyId (optional) — it ignores from / to because its window is always the trailing 15 minutes.

:::warning Realtime bandwidth is in bits per second The realtime bandwidth series is in bits per second (bps), not bytes. To display megabits per second, divide by 1e6 (the dashboard does this for you to render Mbps). This differs from the historical traffic chart, whose bandwidth is in bytes. :::

Toggling Live Mode off reloads the historical view for your selected range and property.