Skip to content
This repository was archived by the owner on Jul 31, 2025. It is now read-only.

Commit 146b38a

Browse files
added series aggregation to README
1 parent f39401a commit 146b38a

2 files changed

Lines changed: 6 additions & 1 deletion

File tree

README.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ To construct a metric query, first create a new panel on a dashboard and select
3636
### Query Builder
3737
When you add a new query for a panel, the query builder mode is used by default. Simply click the respective buttons to browse and select agent, metric, and data frequency for your query.
3838
### Raw Query Mode
39-
Click "Toggle Edit Mode" on the right-hand triple bar menu to switch to raw query mode. Although the query builder mode supports basic regular expressions, you can use the raw query mode to use more advanced regex features. Some regular expressions might require that you disable automatic escaping by toggling the respective checkbox.
39+
Click "Toggle Edit Mode" on the right-hand triple bar menu to switch to raw query mode. Although the query builder mode supports basic regular expressions, you can use the raw query mode to use more advanced regex features. Some regular expressions might require that you disable automatic escaping by toggling the respective checkbox. Additionally, raw query mode supports the aggregation of multiple series into a single aggregated series for display.
4040

4141
### Query Variables
4242
You can create variables for templating based on APM queries. You can either query for agents or metrics. For agents, prepend your agent regex with "Agents|", for metrics use "Metrics|" instead. For example, "Agents|.+" will get you all agents. Use the regex option to transform your query results. See the animation below for an example of an agent query:
@@ -45,6 +45,11 @@ You can create variables for templating based on APM queries. You can either que
4545
### Temporal Resolution Variable
4646
Considering the different temporal aggregation levels of CA APM, it makes sense to use a template variable to control the temporal resolution of time series data dynamically. Simply create a custom dashboard variable and use `15s,30s,1m,2m,6m,12m,24m,48m,1h,168m,12h` for the values.
4747

48+
### Series Aggregation
49+
In raw query mode, you can choose an aggregation mode to aggregate multiple metrics into a single series of values. This way, you can get a single aggregated time series for visualization in Grafana if your query returns multiple metrics. The implemented aggregation modes are _sum_, _mean_, _max_, _min_, and _median_. Be careful when your metrics might contain null values - these are not explicitly handled by the aggregation methods.
50+
51+
![Series-Aggregation](https://github.com/NovaTecConsulting/ca-apm-grafana-datasource/blob/master/media/series_aggregation.jpg)
52+
4853
## License
4954

5055
Copyright (c) 2017 Novatec Consulting GmbH. All rights reserved.

media/series_aggregation.jpg

50.6 KB
Loading

0 commit comments

Comments
 (0)