Skip to content

Commit 952a425

Browse files
authored
Add information on dashboard refresh rates (#244)
1 parent cb23c85 commit 952a425

File tree

2 files changed

+34
-2
lines changed

2 files changed

+34
-2
lines changed

dashboards/configure.mdx

+14
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,20 @@ To select the time range:
1515
1. Choose one of the following options:
1616
- Use the **Quick range** items to quickly select popular time ranges.
1717
- Use the **Custom start/end date** fields to select specific times.
18+
1. Click **Apply**.
19+
20+
## Select refresh rate
21+
22+
Your dashboard regularly queries your data in the background to show the latest trends. The refresh rate is the time interval between these queries.
23+
24+
To select the refresh rate:
25+
1. In the top right, click <img src="/doc-assets/icons/clock.svg" className="inline-icon" alt="Time range" /> **Time range**.
26+
1. Select one of the options in **Refresh rate**.
27+
1. Click **Apply**.
28+
29+
<Warning>
30+
Each time your dashboard refreshes, it runs a query on your data which results in query costs. Selecting a short refresh rate (such as 15s) for a long time range (such as 90 days) means that your dashboard frequently runs large queries in the background. To optimize query costs, choose a refresh rate that is appropriate for the time range of your dashboard.
31+
</Warning>
1832

1933
## Share dashboards
2034

reference/query-hours.mdx

+20-2
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,24 @@ As an example, a typical query analyzing 1 million events might consume approxim
6666

6767
Your GB-hours allowance depends on your pricing plan. To learn more about the plan offerings and find the one that best suits your needs, see [Axiom Pricing](https://axiom.co/pricing).
6868

69-
## Optimize Axiom usage
69+
## Optimize queries to lower costs
7070

71-
For more information on how to save on query costs, see [Optimize queries](/reference/performance#optimize-queries).
71+
This section explains ways you can optimize your queries to save on query costs. For more information optimizing your queries for performance, see [Optimize performance](/reference/performance).
72+
73+
### Optimize the order of field-specific filters
74+
75+
Field-specific filters narrow your query results to events where a field has a given value. For example, the APL query `where ["my-field"] == "axiom"` filters for events where the `my-field` field takes the value `axiom`.
76+
77+
Include field-specific filters near the beginning of your query for modest savings in query costs. For more information, see [Poor filter order in queries](/reference/performance#poor-filter-order-in-queries)
78+
79+
### Optimize `search` operator and non-field-specific filters
80+
81+
Non-field-specific filters narrow your query results by searching across multiple datasets and fields for a given value. Examples of non-field-specific filters are the `search` operator and equivalent expressions such as `where * contains` or `where * has`.
82+
83+
Using non-field-specific filters can have a significant impact on query costs. For more information, see [Use the `search` operator efficiently](/apl/tabular-operators/search-operator#use-the-search-operator-efficiently) and [Regular expressions when simple filters suffice](/reference/performance#regular-expressions-when-simple-filters-suffice).
84+
85+
## Optimize dashboard refresh rates
86+
87+
Each time your dashboard refreshes, it runs a query on your data which results in query costs. Selecting a short refresh rate (such as 15s) for a long time range (such as 90 days) means that your dashboard frequently runs large queries in the background.
88+
89+
To optimize query costs, choose a refresh rate that is appropriate for the time range of your dashboard. For more information, see [Select refresh rate](/dashboards/configure#select-refresh-rate).

0 commit comments

Comments
 (0)