diff --git a/config/_default/menus/main.en.yaml b/config/_default/menus/main.en.yaml index 57b29141d98..9dddc498eb3 100644 --- a/config/_default/menus/main.en.yaml +++ b/config/_default/menus/main.en.yaml @@ -9189,11 +9189,16 @@ menu: parent: account_management identifier: safety_center weight: 12 - - name: Plan and Usage + - name: Plan & Usage url: account_management/plan_and_usage/ parent: account_management identifier: account_management_plan_and_usage weight: 13 + - name: Bill Overview + identifier: account_management_bill_overview + url: account_management/plan_and_usage/bill_overview/ + parent: account_management_plan_and_usage + weight: 1300 - name: Cost Details identifier: account_management_cost_details url: account_management/plan_and_usage/cost_details/ diff --git a/content/en/account_management/plan_and_usage/_index.md b/content/en/account_management/plan_and_usage/_index.md index ff2c8a15d77..a9e36744115 100644 --- a/content/en/account_management/plan_and_usage/_index.md +++ b/content/en/account_management/plan_and_usage/_index.md @@ -1,10 +1,14 @@ --- -title: Plan and Usage Settings +title: Plan & Usage description: Access usage reports, plan settings, and billing history for your Datadog account, including multi-organization usage tracking and cost analysis. --- [Administrators][1] can access the [organization settings][2] by clicking Plan & Usage from the Account menu in the bottom of the left side navigation or by selecting Plan & Usage from the header dropdown at the top of the Personal Settings page. +{{< callout url="" btn_hidden="true" header="New: Bill Overview" >}} +A new **Bill Overview** experience is now in Limited Availability and will start rolling out automatically to all organizations starting March 2026. [Learn more](/account_management/plan_and_usage/bill_overview/). +{{< /callout >}} + ## Usage reports View hourly usage of your account across all billable parameters as well as the top 5000 custom metrics submitted. If your organization is the parent-organization in a [multi-org account][3], you can also view the usage of child-organization accounts by toggling between "Overall" and "Individual Organizations" at the top of the page. Individual child-organization accounts are isolated. They are only able to view their own usage and custom metrics. @@ -41,6 +45,7 @@ Usage data for trial products appears in the **Usage & Cost** tab. You are not b {{< img src="account_management/plan_and_usage/trial-management-usage.png" width="70%" alt="Usage & Cost section showing a trial product metric with an indicator icon and tooltip explaining the estimated cost" >}} [1]: /account_management/users/default_roles/ -[2]: https://app.datadoghq.com/account/billing +[2]: https://app.datadoghq.com/organization-settings/ [3]: /account_management/multi_organization/ -[4]: mailto://success@datadoghq.com +[4]: mailto:success@datadoghq.com +[5]: /account_management/plan_and_usage/bill_overview/ diff --git a/content/en/account_management/plan_and_usage/bill_overview.md b/content/en/account_management/plan_and_usage/bill_overview.md new file mode 100644 index 00000000000..5c3fc37d991 --- /dev/null +++ b/content/en/account_management/plan_and_usage/bill_overview.md @@ -0,0 +1,144 @@ +--- +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 (for example, "Estimated Mar 1–Mar 18 Cost"). +- **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 surfaces 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** (percentage badge) +- **Daily Cost** bar chart spanning the previous and current month +- **Usage** (total units consumed, in natural units — for example, PB of scanned data, custom metrics) (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. + +#### Additional filter (Product List only) + +- **Cost Type**: Filter to show **Committed** costs, **On-Demand** costs, or **All** costs. + +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 using the **Download as CSV** button. The table is paginated (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**: Opens Usage Attribution pre-filtered to this 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/ diff --git a/content/en/account_management/plan_and_usage/cost_details.md b/content/en/account_management/plan_and_usage/cost_details.md index 0a0e17d301c..1a4977adb1a 100644 --- a/content/en/account_management/plan_and_usage/cost_details.md +++ b/content/en/account_management/plan_and_usage/cost_details.md @@ -13,6 +13,10 @@ further_reading: text: "Managing multiple-organization accounts" --- +{{< callout url="" btn_hidden="true" header="New: Bill Overview" >}} +A new Bill Overview experience is now in Limited Availability and will start rolling out automatically to all organizations starting March 2026. [Learn more](/account_management/plan_and_usage/bill_overview/). +{{< /callout >}} + ## Overview Cost Summary and Cost Chargebacks help you understand your estimated month-to-date, projected end-of-month, and historical Datadog costs. Cost data is available for the past 15 months. @@ -162,3 +166,4 @@ Products billed by the sum of usage throughout the month include indexed logs an [6]: /api/latest/usage-metering/#get-projected-cost-across-your-account [7]: /cloud_cost_management/cost_changes/monitors/?tab=costmetricbased [8]: /cloud_cost_management/datadog_costs/ +[9]: /account_management/plan_and_usage/bill_overview/ diff --git a/content/en/account_management/plan_and_usage/usage_details.md b/content/en/account_management/plan_and_usage/usage_details.md index 3caa891ef4b..ea541ecc528 100644 --- a/content/en/account_management/plan_and_usage/usage_details.md +++ b/content/en/account_management/plan_and_usage/usage_details.md @@ -5,6 +5,10 @@ aliases: - /account_management/billing/usage_details/ --- +{{< callout url="" btn_hidden="true" header="New: Bill Overview" >}} +A new Bill Overview experience is now in Limited Availability and will start rolling out automatically to all organizations starting March 2026. [Learn more](/account_management/plan_and_usage/bill_overview/). +{{< /callout >}} + ## Overview Administrators can access the [Usage][1] page by hovering over their username at the bottom left, then navigate to: @@ -170,3 +174,4 @@ For billing questions, contact your [Customer Success][10] Manager. [8]: https://docs.datadoghq.com/logs/archives/rehydrating/?tab=awss3#overview [9]: /help/ [10]: mailto:success@datadoghq.com +[11]: /account_management/plan_and_usage/bill_overview/ diff --git a/static/images/account_management/plan_and_usage/bill-overview-detail-light.png b/static/images/account_management/plan_and_usage/bill-overview-detail-light.png new file mode 100644 index 00000000000..3b03c9e67a6 Binary files /dev/null and b/static/images/account_management/plan_and_usage/bill-overview-detail-light.png differ diff --git a/static/images/account_management/plan_and_usage/bill-overview-main-light.png b/static/images/account_management/plan_and_usage/bill-overview-main-light.png new file mode 100644 index 00000000000..9a72dae19ff Binary files /dev/null and b/static/images/account_management/plan_and_usage/bill-overview-main-light.png differ diff --git a/static/images/account_management/plan_and_usage/bill-overview-product-list-light.png b/static/images/account_management/plan_and_usage/bill-overview-product-list-light.png new file mode 100644 index 00000000000..76db7a8aebd Binary files /dev/null and b/static/images/account_management/plan_and_usage/bill-overview-product-list-light.png differ diff --git a/static/images/account_management/plan_and_usage/bill-overview-trends-light.png b/static/images/account_management/plan_and_usage/bill-overview-trends-light.png new file mode 100644 index 00000000000..ce42cd2a0a2 Binary files /dev/null and b/static/images/account_management/plan_and_usage/bill-overview-trends-light.png differ diff --git a/static/images/account_management/plan_and_usage/toggle-back-header.png b/static/images/account_management/plan_and_usage/toggle-back-header.png new file mode 100644 index 00000000000..41c1e159271 Binary files /dev/null and b/static/images/account_management/plan_and_usage/toggle-back-header.png differ