-
Notifications
You must be signed in to change notification settings - Fork 1.3k
Add Bill Overview page and callouts for Plan & Usage LA launch #35456
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from all commits
Commits
Show all changes
31 commits
Select commit
Hold shift + click to select a range
0f239d4
Add Bill Overview docs for Plan & Usage LA launch (March 24)
rebeccagadzuk 9cfbdc9
Add Bill Overview screenshots (light mode + partial dark mode)
rebeccagadzuk e8eb0f9
Remove dark mode screenshots (pending, to be added later)
rebeccagadzuk 6a5f981
Fix toggle button labels and callout link rendering
rebeccagadzuk b763156
Update bill_overview intro: add description, remove estimates note
rebeccagadzuk 4b464c0
Remove estimated_cost from sub-org cost trends permission row
rebeccagadzuk def6da7
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk f87d7bc
Update config/_default/menus/main.en.yaml
rebeccagadzuk 199c145
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk 2693d73
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk 446dca4
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk e7a5aa5
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk a14429d
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk 70d10a8
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk a6b58ec
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk 8741e3f
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk 729ab49
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk ee9c4e8
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk 1d760d6
Add intro sentence to Permissions section
rebeccagadzuk e286c99
Update section title to 'Revert to the previous layout'
rebeccagadzuk 634e9bc
Remove accidental inline comment from Global filters section
rebeccagadzuk 4db053b
Clarify Billing Dimension filter description with examples
rebeccagadzuk b164d89
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk 8fb5f51
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk 274319e
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk b0d161d
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk b49d370
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk 7bc7227
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk 5b5799c
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk f349d53
Remove Cost Type filter from Product List section
rebeccagadzuk 2f09186
Merge branch 'master' into rebecca.gadzuk/bill-overview-la-docs
rebeccagadzuk File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
140 changes: 140 additions & 0 deletions
140
content/en/account_management/plan_and_usage/bill_overview.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,140 @@ | ||
| --- | ||
| title: Bill Overview | ||
| description: View Datadog costs, usage trends, and projected end-of-month costs in a single page, with daily breakdowns, product-level detail, and multi-organization filtering. | ||
| further_reading: | ||
| - link: "account_management/plan_and_usage/cost_details/" | ||
| tag: "Documentation" | ||
| text: "Cost Details" | ||
| - link: "account_management/plan_and_usage/usage_details/" | ||
| tag: "Documentation" | ||
| text: "Usage Details" | ||
| - link: "account_management/billing/usage_attribution/" | ||
| tag: "Documentation" | ||
| text: "Usage Attribution" | ||
| - link: "cloud_cost_management/datadog_costs/" | ||
| tag: "Documentation" | ||
| text: "Datadog Costs" | ||
| --- | ||
|
|
||
| View Datadog costs, usage trends, and projected end-of-month costs in a single page, with daily breakdowns, product-level detail, and multi-organization filtering. | ||
|
|
||
| The [**Bill Overview** page][1] gives administrators a single view of Datadog costs and usage. It is automatically enabled during the phased rollout starting March 2026. | ||
|
|
||
| ## Global filters | ||
|
|
||
| The following filters apply to the **Bill Overview** page: | ||
|
|
||
| - **Product Category**: Filter all views by broader product family, such as Infrastructure, APM, Logs, Security, or AI/ML. | ||
| - **Billing Dimension**: Filter to a specific billing or metering dimension (for example, Infra Hosts, Indexed Logs, or Synthetic Browser Tests). | ||
| - **Sub-Org**: Filter to a specific child organization. | ||
| - **Group by Sub-Org**: Toggle to group costs by sub-organization. | ||
| - **Time range**: Select a billing period. Use the backward and forward arrows to navigate from month to month. | ||
|
|
||
| ## Cost summary | ||
|
|
||
| At the top of the page, the cost summary shows: | ||
|
|
||
| - **Estimated cost to date**: Total estimated cost for the days elapsed in the current billing period | ||
| - **Projected total**: Estimated total cost if current usage patterns continue through end of month, with month-over-month percentage change | ||
|
|
||
| ## Daily Cost Breakdown | ||
|
|
||
| Below the cost summary, the **Daily Cost Breakdown** stacked bar chart shows costs broken down by billing dimension for each day of the selected period. Each color in the chart represents a different billing dimension. Click the expand icon to view the chart full screen. | ||
|
|
||
| {{< img src="account_management/plan_and_usage/bill-overview-main-light.png" alt="Bill Overview page showing the cost summary header, Daily Cost Breakdown stacked bar chart, and Trends tab" >}} | ||
|
|
||
| ## Trends tab | ||
|
|
||
| The **Trends** tab displays products worth investigating based on four sort options: | ||
|
|
||
| - **Highest % Cost Change** | ||
| - **Highest Cost Change ($)** | ||
| - **Highest Total Cost** | ||
| - **Highest % Usage Change** | ||
|
|
||
| Select a sort option to update the cards displayed. Each product card shows: | ||
|
|
||
| - **Total Cost** for the period | ||
| - **Projected EOM** cost | ||
| - **Month-over-month change**, displayed as a percentage badge | ||
| - **Daily Cost** bar chart spanning the previous and current month | ||
| - **Usage**, displayed as total units consumed, in natural units; for example, PB (petabytes) of scanned data, Custom Metrics; displayed only on Total Cost and Usage-related cards | ||
|
|
||
| Click **View Details** on any card to open the [product detail page][2]. | ||
|
|
||
| {{< img src="account_management/plan_and_usage/bill-overview-trends-light.png" alt="Trends tab showing product cards sorted by Highest Total Cost" >}} | ||
|
|
||
| ## Product List tab | ||
|
|
||
| The **Product List** tab shows all billing dimensions in a table with cost and usage side by side. | ||
|
|
||
| Click anywhere on a product row to open the [product detail page][2]. Hover over the end of a row to quickly create a cost monitor for that billing dimension. | ||
|
|
||
| #### Table columns | ||
|
|
||
| | Column | Description | | ||
| |---|---| | ||
| | Billing Dimension | Name of the product or billing dimension | | ||
| | Cost — Total | Cost billed to date for the period | | ||
| | Cost — Proj. EOM | Projected end-of-month total cost | | ||
| | Cost — Change | Dollar and percentage change vs. the prior period | | ||
| | Usage — Total | Total usage in natural units | | ||
| | Usage — Change | Usage change vs. the comparison period | | ||
|
|
||
| Toggle between **Monthly** and **Daily** views using the controls above the table. Download the full table as a `.csv` file using the **Download as CSV** button. The table is paginated, displaying 10 rows per page by default. | ||
|
|
||
| {{< img src="account_management/plan_and_usage/bill-overview-product-list-light.png" alt="Product List tab showing the billing dimensions table with Cost and Usage columns" >}} | ||
|
|
||
| ## Product detail page | ||
|
|
||
| Click **View Details** on a Trends card or click any row in the **Product List** table to open the product detail page for a single billing dimension. | ||
|
|
||
| {{< img src="account_management/plan_and_usage/bill-overview-detail-light.png" alt="Product detail page showing Cost Overview and Usage Overview sections with daily bar charts" >}} | ||
|
|
||
| ### Cost Overview | ||
|
|
||
| - **Total Cost**: Total cost billed to date for the selected period | ||
| - **Projected Cost Change**: The projected dollar and percentage change vs. the prior period | ||
| - **Projected EOM**: Estimated total cost at end of month | ||
| - **Daily Cost** bar chart: Day-by-day cost for the previous and current month, with the current month highlighted. Hover over any bar to see the cost for that day. Toggle **Show Usage Charges Only** to isolate on-demand charges. | ||
| - **Drilldown in Cloud Cost**: Click to open Cloud Cost Management, pre-filtered to the selected billing dimension. | ||
|
|
||
| ### Usage Overview | ||
|
|
||
| - **Total Usage**: Total units consumed for the selected period | ||
| - **Usage Change**: Change in usage vs. the prior period (amount and percentage) | ||
| - **Usage breakdown by sub-dimension**: Individual usage totals for each sub-dimension. For example, Sensitive Data Scanner lists Scanned Events, Scanned Logs, Scanned RUM Sessions, and Scanned Spans separately. | ||
| - **Usage Types** bar chart: Day-by-day usage stacked by sub-dimension | ||
| - **Allotment Usage**: Progress bar showing consumed vs. contracted allotment; displays ">100%" when usage exceeds the allotment | ||
| - **Drilldown in Usage Attribution**: Click to open **Usage Attribution**, pre-filtered to the selected billing dimension. | ||
|
|
||
| ## Revert to the previous layout | ||
|
|
||
| If your organization is on the new **Bill Overview** and you prefer the previous layout, click **Disable Preview** in the page header. This toggle is available to all organizations and persists for your session. | ||
|
|
||
| {{< img src="account_management/plan_and_usage/toggle-back-header.png" alt="Bill Overview page header showing the Disable Preview button" >}} | ||
|
|
||
| To return to **Bill Overview**, click **Enable Preview** in the header. | ||
|
|
||
| ## Permissions | ||
|
|
||
| The following permissions are required to access each section of Bill Overview: | ||
|
|
||
| | Section | Required permission | | ||
| |---|---| | ||
| | Bill Overview (cost data) | `BILLING_READ` | | ||
| | Usage Tab | `USAGE_READ` | | ||
| | Plan Details | `BILLING_READ` | | ||
| | Billing History | `BILLING_READ` | | ||
| | Usage Attribution | `USAGE_READ` + Enterprise or Pro plan | | ||
| | Sub-org cost trends | Parent org must have `suborg_cost_trends` enabled | | ||
|
|
||
| For information on managing permissions, see [Role Based Access Control][3]. | ||
|
|
||
| ## Further reading | ||
|
|
||
| {{< partial name="whats-next/whats-next.html" >}} | ||
|
|
||
| [1]: https://app.datadoghq.com/billing/bill-overview | ||
| [2]: /account_management/plan_and_usage/bill_overview/#product-detail-page | ||
| [3]: /account_management/rbac/ | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Binary file added
BIN
+326 KB
static/images/account_management/plan_and_usage/bill-overview-detail-light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+346 KB
static/images/account_management/plan_and_usage/bill-overview-main-light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+471 KB
...c/images/account_management/plan_and_usage/bill-overview-product-list-light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+360 KB
static/images/account_management/plan_and_usage/bill-overview-trends-light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+123 KB
static/images/account_management/plan_and_usage/toggle-back-header.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.