For the complete documentation index, see llms.txt. This page is also available as Markdown.

Building Widgets

Widgets are the building blocks of every dashboard. Each widget displays a specific metric, chart, or report, allowing you to monitor cloud costs, AI usage, infrastructure, savings opportunities, and operational insights from a single dashboard.

To add a widget:

  1. Open a dashboard.

  2. Click Add Widget.

  3. Select a widget creation method.

  4. Configure the widget.

  5. Add it to your dashboard.


Choose a Widget Creation Method

When you click Add Widget, OneLens provides two ways to create widgets.

  • Simple Widget Creator – Quickly add widgets using pre-configured reports and templates.

  • Query Builder – Build fully customized widgets by selecting your own data source, metrics, filters, and visualization.

Choose between the Simple Widget Creator for a guided experience or the Query Builder for complete customization.


Build a Widget using Query Builder

The Query Builder guides you through a series of steps to create a widget.


Step 1 : Select a Data Source

Begin by selecting the data source that contains the information you want to visualize.

Available modules may include:

  • Cost360

  • AI Cost & Usage

  • Kubernetes

  • Tickets & Insights

  • Policies

  • Anomalies

  • Budgets

  • Commitments

The available modules depend on your OneLens deployment.


Step 2 : Configure the Widget

Choose the data you want to display.

Configure the following:

  • Metric – Select the value to measure (for example, Cost, Savings, Token Usage, or Requests).

  • Aggregation – Choose how the data should be calculated, such as Sum, Average, Maximum, or Count.

  • Group By – Organize results by one or more dimensions such as Service, Account, Region, or Environment.

  • Top N (optional) – Limit the results to the highest-ranking records.

The available metrics and aggregations depend on the selected data source.


Step 3 : Apply Filters

Filters help narrow the data displayed in the widget.

You can filter by dimensions supported by the selected data source, including:

  • Date Range

  • Account

  • Service

  • Region

  • Environment

  • Cost Center

  • Cloud Provider

You can also configure the reporting granularity, such as Daily, Weekly, or Monthly, where supported.


Step 4 : Select a Visualization

Choose how the results should be displayed.

Dashboard V2 supports multiple visualization types, including:

  • KPI Card

  • Column Chart

  • Line Chart

  • Area Chart

  • Pie Chart

  • Table

  • Leaderboard

  • Treemap

  • Heatmap

Only visualization types compatible with the selected data are available.

Provide a widget name, review the preview, and click Add Widget to place it on the dashboard.


Supported Visualizations

Dashboard V2 automatically recommends and enables visualization types based on the selected data.

Visualization
Best Used For

KPI Card

Single metrics

Column Chart

Category comparisons

Line Chart

Trends over time

Area Chart

Continuous trends

Pie Chart

Distribution analysis

Leaderboard

Rankings

Table

Detailed analysis

Treemap

Hierarchical breakdowns

Heatmap

Two-dimensional comparisons


After Adding a Widget

Once added, widgets can be:

  • Moved using drag-and-drop

  • Resized

  • Edited

  • Deleted

Changes are not saved automatically. Click Save Changes to persist your dashboard layout.

Last updated