diff --git a/docs/cloud/features/costs_savings.md b/docs/cloud/features/costs_savings.md new file mode 100644 index 000000000..a8e8b3c94 --- /dev/null +++ b/docs/cloud/features/costs_savings.md @@ -0,0 +1,46 @@ +# Data Warehouse Costs and Savings with Tobiko + +Understanding and managing data warehouse costs is challenging. Tobiko Cloud helps by tracking your data warehouse costs and integrating them into the Tobiko Cloud UI. + +Tobiko Cloud tracks data warehouse cost estimates per model for BigQuery and Snowflake projects. It also estimates how much money Tobiko Cloud has saved you by skipping unnecessary model reruns. + +## Supported Data Warehouse Pricing Plans + +Tobiko Cloud supports costs and savings data for these data warehouse pricing plans: + +- BigQuery On Demand +- Snowflake Credits + +## Data Warehouse Cost Configuration + +If you use a supported pricing plan, visit Settings to configure Tobiko Cloud's cost estimates. + +![Image highlighting location of the Settings link in the left site navigation](./costs_savings/costs-navigation.png) + +On the General settings page (1), select your pricing plan (2), enter your costs, and then save (3). + +![Annotated image showing locations of the general settings link, pricing plan form fields, and save button](./costs_savings/costs-steps.png) + +## Where to find cost and savings information + +Estimated costs and savings are displayed on the homepage, production environment page, runs and plans pages, and individual model pages. + +Cost information on each page will look similar to this: + +![Example of costs and savings data as seen on the Tobiko Cloud homepage](./costs_savings/costs-example.png) + +### Savings Categories + +When calculating your data warehouse costs, we also calculate how much you saved by using Tobiko! + +Tobiko Cloud comes with even more change categorization capabilities than open-source SQLMesh, such as advanced column-level impact analysis. + +Cost savings are broken up into three main categories: + +- **Prevented Reruns**: If SQLMesh already executed a change in one environment, we won't rerun it in another environment (backfills from development environments are reused when it is safe to do so). +- **Unaffected Downstream**: SQLMesh understands SQL, so we skip re-execution if a downstream model is not affected by an upstream change. +- **Virtual Environments**: With Virtual data environments, new environments can be created without running any computations at all. + +### Where to find cost savings information + +Cost savings are included in most places costs are displayed. Find how much you've saved using Tobiko by viewing the homepage, production environment page, or individual model pages. diff --git a/docs/cloud/features/costs_savings/costs-example.png b/docs/cloud/features/costs_savings/costs-example.png new file mode 100644 index 000000000..20dd443e0 Binary files /dev/null and b/docs/cloud/features/costs_savings/costs-example.png differ diff --git a/docs/cloud/features/costs_savings/costs-navigation.png b/docs/cloud/features/costs_savings/costs-navigation.png new file mode 100644 index 000000000..8978669c1 Binary files /dev/null and b/docs/cloud/features/costs_savings/costs-navigation.png differ diff --git a/docs/cloud/features/costs_savings/costs-steps.png b/docs/cloud/features/costs_savings/costs-steps.png new file mode 100644 index 000000000..037baf699 Binary files /dev/null and b/docs/cloud/features/costs_savings/costs-steps.png differ diff --git a/mkdocs.yml b/mkdocs.yml index 5c2a4f777..b4aa39507 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -106,12 +106,13 @@ nav: - Cloud Features: # - "Alerts & Notifications": cloud/features/alerts_notifications.md - cloud/features/debugger_view.md - # - cloud/features/data_catalog.md + - cloud/features/data_catalog.md # - cloud/features/model_freshness.md - Scheduler: - "Cloud": cloud/features/scheduler.md - cloud/features/scheduler/airflow.md - cloud/features/scheduler/dagster.md + - "Cost & Savings Estimates": cloud/features/costs_savings.md # - Observability: # - cloud/observability/monitoring.md # - "Measures & Dashboards": cloud/observability/measures_dashboards.md