Skip to content

Commit cd33efd

Browse files
[DOC] Update count_over_time docs (#5052) (#5055)
1 parent d10e6aa commit cd33efd

File tree

2 files changed

+20
-3
lines changed

2 files changed

+20
-3
lines changed

docs/sources/tempo/traceql/metrics-queries/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ TraceQL metrics can help you answer these questions by parsing your traces in ag
4040

4141
TraceQL metrics are powered by the [TraceQL metrics API](https://grafana.com/docs/tempo/<TEMPO_VERSION>/api_docs/#traceql-metrics).
4242

43-
![Metrics visualization in Grafana](/media/docs/tempo/metrics-explore-sample-2.4.png)
43+
![Metrics visualization in Grafana](/media/docs/tempo/metrics-explore-sapmle-v2.7.png)
4444

4545
## RED metrics, TraceQL, and PromQL
4646

docs/sources/tempo/traceql/metrics-queries/functions.md

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -84,8 +84,25 @@ spans than `/api/happy`, for example.
8484
## The `count_over_time` function
8585

8686
The `count_over_time()` function counts the number of matching spans per time interval.
87-
The time interval that the count will be computed over is set by the `step` parameter.
88-
For more information, refer to the [`step` API parameter](https://grafana.com/docs/tempo/<TEMPO_VERSION>/api_docs/#traceql-metrics).
87+
The time interval that the count is computed over is set by the `step` parameter.
88+
89+
### The `step` parameter
90+
91+
Ths `step` parameter defines the granularity of the returned time-series.
92+
For example, `step=15s` returns a data point every 15s within the time range.
93+
By default, `step` automatically chooses a dynamic value based on the query start time and end time.
94+
95+
Any value used for `step` needs to include a duration value, such as `30s` for `s`econds or `1m` for `m`inutes.
96+
97+
You can configure this parameter using Grafana Explore or using the Tempo API.
98+
Refer to the [`step` API parameter](https://grafana.com/docs/tempo/<TEMPO_VERSION>/api_docs/#traceql-metrics) for information about using the API.
99+
100+
To check or change the `step` value using Grafana Explore:
101+
1. Select your Tempo data source.
102+
1. Select either the **Search** or **TraceQL** query type tab.
103+
1. Expand the **Metrics options** to view the **Step** value.
104+
105+
![The Step value in the Metrics options in Grafana Explore](/media/docs/tempo/tempo-ds-query-metrics-options-step.png)
89106

90107
### Example
91108

0 commit comments

Comments
 (0)