Skip to main content

Overview

The Usage Tab displays product usage data from your connected usage sources or the Usage Push API. It shows metric summaries, trend indicators, and time-series charts for each configured usage metric.

Controls

Time Range

Select a time range using quick presets or a custom date range:
  • Presets - All time, Last 7 days, Last 30 days, Last 90 days, Month to date, Quarter to date, Year to date
  • Custom - Pick specific start and end dates from the calendar
Date controls stay available while loading and after empty results or errors. Change the range to inspect another period, or use Try again after a loading error. If a very large range cannot load, try a narrower period.

Granularity

Toggle between Daily, Weekly, or Monthly aggregation for all charts and data.

Metric Summary Row

The top of the tab shows all available usage metrics, wrapping onto additional rows when needed. Each metric card shows:
  • Label - Metric name
  • Current value - Formatted with abbreviations (K, M, B)
  • Sparkline - Micro line chart showing the trend
  • Trend indicator - Percentage change with an up/down/flat arrow, color-coded (green for up, red for down, gray for flat)
Click a metric card to select it and highlight its chart below. When there is no observed value to show, the metric displays —; an observed zero remains 0. For metrics aggregated as Latest, the headline can retain the last known observation on or before the selected end date, even when it predates the selected period. Last observed shows that older observation’s date; it does not establish recent activity. Charts still show only observations in the selected period, leaving gaps intact. Percentage comparisons require usable current and previous observations and a nonzero previous value. A carried-forward headline alone does not create a valid trend, and a missing trend does not mean usage is flat. A loading failure is shown separately from an empty period.

Usage Charts

Charts render in one of two modes depending on your data:

Product-Grouped View

When usage metrics are associated with products, they display in collapsible accordion sections grouped by product. Each product section shows:
  • Product name and metric count
  • Metric cards in a grid layout, each showing current value, trend, and sparkline

Flat View

When no product grouping exists, each metric renders as an individual time-series line chart showing:
  • Chart title - "{Metric Label} Over Time"
  • Trend badge - "Growing over {period}", "Declining over {period}", or "Stable over {period}"
  • Line chart - Smooth curve with area fill, color-coded by trend direction (green for growth, red for decline, indigo for stable)
  • Interactive tooltip - Hover to see the date and value at any point
Charts aggregate data based on the selected granularity (daily, weekly, or monthly).