Skip to content

Commit d32c5a1

Browse files
authored
Add section on billing dashboard filters and fixes some outdated info (#644)
1 parent ff0ccc2 commit d32c5a1

File tree

3 files changed

+63
-8
lines changed

3 files changed

+63
-8
lines changed

source/dashboards/manage-dashboards/billing-dashboards.txt

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -107,6 +107,56 @@ To ingest your billing data and add a billing dashboard:
107107
and :ref:`interactive filtering <interact-with-charts>`, apply to
108108
billing dashboards and its prebuilt charts.
109109

110+
To learn more about filtering billing dashboards,
111+
see :ref:`billing-dashboard-filter`.
112+
113+
.. _billing-dashboard-filter:
114+
115+
Apply Dashboard Filters
116+
-----------------------
117+
118+
You can use :ref:`dashboard filters <filter-dashboards>`
119+
to refine the charts across your billing dashboard.
120+
By default, billing dashboards include
121+
filters on the following fields from your billing data:
122+
123+
- ``name``
124+
- ``cluster``
125+
- ``category``
126+
- ``sku``
127+
128+
To view active filters, click the filter icon
129+
in the top-right corner of your dashboard to expand
130+
the :guilabel:`Dashboard Filters` pane.
131+
132+
In the :guilabel:`Dashboard Filters` pane,
133+
you can manage your active filters
134+
or click :guilabel:`Edit` to add and apply
135+
new filters. When you apply a filter, the
136+
charts in your dashboard update to display only data
137+
that matches the field values that you filtered on.
138+
139+
To learn more, see :ref:`dashboard-filters-pane`.
140+
141+
Example
142+
~~~~~~~
143+
144+
Consider a sample billing dashboard that uses the following filters:
145+
146+
- A filter on the ``category`` field to include only invoices
147+
related to the |charts-short| and Private Endpoint categories.
148+
149+
- A filter on the ``date`` field to include only invoices incurred
150+
within the past 6 months.
151+
152+
Once the filters are applied, the charts in the billing dashboard
153+
highlight only the values specified in these filters. For example:
154+
155+
.. figure:: /images/charts/billing-dashboard-filter-example.png
156+
:figwidth: 750px
157+
:alt: A sample Billing Dashboard with filters on the category
158+
and date fields.
159+
110160
Manage |service| Billing Ingestions
111161
-----------------------------------
112162

source/dashboards/view-dashboard-data/dashboard-filtering.txt

Lines changed: 13 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,8 @@ unless you :ref:`reset a filter <revert-dashboard-filters>`.
9494
initial default filter values after refreshing the page or starting
9595
a new session.
9696

97+
.. _dashboard-filters-pane:
98+
9799
The :guilabel:`Dashboard Filters` Pane
98100
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
99101

@@ -120,23 +122,21 @@ Fiction and History movies released in or after 1968. Dashboard
120122
``Viewers`` can provide their own values for the filterable fields to
121123
refine chart data based on their interests.
122124

123-
.. figure:: /images/charts/edit-dashboard-filters.png
124-
:figwidth: 720px
125-
:alt: An image of a dashboard. The :guilabel:`Edit Dashboard Filters`
126-
pane is highlighted.
125+
.. figure:: /images/charts/sample-dashboard-filters.png
126+
:figwidth: 300px
127+
:alt: Sample dashboard filters on the genre and year fields.
127128

128129
To learn about filtering options for each field data type, see
129130
:ref:`filter-tab`.
130131

131132
Expand or Collapse Dashboard Filters
132133
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
133134

134-
You can expand or collapse dashboard filter cards by clicking
135-
:guilabel:`Show` or :guilabel:`Hide` on that card.
135+
You can expand or collapse dashboard filter cards.
136136

137137
Disabled filters are automatically collapsed.
138138

139-
Enabled, collapsed filters are still applied to your charts.
139+
When enabled, collapsed filters still apply to your charts.
140140

141141
.. _manage-dashboard-filters:
142142

@@ -176,7 +176,7 @@ To add a dashboard filter:
176176

177177
1. Expand the :guilabel:`Dashboard Filters` pane on the desired
178178
dashboard.
179-
#. If a dashboard has no filers, click :guilabel:`Add Filters`.
179+
#. If a dashboard has no filters, click :guilabel:`Add Filters`.
180180
Otherwise, click :guilabel:`Edit`.
181181
#. Expand a data source that contains fields you want to add a filter
182182
for.
@@ -249,6 +249,11 @@ After you create a dashboard filter, you can:
249249
- Stack fields from other data sources.
250250
- Change the default field values.
251251

252+
.. figure:: /images/charts/edit-dashboard-filters.png
253+
:figwidth: 720px
254+
:alt: An image of a dashboard. The :guilabel:`Edit Dashboard Filters`
255+
pane is highlighted.
256+
252257
To edit a dashboard filter:
253258

254259
1. Expand the :guilabel:`Dashboard Filters` pane on the desired
Loading

0 commit comments

Comments
 (0)