Docs/Dashboards Automation/Widgets

Widgets

A widget is one chart on a custom dashboard. It queries your traces, observations or scores and draws the result. Widgets live in a project-wide library, so one widget can be added to several dashboards.

ℹ

Create a widget with Add Widget > Create New Widget on a dashboard. The widget library is the Widgets tab under Gauge AI → Custom Dashboards, where you can open a widget to edit it, or delete it. A widget that is still on a dashboard must be removed from that dashboard before you delete it.

Build a widget

The widget form has a live preview and these settings.

Data selection

SettingOptions
ViewTraces, Observations, Scores Numeric or Scores Categorical.
MetricsWhat to measure, with an aggregation. Aggregations are count, sum, average, min, max, p50, p75, p90, p95 and p99.
FiltersNarrow the data, for example to one trace name, environment, model or tag.
Breakdown dimensionOptional grouping, for example by model, trace name, user, tag, environment, prompt name or Agent Id.

Agent Id on the Observations view is the agent that made each model call, and is empty for calls with no agent. Budget AI calls made with a key linked to an agent carry that agent. For a ready-made view of cost per agent, see Agent Cost Analysis.

A widget that breaks down or filters by Source, Gateway key or Gateway model group (Budget AI traffic) is hidden on dashboards unless the deployment turns these widgets on. See Self-hosted deployments.

Examples of measures per view:

ViewMeasures include
Tracescount, latency, total tokens, total cost, observation and score counts
Observationscount, latency, time to first token, input, output and total tokens, tokens per second, input, output and total cost
Scores Numericvalue, count
Scores Categoricalcount, broken down by value

Visualization

GroupChart types
Time SeriesLine Chart, Vertical Bar Chart
Total ValueBig Number, Horizontal Bar Chart, Vertical Bar Chart, Histogram, Pie Chart, Pivot Table
  • Histogram takes a number of bins from 1 to 100.
  • Pivot Table groups by several dimensions with subtotals and a grand total, and can have a default sort column and order.
  • Bar, pie and pivot charts take a breakdown row limit from 0 to 1000.

Give the widget a Name and optional Description, then save it.

Scores on widgets

Scores are a view, not a chart type. To chart a quality score, choose Scores Numeric and, for example, average value over time as a Line Chart, or value as a Histogram for its distribution. Choose Scores Categorical to count labels, for example as a Pie Chart.

On a dashboard

Hover a widget to see its actions: drag to move, Edit widget for your project's widgets or Copy widget for an ANTS widget, Remove from dashboard, and download as CSV. Only download is shown without Gauge AI write access. Removing a widget takes it off this dashboard only; it stays in the widget library and on other dashboards. On an ANTS template, these actions first create your own editable copy of the dashboard, see Start from a template.

Dashboard filters

The date range and filters set on a dashboard apply on top of each widget's own filters. See Custom Dashboards.

Next steps

© 2026 ANTS Platform, Inc.Docs v1.0 · Last updated June 2026