Skip to main content

Platform Usage

Monitor resource consumption across H2O AI Cloud with the Platform Usage dashboard. Track AI Unit usage and Enterprise h2oGPTe token consumption by workspace, user, service, or model.

The platform collects telemetry data continuously. You can view consumption at hourly intervals for recent date ranges or aggregate data to daily, weekly, monthly, or yearly views for longer time periods.

Platform Usage dashboard overview

Prerequisites

To access the Platform Usage dashboard, you must belong to both of these groups:

  • admins
  • telemetry-admin

To access Platform Usage, navigate to the dropdown on the top right corner, and select Platform Usage: Platform Usage dashboard overview

note

Contact your platform administrator if you need access to these groups.

Accessing Platform Usage

Select Platform Usage from the main navigation menu. The dashboard loads with the default view:

SettingDefault value
ResourceAI Unit Usage
Date rangeLast 30 days
GranularityDaily
Group byWorkspace

Resource types

The dashboard tracks two resource types. Select a resource type from the Resource dropdown in the filter panel.

AI Units are a normalized compute currency that represents CPU, memory, and GPU consumption.

CapabilityOptions
Group byWorkspace, User, Service, Tag
MetricsAI Units, CPU (Cores), Memory (GiB), GPU
Filter byWorkspace, User, Service, Tag

Dashboard components

Statistics cards

Summary cards appear at the top of the dashboard.

CardDescription
Max AI UnitsHighest single time-period total across all groups
Average AI UnitsTotal AI Units divided by number of time periods (label changes based on granularity, e.g., "Average Daily AI Units")
Group CountNumber of unique groups (label changes based on grouping, e.g., "Workspace Count" or "User Count")

Stacked bar chart

The main visualization displays consumption over time:

  • X-axis: Time periods based on the selected granularity
  • Y-axis: Metric values (AI Units, CPU cores, memory GiB, GPU count, or tokens)
  • Stacked bars: Each color represents one group; bar height shows the total for that time period

To see detailed information, hover over any bar. The tooltip displays:

  • Time period label
  • Total value across all groups
  • Per-group breakdown with color indicators

Chart tooltip

A legend below the chart maps each color to its group name. To reload data, select the refresh icon in the chart header.

Data table

The table below the chart presents the same data in tabular format:

  • First column: Group names with color indicators matching the chart (sticky when scrolling)
  • Remaining columns: One column per time period (scrollable horizontally)
  • Values: Formatted based on metric type (decimals for CPU/Memory, integers for GPU, abbreviations for tokens)

Data table

CSV export

To export data as CSV, select the download icon above the data table.

Includes all four metrics (AI Units, CPU, Memory, GPU) as separate columns per time period.

File naming: resource_usage_{startDate}_{endDate}_{groupBy}.csv

Filters and controls

All controls are in the filter panel on the right side of the dashboard.

Filter panel

Resource selector

Switch between AI Unit Usage and Enterprise h2oGPTe Token Usage. When you change the resource type:

  • The Group By dropdown updates to show resource-specific options
  • The metric selector changes to match the resource type
  • Entity filters reset to match the new resource type

Date range

To open the date range picker, select the date range button.

Date range picker

Quick presets (auto-fill dates and granularity):

PresetDate rangeDefault granularity
1 DayYesterday to todayHourly
7 Days7 days ago to todayDaily
MTDFirst of current month to todayDaily
1 Month30 days ago to todayDaily
3 Months90 days ago to todayDaily

Custom date range: Select any start and end date using the date pickers. The end date maximum is today; the start date maximum is yesterday.

Timezone: All dates display in your browser's local timezone.

A summary below the date range button shows the current granularity setting.

To update the dashboard, select Apply. To discard changes, select Cancel.

Granularity

Granularity controls the time bucket size. Available options depend on the selected date range:

GranularityMinimum rangeConstraintExample label
HourlyAnyMaximum 100 hourly buckets"1/15, 3:00 PM"
Daily2 daysMaximum 100 daily buckets"1/15/2026"
Weekly14 daysMaximum 100 weekly buckets"Jan 15, 2026"
Monthly60 daysMaximum 100 monthly buckets"Jan 2026"
Yearly730 daysNo maximum"2026"

If the current granularity becomes invalid for a new date range, the dashboard auto-corrects to a valid option.

Group by

Select how data is aggregated in the chart and table.

OptionDescription
WorkspaceGroup by workspace name
UserGroup by user display name
ServiceGroup by platform service
TagGroup by resource tag

Changing the group updates the chart immediately using prefetched data.

Metric type

Select which metric to display:

MetricUnit
AI UnitsAI Units (normalized compute)
CPU (Cores)CPU core count
Memory (GiB)Memory in gibibytes
GPUGPU count

Changing the metric updates the chart Y-axis label and values without refetching data.

Entity filters

Multi-select dropdowns let you filter data to specific entities.

Available filters: Workspace, User, Service, Tag

How to filter:

  1. Select items in the filter dropdowns. Checkmarks indicate pending selections.
  2. Select Apply to fetch filtered data.
  3. Select Reset to clear all filters and show unfiltered data.

Button states:

  • Apply is enabled when you have filter selections that haven't been applied yet.
  • Reset is enabled when any filters are active (pending or applied).

Entity Filter

note

When you change the date range, all entity filters automatically reset.

Sharing and bookmarking

Dashboard settings persist in the browser URL as query parameters:

  • Copy the URL to share your exact view with colleagues
  • Bookmark the URL to save a specific configuration
  • Use browser back and forward buttons to navigate through your view history

URL parameters

ParameterValuesDefault
resourceai_units, h2ogpte_tokensai_units
groupByworkspace, user, service, tag, modelworkspace
metricai_units, cpu, memory, gpuai_units
startDateYYYY-MM-DD format30 days ago
endDateYYYY-MM-DD formatToday
granularityhourly, daily, weekly, monthly, yearlydaily

Default values are omitted from the URL to keep URLs concise.

Example URLs

Default view (30 days, daily, workspace, AI Units):

/platform-usage

CPU usage by user for January 2026:

/platform-usage?groupBy=user&metric=cpu&startDate=2026-01-01&endDate=2026-01-31&granularity=daily

GPU usage by service:

/platform-usage?groupBy=service&metric=gpu

Enterprise h2oGPTe token usage by model:

/platform-usage?resource=h2ogpte_tokens&groupBy=model

Weekly workspace usage over 3 months:

/platform-usage?startDate=2025-11-01&endDate=2026-02-01&granularity=weekly

Monthly usage for a full year:

/platform-usage?startDate=2025-01-01&endDate=2026-01-01&granularity=monthly

Hourly usage for yesterday:

/platform-usage?startDate=2026-02-09&endDate=2026-02-10&granularity=hourly

Common tasks

Compare two workspaces over 3 months

  1. Set the date range to 3 Months with Daily granularity.
  2. Set Group By to Workspace.
  3. In the Workspace filter, select the two workspaces to compare.
  4. Select Apply.

View GPU usage by service for the past week

  1. Set the date range to 7 Days with Daily granularity.
  2. Set Group By to Service.
  3. Set Metric Type to GPU.

Identify which LLM models consume the most tokens

  1. Set Resource to Enterprise h2oGPTe Token Usage.
  2. Set Group By to Model.
  3. Set Token Type to Total Tokens.
  4. The chart displays token consumption by model.

Export a monthly CPU usage report

  1. Set a custom date range covering the desired months.
  2. Set Granularity to Monthly.
  3. Set Group By to your preferred dimension.
  4. Select the CSV download button above the table. The exported CSV includes all four metrics per time bucket.

Limitations

  • Granularity constraints: If the selected granularity becomes invalid for a new date range, the dashboard auto-corrects to a valid option.
  • Filter reset: Entity filters automatically reset when you change the date range. Filter state is not persisted in the URL.
  • Metric parameter scope: The metric URL parameter only applies to AI Unit Usage. It's ignored when viewing Enterprise h2oGPTe Token Usage.
  • Group by compatibility: The service and tag group options are only available for AI Unit Usage. If you switch to Enterprise h2oGPTe Token Usage with these groupings, the dashboard resets to workspace.
  • Backward compatibility: The URL parameter groupBy=component maps to service for backward compatibility with older bookmarks.
  • Invalid parameters: Unknown or malformed URL parameter values are silently ignored and defaults are used.

Feedback