Widget types
| Widget | Best for |
|---|---|
| Cost trend | Showing spend over time with a line, area, or bar chart |
| Cost breakdown | Showing how groups contribute to total spend by service, account, team, product, or environment |
| Waterfall | Explaining which groups drove an increase or decrease between two periods |
| Doughnut | Showing the proportional split of a selected period |
| Table | Reviewing sortable cost data and exact values |
| KPI card | Displaying one number, such as total spend, cost per user, or Savings Plan coverage |
| Budget tracker | Comparing actual spend with a budget target |
Chart types
Choose the chart type based on the question the widget should answer.
| Chart type | Use it when |
|---|---|
| Bar chart | You need to compare grouped spend over time and see how each group contributes to the total. |
| Line chart | You need to compare trends across services, teams, or providers. |
| Area chart | You need a trend view that emphasizes total spend volume. |
| Doughnut chart | You need a proportional split for one period, such as spend by provider or team. |
| Waterfall chart | You need to explain what changed between the selected period and the reference period. |
| Table | You need exact values, sorting, or a top-cost breakdown. |
Waterfall charts
Waterfall charts show which services, accounts, teams, or products drove a cost increase or decrease between two periods. Use them during budget reviews, migration reviews, and cost-change explanations.
Doughnut charts
Doughnut charts show proportional spend for a selected period. Use them for high-level split views such as cost by provider, business unit, environment, or product.Tables
Table widgets show the data behind a chart. Use them when reviewers need exact values, sorting, or exportable cost breakdowns. Tables can include:- Selected-period cost
- Reference-period cost when comparison is enabled
- Absolute change
- Relative change
- Cost, usage, budget, or formula values
Budget vs actual widgets
Use a budget widget when you want to compare an approved with actual spend.Add the budget metric
Click Add Metric, open the budget tab, and choose the budget version you want to analyze.
Add related cost
Open the action menu for the budget metric and click Add related cost. Costory adds a cost metric scoped to the budget definition.
Break actual spend down
Set Group By on the related cost metric to the dimension you use for ownership, such as team, squad, or product line.
Color palettes
Each chart widget can use one of four color palettes. Choose a palette when you want dashboard visuals to stay readable across stacked bars, line charts, and grouped breakdowns.
Export widget SQL to BigQuery
BigQuery data exports let you query the same cost data shown in a dashboard widget from your own BigQuery project. Use this when you want to reuse dashboard logic in Looker, notebooks, dbt, or custom SQL without rebuilding filters.
Set up the BigQuery destination
Ask an Organization Admin to grant your BigQuery user or service account read access to the Costory export table under Integrations > Destinations. See BigQuery Data Exports for setup.
Open the dashboard widget
Open the dashboard that contains the widget you want to query outside Costory.
Related links
Create and organize dashboards
Add widgets to dashboards and organize them for teams.
Dashboard templates
Start with pre-built FinOps widgets.
Unit Economics
Add usage metrics and formulas to the queries behind widgets.
BigQuery Data Exports
Set up the destination used by SQL export.