@@ -6,48 +6,147 @@ Billing Data
66
77.. default-domain:: mongodb
88
9+ .. facet::
10+ :name: genre
11+ :values: reference
12+
13+ .. meta::
14+ :keywords: atlas architecture center
15+ :description: Learn about ways to manage and view your billing data.
16+
917.. contents:: On this page
1018 :local:
1119 :backlinks: none
12- :depth: 1
20+ :depth: 2
1321 :class: onecol
1422
15- Intro statement
16-
17- {+service+} Features and Best Practices for Billing Data
18- --------------------------------------------------------
19-
20- Content here
21-
22- Examples
23- --------
24-
25- The following examples <perform this action> using |service|
26- :ref:`tools for automation <arch-center-automation>`.
27-
28- These examples also apply other recommended configurations, including:
29-
30- .. tabs::
31-
32- .. tab:: Dev and Test Environments
33- :tabid: devtest
34-
35- .. include:: /includes/shared-settings-clusters-devtest.rst
36-
37- .. tab:: Staging and Prod Environments
38- :tabid: stagingprod
39-
40- .. include:: /includes/shared-settings-clusters-stagingprod.rst
41-
42- .. tabs::
43-
44- .. tab:: CLI
45- :tabid: cli
46-
47- Content here
48-
49- .. tab:: Terraform
50- :tabid: Terraform
51-
52- Content here
53-
23+ Tracking and managing cloud spending can be difficult in a large
24+ organization. While :ref:`cost-saving configurations
25+ <arch-center-cost-saving-config>` proactively save money, {+service+}
26+ also provides cloud spend governance tools for you to:
27+
28+ - Categorize {+service+} resources based on your organization's billing needs.
29+ - Leverage billing data to visualize and understand your {+service+} spending.
30+ - Receive notifications when Atlas spending exceeds a specified threshold.
31+ - Pull billing data programmatically to integrate with your FinOps tools.
32+
33+ On this page, learn how to use built-in {+service+} tools and
34+ {+service+} billing data to track, manage, and optimize your cloud
35+ spending.
36+
37+ {+service+} Features for Billing Data
38+ -------------------------------------
39+
40+ Create Billing Dashboards
41+ ~~~~~~~~~~~~~~~~~~~~~~~~~
42+
43+ You can visualize your billing data in a |charts| billing dashboard
44+ to help you optimize your |service| spending. Billing dashboards contain
45+ prebuilt charts that help you monitor your {+service+} usage in an
46+ organization across different categories and periods of time, and
47+ |charts| integrates with {+service+} to seamlessly ingest billing data.
48+
49+ .. figure:: /includes/images/atlas-billing-dashboard.png
50+ :figwidth: 750px
51+ :alt: Atlas Billing Dashboard example.
52+
53+ By default, billing dashboards include the following metrics and charts:
54+
55+ - Total spending across the organization
56+ - Biggest spenders in the organization
57+ - Total spending by instance size, project, cluster, product category, or SKU
58+ - Total cost by product category
59+
60+ You can also customize your billing dashboard by applying :ref:`dashboard
61+ filters <billing-dashboard-filter>` and adding new charts, including any
62+ charts that use :ref:`tags <configure-resource-tags>` that you've
63+ applied to your billing data.
64+
65+ To create or manage a billing dashboard, see :ref:`billing-dashboards`.
66+
67+ Apply Resource Tags
68+ ~~~~~~~~~~~~~~~~~~~
69+
70+ You can apply resource tags in |service| for precise cost allocation by
71+ categorizing resources according to departments, projects, or cost
72+ centers. You can also group and analyze tagged resources in financial
73+ reports, providing a clear and organized view of how various teams or
74+ projects contribute to overall cloud spending. To learn more, see
75+ :ref:`configure-resource-tags`.
76+
77+ Access Billing Data Programmatically
78+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
79+
80+ The {+atlas-admin-api+} provides a |rest|\ful interface that allows you
81+ to programmatically access your billing data for use with external tools
82+ and reports. Combine this feature with :ref:`resource tags
83+ <configure-resource-tags>` to easily categorize your {+service+}
84+ spending.
85+
86+ For example, you can retrieve all your pending invoices with the
87+ :oas-atlas-op:`Return All Pending Invoices for One Organization
88+ </listPendingInvoices>` |api| endpoint. The endpoints response body
89+ contains the ``results.lineItems.tags`` field, which reflect the tags
90+ you applied to your resources (such as organizations and {+clusters+}).
91+ You can then feed this line-item-level billing data into external FinOps
92+ tools and reports track your {+service+} spending by environment, team,
93+ or other tag values.
94+
95+ Enable Cross-Organization Billing
96+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
97+
98+ |service| allows you to share a billing subscription across many
99+ organizations and to pay a single invoice for them. Enable
100+ cross-organization billing for easy visibility into {+service+} spending
101+ for all of your organizations.
102+
103+ After you configure a paying organization, you pay invoices for the paying
104+ organization that include a list of charges incurred for all linked
105+ organizations. To learn more, see :ref:`cross-org-billing`.
106+
107+ Review Your Monthly Cost Visualization
108+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
109+
110+ To view your billing data monthly, navigate to the :guilabel:`Cost
111+ Explorer` page. The Cost Explorer provides a granular view of cloud
112+ spending in chart and table form, allowing users to analyze costs by
113+ {+clusters+}, projects, or teams. Historical spending data and
114+ customizable filters help identify trends and inefficiencies, enabling
115+ better financial decision-making and resource optimization. You can view
116+ your usage over the past six months, and access your billing data up to
117+ the past 18 months. If your organization uses cross-organizational
118+ billing, you can view billing data across all linked organizations.
119+
120+ The Billing Cost Explorer filters and groups usage data by organization,
121+ project, {+cluster+}, and service. Each filter contains a :guilabel:`Usage`
122+ chart with stacked columns representing the total cost incurred each
123+ month. Underneath, there is a :guilabel:`Usage By Month` table that
124+ displays the billing data shown in the chart. To learn more, see
125+ :ref:`cost-explorer`.
126+
127+ Review Your Annual Cost Visualization
128+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
129+
130+ To view your billing data annually, navigate to the :guilabel:`Billing
131+ Overview` page. This page helps you to understand the costs incurred by
132+ your organization's {+service+} usage by service, deployment, and
133+ project. Each category contains a :guilabel:`Usage` chart with stacked
134+ columns representing the total cost incurred each month. To learm more,
135+ see :ref:`Year-to-Date Usage Chart <billing-visualizations>`.
136+
137+ Review Your Invoice Cost Visualization
138+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
139+
140+ To view your billing data as an invoice, click on the
141+ :guilabel:`Invoice Date` or :guilabel:`Invoice Period` you want to
142+ view. This page shows you the costs incurred by your {+service+} usage
143+ over the invoice period through the :guilabel:`Total Usage` and
144+ :guilabel:`By Deployment` charts.
145+
146+ For the :guilabel:`Total Usage` chart, you can filter your usage by
147+ service to view charges incurred by a particular {+service+} service.
148+ For the :guilabel:`By Deployment` chart, you can view the proportion of
149+ your usage incurred by each of your {+clusters+} and serverless instances
150+ across all your projects.
151+
152+ To view line-item charges, see :ref:`view-past-invoices`.
0 commit comments